toentity

Назначение

Приводит варианты написания сущности к стандартному имени сущности, которое определяется узлом «Извлечение сущностей». Эта функция полезна, когда XPDL-правила ссылаются на ранее найденные сущности.

Синтаксис

toentity([тип_сущности,] аргумент[,…​])

Аргументы

Принимает один обязательный аргумент, который определяет аргумент для замены.

Первый опциональный аргумент определяет тип сущности («people», «organizations», «geoadministrative», и т.д.).

Функция также поддерживает опциональный параметр field, который преобразует аргумент в заданный атрибут сущности.

Если название сущности или именованного параметра field включает цифры или специальные символы (&, /, и т.п.), то его нужно заключать в кавычки, например: toentity("A&B", $1, field:="A/B")

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

Возвращаемое значение

Сущность определенного типа или ее искомые атрибуты.

Примеры

Данные

XPDL-правило

Результат

J&J

rule: r1

{

query: {"J&J"}:1

result: Match = toentity(companies|organizations, $1)

}

Johnson & Johnson

Париж

rule: r1

{

query: {"Париж"}:1

result: Match = toentity(geoadministrative, $1, field:=country)

}

Франция

Иван Иванов

rule: r1

{

query: {"Иван Иванов"}:1

result: Match = toentity(geoadministrative, $1, field:=country, default:="не страна")

}

не страна