{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/ru/Patterns/named_entity/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"6d0c0397-5fdd-595c-a0cf-ca3a7f0d5ca3","excerpt":"Именованные сущности Именованная сущность — слово или словосочетание, выделяющее определенный предмет или явление из ряда однотипных предметов или явлений…","html":"

Именованные сущности

\n
\n

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

\n

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

\n

Именованные сущности можно указывать в правилах NLU, как и любые другие именованные паттерны, и таким образом распознавать элементы справочников в запросах.

\n

Объявление

\n

Чтобы задать паттерн как именованную сущность, необходимо проделать следующие шаги. Для примера воспользуемся фрагментом справочника городов, который разместим в файле dicts/cities.csv:

\n
1;Санкт-Петербург, Питер, СПб;{\"name\": \"Санкт-Петербург\", \"lat\": 59.93863, \"lon\": 30.31413}
\n
\n
    \n
  1. Подключите к файлу сценария .sc справочник именованных сущностей при помощи тега require:
    2. \n
\n
require: dicts/cities.csv\n    name = Cities\n    var = Cities
\n
\n
    \n
  1. Задайте конвертер для сущности в одном из файлов с расширением .js либо в одном из блоков init:
    2. \n
\n
$global.cityConverter = function($parseTree) {\n    var id = $parseTree.Cities[0].value;\n    return Cities[id].value;\n};
\n

Использование конвертеров опционально, однако оно упрощает последующий доступ к данным, указанным в значении сущности.

\n
\n
    \n
  1. Объявите именованный паттерн при помощи специального элемента $entity, после которого в угловых скобках записывается название справочника, а как атрибут после || — имя конвертера:
    2. \n
\n
patterns:\n    $city = $entity<Cities> || converter = cityConverter
\n

Использование

\n

Рассмотрим пример стейта, который будет срабатывать на запросы с упоминанием сущности $city:

\n
state: City\n    q!: * $city *
\n

При попадании в данный стейт, например, по запросу мой регион Санкт Петербург в $parseTree будет доступна информация по сущности:

\n
{\n  \"city\": [\n    {\n      // Служебные поля: tag, pattern и другие\n      \"value\": {\n        \"name\": \"Санкт-Петербург\",\n        \"lat\": 59.93863,\n        \"lon\": 30.31413\n      }\n    }\n  ],\n  \"_city\": {\n    \"name\": \"Санкт-Петербург\",\n    \"lat\": 59.93863,\n    \"lon\": 30.31413\n  }\n}
\n

По ключу <имя_паттерна> доступна подробная информация по всем распознанным сущностям, а по ключу _<имя_паттерна> — значение value первой распознанной сущности.

\n
\n

Значение value отличается в зависимости от того, задан ли для сущности конвертер:

\n\n
","frontmatter":{"title":"","description":null},"headings":[{"value":"Именованные сущности"}]}},"pageContext":{"slug":"/docs/ru/Patterns/named_entity/","previous":{"fields":{"slug":"/docs/ru/Patterns/named_patterns/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/Patterns/converters/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}