🍬 RMG 365 | Dev Tools
Набор инструментов разработчика ELMA365

Установка и настройка решения
Поддержка решения осуществляется на добровольной основе в канале 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
СайтTG канал
Ежедневные находки и приёмы для работы в ELMA365: скрипты, шаблоны, автоматизация и быстрые решения.

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();
}
Данный код работает только в клиентских скриптах и не работает в серверных.
 