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