🍬 RMG 365 | Dev Tools

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

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

Поддержка решения осуществляется на добровольной основе в канале 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 для импорта указан для примера и задается здесь:

Полезное от WhatDaELMA365

Custom Loader

Пример, как выглядит режим загрузки данных:

В клиентский скрипт нужно добавить следующий код в самом начале:

declare const window: any;

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

async function updateOrganizations(): Promise<void> {

  // Показать loader
  window.CustomLoader.show();
    
  ViewContext.data.show_organizations_update = true;
  await Server.rpc.updateOrganizations();
  ViewContext.data.show_organizations_update = false;
  
  // Скрыть loader
  window.CustomLoader.hide();
}

Данный код работает только в клиентских скриптах и не работает в серверных.