На этой вкладке отображаются все сценарии, исполняемые в шлюзах или на шаге Сценарий. Для их создания используется язык программирования TypeScript. Более подробно про принципы написания сценариев в ELMA365 вы можете прочитать в справке ELMA365 TS SDK.
Сценарии с этой вкладки выполняются на стороне сервера без ограничения доступа к элементам приложения. Например, если в каком‑либо приложении ограничен доступ к элементам, то при попытке загрузить элемент, к которому у текущего пользователя нет доступа, серверный код выполнится успешно. Аналогично при получении списка элементов вернутся все элементы.
При написании некоторых сценариев можно использовать дополнительные параметры. Они позволяют донастроить процесс или внести изменения в сценарий без перепубликации. Подробнее об этом вы можете прочитать в статье «Дополнительные параметры».
Верхняя панель
Над страницей для редактирования сценария располагается верхняя панель управления.
- Сохранить — текст сценария будет сохранён как черновик, при этом опубликованный сценарий не изменяется;
- Проверить — проверяется наличие ошибок в сценарии. Найденные ошибки будут подчёркнуты красным цветом. Сценарий с ошибками опубликовать нельзя;
- Опубликовать — чтобы сценарий выполнялся, его нужно опубликовать. Не забывайте публиковать сценарий каждый раз после того, как вы вносите изменения. Сохранённые, но не опубликованные изменения не будут доступны пользователям при выполнении бизнес-процесса;
- Отладить — запуск отладки бизнес-процесса. Можно использовать для проверки и отладки сценария на практике;
- Отменить — отменяет последнее действие;
- Повторить — повторяет последнее отменённое действие;
- Настройки — эта опция доступна только для сценариев в бизнес-процессах на уровне разделов и приложений. Вы можете разрешить или ограничить доступ к глобальным константам. По умолчанию ни одна из опций не выбрана.
- Global — выберите эту опцию, если хотите использовать в сценарии константу Global. Она позволяет получить доступ к переменным, содержащимся в других разделах, и к глобальным параметрам. Обратите внимание, использование этого объекта препятствует дальнейшей выгрузке сценария. Если использовать константу
Globalв сценарии процесса, который находится в разделе или приложении, этот раздел или приложение нельзя будет экспортировать; - Namespace — эта опция позволяет использовать в сценарии константу Namespace. Она даёт доступ к приложениям раздела. Вы не сможете экспортировать приложение со сценарием, содержащим константу
Namespace, но выгрузка раздела по‑прежнему будет доступна. Исключением является экспорт системного раздела в составе решения; - Опциональные зависимости (доступны в объекте Imports) — опция позволяет выбрать разделы или пользовательские модули и установить от них опциональные зависимости. К объектам выбранных разделов и модулей можно обращаться через константу
Imports. При использовании опциональных зависимостей раздел или приложение, в котором находится процесс, можно экспортировать без ограничений.
Чтобы создать зависимость, нажмите + Добавить раздел. В колонке Псевдоним задайте для раздела или модуля уникальное имя, которое будет использоваться в сценарии. Допустимы латинские буквы и цифры, для разделения слов можно использовать знак подчёркивания. По умолчанию используется код раздела или ID модуля.
начало внимание
Опциональные зависимости и константа Imports по умолчанию доступны в поставке On‑Premises, начиная с версии системы 2024.2. В более ранних версиях администратору системы нужно включить фича-флаг allowScriptImportsDependencies. Подробнее об этом читайте в статьях «Изменение параметров On-Premises Enterprise» и «Изменение параметров On-Premises Standard». Для поставки SaaS обратитесь к вашему менеджеру ELMA365, чтобы включить фича-флаг.
конец внимание
- Отладить функцию — запуск отладчика сценариев. Инструмент позволяет проверить работу написанной функции с реальными значениями переменных.