Макросы
Макросы позволяют сохранять различные выражения, называемые переменными, которые можно использовать в других выражениях. Макросы используются в PDL, XPDL и SRL.
Макросы создаются в четырех разных областях. Вы можете создать:
-
список макросов, доступный в конкретном скрипте;
-
список макросов, доступный в конкретной ветке;
-
список макросов, принадлежащий вашему профилю пользователя;
-
список макросов, доступный для всех пользователей на одном сервере;
В целом, независимо от того, когда вы решаете создать макрос, он будет обрабатываться одинаково. Выбор подходящей области (скрипт, ветка, пользователи на сервере или ваш собственный профиль), в основном, зависит от того, как именно вы хотите организовать повторное использование макроса в нескольких проектах и/или как именно вы планируете предоставить другим пользователям доступ к макросам.
Несмотря на то, что область сохранения макроса не влияет на его логику, существует некая очередность оценки макросов. Когда вы создаете два макроса с одним и тем же именем в нескольких областях, область сохранения макроса значения не имеет. Однако, в этом случае макросы веток имеют более высокий приоритет по сравнению с макросами скрипта, а макросы профиля имеют более высокий приоритет по сравнению с макросами скрипта. Когда вы используете макрос в выражении в узле, PolyAnalyst Grid сначала ищет макрос с данным именем в списке макросов скрипта. Если макрос не найден, PolyAnalyst Grid переходит к поиску макроса в списке макросов профиля пользователя. Наконец, если макрос не найден, PolyAnalyst Grid ищет его в списке макросов сервера. Если же макрос не найден и в этом случае, то выражение не будет выполнено, а PolyAnalyst сообщит об ошибке (которая возникает в том случае, когда вы пытаетесь запустить узел с PDL или SRL выражением, которое использует несуществующий макрос). Если вы сталкиваетесь с такой ошибкой, проверьте правильность написания выражения, затем убедитесь в том, что указанный вами макрос имеется в одном из списков макросов, проверяя их в следующем порядке: сначала макросы проекта, затем макросы профиля и сервера.
Редактирование макросов
Используйте поле Аргументы для ввода аргументов макроса - специально именованных аргументов и значений, которые можно вставить в выражение макроса.
-
Добавить - добавить новый макрос;
-
Клонировать - клонировать существующий макрос;
-
Удалить - удалить существующий макрос;
-
Вверх и Вниз - используйте для навигации по списку Макросы.
Чтобы изменить имя макроса, выберите нужный макрос и начните редактировать его имя.
Используйте поле Описание для добавления информации по конкретному макросу, например, описания макроса, данных о предыдущей версии макроса, любых комментарий по макросу и т.д.
Выражение макроса
Выражение макроса, также известное как правило макроса, или выражение, иногда называвется собсвенно макросом. Это основное свойство макроса, содержащее выражение, используемое данным макросом.
При использовании имени макроса в SRL/PDL выражении, макрос будет переименован и заменен текстом выражения этого макроса. Поскольку имена макросов обычно короткие, а выражения макросов - длинные, необходимо помнить об этом свойстве, т.к. оно "расширяет" макрос.
В зависимости от того, создаете ли вы выражение PDL или SRL, написание макроса происходит в точности так же, как и редактирование поискового запроса или запроса таксономии с помощью PDL, либо использование узла Производные колонки или Фильтрация строк, в которых используется SRL. Применяется такой же синтаксис.
Преимущество макроса состоит в том, что если вы используете одно и то же выражение в нескольких проектах или узлах, вы можете сохранить это выражение, дать ему имя и ссылаться на это выражение, используя его имя в последующей настройки в целях экономии времени (и, возможно, во избежание ошибок).