Общая информация о макросах

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

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

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

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

  • список макросов, доступный для конкретного проекта.

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

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

Поскольку макросы можно сохранить в различных областях (сервер, профиль, проект), существуют разные способы доступа к спискам макросов, чтобы посмотреть, какие именно макросы вы создали, внести изменения в существующие макросы, удалить макросы и создать новые. Чтобы отредактировать макрос в профиле пользователя, выберите в меню Настройки вкладку Настройки пользователя, найдите в левой части окна раздел Макросы SRL/PDL. Обратите внимание, что в настройках присутствует раздел Переменные SRL/PDL, которые не следует путать с макросами. Переменные описываются в отдельной теме данной документации. Макросы сервера можно отредактировать в Административном клиенте (выберите Настройки сервера в меню Действия). Для редактирования макросов проекта нужно открыть проект в Аналитическом клиенте. Выберите Настройки программы в меню Настройки, переключитесь на вкладку Настройки пользователя и найдите раздел Макросы SRL/PDL.

Чтобы добавить новый макрос, нажмите на имя раздела (Макросы SRL/PDL) правой кнопкой мыши и выберите Добавить элемент. Появится новый элемент под данным разделом. Если вы не видите его, нажмите символ +, чтобы раскрыть раздел Макросы SRL/PDL, затем нажмите левой кнопкой мыши на созданный макрос (который будет назван как Item (n)) и начните редактирование.

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

Чтобы удалить макрос, нажмите на его название правой кнопкой мыши и выберите Удалить. Чтобы удалить все макросы (в данной области), нажмите на имя раздела Макросы SRL/PDL и выберите Удалить все.

Чтобы сохранить изменения в макросе, убедитесь, что вы нажали ОК или Применить в окне Настройки. При нажатии ОК изменения сохранятся и окно закроется. При нажатии Применить изменения буду сохранены, но окно останется открытым. Рекомендуем периодически нажимать Применить (например, после редактирования вашего макроса), чтобы сохранить настройки, поскольку закрытие окна без сохранения изменений приведет к отмене всех изменений в списке макроса.

Для автоматического генерирования набора макросов настройки можно экспортировать в XML-файл, как и в любом другом разделе. Экспорт макросов - удобный способ создания резервной копии вашего списка макросов. С помощью экспорта также можно заархивировать прежние версии ваших макросов, если вы не уверены во внесенных изменениях или хотите провести эксперимент. Вы также можете использовать экспорт и импорт для перемещения макросов из одного списка в другой.

Например, вы можете экспортировать список макросов, которые хранятся в вашем профиле и импортировать их в список макросов сервера или список макросов проекта. Чтобы экспортировать текущий набор макросов для определенной области, нажмите правой кнопкой мыши на имя раздела Макросы PDL/SRL и выберите Экспорт. Найдите нужное расположение и, по желанию, имя XML файла и нажмите Сохранить. Обычно эта операция выполняется быстро, даже с тысячами макросов.

Таким же образом, для импорта XML файла нажмите на название раздела и выберите Импорт, затем найдите и выберите XML-файл и нажмите Открыть. Затем PolyAnalyst импортирует макрос в XML-файле.