Подключение пользовательской JS-функции

Пользовательская JavaScript-функция (JS-функция) доступна для подключения:

Для подключения пользовательской JS-функции:

  1. Создайте JS-файл, содержащий пользовательскую JS-функцию, в папке установки веб-приложения/конструктора бизнес-приложений.

Путь до папки установки веб-приложения, если описание плагина добавляется в конфигурационном файле config.json:

Путь до папки установки конструктора бизнес-приложений:

Совет. Для удобного использования плагинов создайте отдельную папку Plugins, в которой будут размещаться плагины.

В OC Linux раздайте права на пользовательскую папку с плагинами/создаваемый JS-файл в Debian-подобных дистрибутивах для пользователя www-data. При работе в других дистрибутивах ОС Linux замените www-data на apach для RedHat-подобных дистрибутивов или на apache2 для ALT Linux.

Например, файл Func.js:

function myFunc(){
  alert("Пример вызова пользовательской JS-функции из файла");
}

Примеры функций представлены в описании сигнатур.

  1. Добавьте ссылку на созданный JS-файл в поле externalJs в конфигурационном файле config.json для веб-приложения или config.json/DBA.config.json для конструктора бизнес-приложений. Для этого укажите относительный путь к JS-файлу от основного файла веб-приложения/конструктора бизнес-приложений index.html:

"externalJs": [{"src": "./Plugins/Func.js"}]

  1. Перезапустите серверную часть веб-приложения/конструктора бизнес-приложений.

После выполнения действий пользовательская JS-функция будет подключена к соответствующему объекту при указании её имени в настройках вызова JS-функции.

Подключение пользовательской JS-функции в веб-приложении с конфигурационным файлом PP.xml

Сигнатуры пользовательских JS-функций

Сигнатура пользовательской JS-функции для аналитической панели

Сигнатура пользовательской JS-функции регламентного отчёта/формы ввода при настройке пользовательской кнопки

Сигнатура пользовательской JS-функции регламентного отчёта/формы ввода при настройке гиперссылки

Сигнатура пользовательской JS-функции для веб-приложения и конструктора бизнес-приложений

Особенности использования аргументов JS-функции в веб-приложении с конфигурационным файлом PP.xml

Доступные методы объектов пространства имён Platform в JS-функциях регламентного отчёта/формы ввода

В сигнатуре JS-функции гиперссылки/пользовательской кнопки используется параметр args:

args: {
  moduleId: string;
}

Поле moduleId возвращает уникальный идентификатор открытого экземпляра объекта, из которого вызывается JS-функция. Данный идентификатор используется с методами объекта Platform.Managers.

Platform.Managers - объект, предоставляющий доступ к открытым объектам репозитория, из которых вызываются JS-функции. В текущей реализации у данного объекта реализованы объекты:

Также при работе с регламентным отчётом/формой ввода в JS-функциях доступны следующие объекты пространства имён Platform:

'!module'

'Platform.Managers.MetaBase.connectionId()+'!module'

См. также:

Вопросы и ответы