🍬 RMG 365 | Dev Tools

• Установка и настройка решения
• Логирование в скриптах
• Пример вызова в скрипте через Imports и Namespace.action
• Пример вызова в скрипте
• Логирование данных в обработчике событий
• Получения режима окружения

Установка и настройка решения

В настоящий момент решения является не официальным и не опубликовано в Store

Актуальная версия для установки - rmg_dev_tools_20250423.e365

Поддержка решения осуществляется на добровольной основе в канале Telegram

Наcтройки:

где:

• Окружение - режим окружения системы (кроме Production будет отображаться вверху страницы). Доступные  значения:
  • Development
  • Testing
  • Stage
  • PreProd
  • Production
• Просмотр файлов - включает предпросмотр для файлов типа XML и JSON.
• Адрес ELMA365 и Токен ELMA365 - может использоваться как хелпер для вызова Web API.
• Логин ELMA365 и Пароль - может использоваться для вызова "ручек" фронта от имени конекреного пользователя

Кнопка проверить используется для проверки корректности ввода кредов выше:

Логирование в скриптах

Пример вызова в скрипте через Imports и Namespace.action

Доступно с версии 2024.2

Вариант с использованием Imports:

async function action(): Promise<void> {
    const message = `${Context.data.__item!.namespace}.${Context.data.__item!.code}.${Context.data.__item!.id}`;
    const details = JSON.stringify((<any>Context).json(), null, 2);
    Imports?.devtools?.action?.save_to_log?.call({message: message, details: details});
}

Нужно подключить зависимость и определить псевдоним, в данном примере это devtools:

Пример вызова в скрипте

Логирование поддерживается как в клиентских, так и серверных скриптах.

На текущий момент нами был обнаружен единственный способ для решения данной задачи. Он не является изящным, но "на безрыбье и рак щука". Отдельное спасибо за идею Раису.

Для того, чтобы в лог (приложение в разделе системных справочников) попала информация, в скрипте необходимо вызнать следующий код:

const message = 'Сообщение из серверного скрипта';
const details = 'Проверка вызова логирования из серверного скрипта в ' + Date().toString();
await System.templater.generateText(Context, `{ExtText('82fe0bc6-0564-4b8a-a7d4-4c136cf8a949', 'logger', '${message}', '${details}')}`);

Результатом выполнения будет следующее:

Логирование данных в обработчике событий

Для того, чтобы понять, какие данные  приходят в обработчик событий в модуле, можно использовать следующий код:

async function action(): Promise<void> {
    const message = 'Сообщение о записи входящего разговора';
    const details = JSON.stringify((<any>Context).json(), null, 2);
    await System.templater.generateText(Context, `{ExtText('82fe0bc6-0564-4b8a-a7d4-4c136cf8a949', 'logger', '${message}', ${details}')}`);
}

В результате, в логе будет следующая информация:

Получения режима окружения

Чтобы в своих решениях понять в каком режиме работает система необходимо в скриптах вызвать следующий метод:

let env_mode = 'Production';
const result = await Imports?.devtools?.action?.env_mode?.call( { for_service: true } )
if (result?.mode)
        env_mode = result.mode;

for_service указывает возвращять ли только 2 варианта: Staging или Production (Development не возвращается, т.к. зарезервировано для отладки), если не указано или false, то возвращаются все значения согласно настроек модуля.

devtools для импорта указан для примера и задается здесь: