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