Макросы

Макросы позволяют сохранять различные выражения, называемые переменными, которые можно использовать в других выражениях. Макросы используются в PDL, XPDL и SRL.

Макросы создаются в четырех разных областях. Вы можете создать:

  • список макросов, доступный в конкретном скрипте;

  • список макросов, доступный в конкретной ветке;

  • список макросов, принадлежащий вашему профилю пользователя;

  • список макросов, доступный для всех пользователей на одном сервере;

В целом, независимо от того, когда вы решаете создать макрос, он будет обрабатываться одинаково. Выбор подходящей области (скрипт, ветка, пользователи на сервере или ваш собственный профиль), в основном, зависит от того, как именно вы хотите организовать повторное использование макроса в нескольких проектах и/или как именно вы планируете предоставить другим пользователям доступ к макросам.

Несмотря на то, что область сохранения макроса не влияет на его логику, существует некая очередность оценки макросов. Когда вы создаете два макроса с одним и тем же именем в нескольких областях, область сохранения макроса значения не имеет. Однако, в этом случае макросы веток имеют более высокий приоритет по сравнению с макросами скрипта, а макросы профиля имеют более высокий приоритет по сравнению с макросами скрипта. Когда вы используете макрос в выражении в узле, PolyAnalyst Grid сначала ищет макрос с данным именем в списке макросов скрипта. Если макрос не найден, PolyAnalyst Grid переходит к поиску макроса в списке макросов профиля пользователя. Наконец, если макрос не найден, PolyAnalyst Grid ищет его в списке макросов сервера. Если же макрос не найден и в этом случае, то выражение не будет выполнено, а PolyAnalyst сообщит об ошибке (которая возникает в том случае, когда вы пытаетесь запустить узел с PDL или SRL выражением, которое использует несуществующий макрос). Если вы сталкиваетесь с такой ошибкой, проверьте правильность написания выражения, затем убедитесь в том, что указанный вами макрос имеется в одном из списков макросов, проверяя их в следующем порядке: сначала макросы проекта, затем макросы профиля и сервера.

Редактирование макросов

Используйте поле Аргументы для ввода аргументов макроса - специально именованных аргументов и значений, которые можно вставить в выражение макроса.

libraries macros edit.rus
  • Добавить - добавить новый макрос;

  • Клонировать - клонировать существующий макрос;

  • Удалить - удалить существующий макрос;

  • Вверх и Вниз - используйте для навигации по списку Макросы.

Чтобы изменить имя макроса, выберите нужный макрос и начните редактировать его имя.

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

Выражение макроса

libraries macros function.rus

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

При использовании имени макроса в SRL/PDL выражении, макрос будет переименован и заменен текстом выражения этого макроса. Поскольку имена макросов обычно короткие, а выражения макросов - длинные, необходимо помнить об этом свойстве, т.к. оно "расширяет" макрос.

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

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