{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/ru/common/bot_structure/csv/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"87207116-3d10-5e3b-bc6d-88b7d756537b","excerpt":"Справочники именованных сущностей?> — справочники именованных сущностей. Справочники именованных сущностей необходимы для обработки большого набора именованных…","html":"

Справочники именованных сущностей

\n
\n

.csv — справочники именованных сущностей.

\n

Справочники именованных сущностей необходимы для обработки большого набора именованных сущностей через паттерны.

\n
\n

Именованная сущность — слово или словосочетание, выделяющее определенный предмет или явление из ряда однотипных предметов или явлений. Например, это названия городов, стран, валют.

\n
\n

Структура справочника

\n

Справочники задаются в файлах с расширением .csv. Каждая строка имеет следующую структуру:

\n
id; имя; значение
\n

ID

\n

Идентификатор сущности.

\n

Идентификаторы в пределах одного справочника должны быть уникальны.

\n

Имя

\n

Слово или набор слов для обозначения сущности.

\n

Внутри имени вы можете перечислить ряд синонимов через запятую.

\n

При подключении справочника к сценарию бот будет распознавать сущность в запросах, где упомянут один из перечисленных синонимов.

\n

Значение

\n

Данные, ассоциированные с сущностью.

\n

Данные могут быть представлены в виде строки без кавычек либо объекта JavaScript. Вы можете добавить в значения любую информацию, которая относится к сущности, чтобы воспользоваться ей в сценарии.

\n

Например, в имени сущности вы можете перечислить все синонимы, а в одном из полей значения — ее основное, нормализованное наименование.

\n

Пример

\n

В качестве примера рассмотрим фрагмент справочника личных имен:

\n
150;Игорь,Игорек;{\"name\": \"Игорь\", \"diminutive\": \"Игорек\", \"sex\": \"м\"}\n151;Инна;{\"name\": \"Инна\", \"diminutive\": \"\", \"sex\": \"ж\"}\n152;Иннокентий,Кеша;{\"name\": \"Иннокентий\", \"diminutive\": \"Кеша\", \"sex\": \"м\"}\n153;Ирина,Ира,Ирочка,Ирка;{\"name\": \"Ирина\", \"diminutive\": \"Ирочка\", \"sex\": \"ж\"}
\n

Подключение справочника

\n

Для подключения справочника используется тег require. Укажите путь к файлу, а также значения параметров name и var.

\n
require: dicts/names.csv\n    name = Names\n    var = $Names
\n

Название

\n

Название справочника, указанное после name, используется при создании именованной сущности, использующей данный справочник:

\n
patterns:\n    $name = $entity<Names>
\n

Подробнее об именованных сущностях

\n

Имя переменной

\n

Имя переменной var используется для доступа к содержимому справочника напрямую из скриптовых вставок — в частности, конвертеров.

\n

Так, если передать в функцию log переменную $Names, в лог будет выведен объект со следующей структурой:

\n
{\n  \"150\": {\n    \"id\": \"150\",\n    \"alternameNames\": [\n      \"Игорь\",\n      \"Игорек\"\n    ],\n    \"value\": {\n      \"name\": \"Игорь\",\n      \"diminutive\": \"Игорек\",\n      \"sex\": \"м\"\n    }\n  },\n  \"151\": {\n    // ...\n  }\n}
\n

Учет морфологических вариантов

\n

По умолчанию синонимы для сущности распознаются во всех морфологических формах. Например, задан такой фрагмент справочника регионов:

\n
24;Красноярский край;{\"capital\": \"Красноярск\"}\n45;Курганский область;{\"capital\": \"Курган\"}
\n

В сущность, использующую данный справочник, попадут формы словосочетаний во всех падежах и числах: Красноярского края, в Курганской области и т. д.

\n

Все слова, перечисленные в синонимах, должны находиться в начальной форме.

\n
\n

Если такое поведение нежелательно, при подключении справочника вы можете дополнительно указать параметр strict:

\n
require: dicts/regions.csv\n    name = Region\n    var = $Region\n    strict = true
\n

В таком случае синонимы будут распознаваться строго в том виде, который они имеют в справочнике.

","frontmatter":{"title":"","description":null},"headings":[{"value":"Справочники именованных сущностей"}]}},"pageContext":{"slug":"/docs/ru/common/bot_structure/csv/","previous":{"fields":{"slug":"/docs/ru/common/bot_structure/js/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/common/bot_structure/context-switch/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}