Привет, Хабр!

Меня зовут Илья Вязников, я инженер сопровождения СОФРОС. Я делюсь практическими приёмами и полезными настройками платформы.

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

Нормализация GUID, очистка строк, проверки на пустые значения, преобразование форматов, парсинг JSON — сначала это несколько строк кода, потом десятки одинаковых фрагментов в разных схемах обработки. В результате:

• Алгоритмы становятся сложнее читать;

• Исправления приходится вносить в нескольких местах;

• Возрастает риск, что часть процессов останется со старой логикой.

В DATAREON Platform эту проблему можно решить через программные модули — механизм для хранения и повторного использования собственных функций на C#.

В статье покажу:

• Как создать программный модуль;

• Как добавить в него собственную функцию;

• Как вызывать её из алгоритмов;

• Какие сценарии особенно удобно выносить в модули на практике.

Зачем это нужно:

• Повышение читаемости и поддерживаемости кода.

• Централизованное хранение бизнес-логики.

• Упрощение доработок - меняешь функцию в одном месте, а не в десятках алгоритмов.

В качестве примера разберём функцию нормализации GUID, которая часто встречается в интеграциях между разными системами. 

Шаг 1. Создание программного модуля

1. В Центре настройки перейдите в раздел: Обработка данных → Схемы обработки.

2. Нажмите «Добавить»(+) → Программный модуль.

   

3. На вкладке Основные заполните:

   • Название: PM_ПрограммныйМодуль_Пример (или любое удобное вам)

   • Имя: PM_ПрограммныйМодуль_Пример

   

4. Перейдите на вкладку Код и добавьте нужные функции. Ниже представлен пример одной функции.

   Для примера реализуем функцию нормализации GUID. Она:

   • возвращает пустой GUID для null и пустых значений;

   • приводит корректные GUID к единому формату;

   • удаляет лишние пробелы.

   public static string НормализоватьГуид(object value)
   {
       if (value == null)
       {
           return Guid.Empty.ToString("D");
       }
   
       string text = value.ToString();
   
       if (Guid.TryParse(text, out Guid guid))
       {
           return guid.ToString("D");
       }
   
       return string.IsNullOrWhiteSpace(text) ? Guid.Empty.ToString("D") : text.Trim();
   }

   Можно добавлять сколько угодно функций в один модуль.

   

5. Сохраните и примените изменения.

Шаг 2. Вызов функции в алгоритме

После сохранения модуль становится доступен из пользовательских алгоритмов по имени модуля и имени функции. 

Для вызова используется специальный синтаксис:

{ИмяМодуля}.{НазваниеФункции}(параметры);

Пример использования в пользовательском алгоритме:

var testValues = new object[]
{
    null,
    "",
    "   ",
    "abc",
    "  abc  ",
    "6F9619FF-8B86-D011-B42D-00C04FC964FF",
    "{6F9619FF-8B86-D011-B42D-00C04FC964FF}",
    "invalid-guid",
    123,
    Guid.Empty
};

foreach (var value in testValues)
{
    Строка = value?.ToString();
    Logger.Info($"До вызова функции: {Строка}");
    Строка = PM_ПрограммныйМодуль_Пример.НормализоватьГуид(value);
    Logger.Info($"После вызова функции: {Строка}");
}

Ожидаемый результат

После выполнения алгоритма в логах вы увидите корректную нормализацию значений, например:

Функция становится доступна во всех бизнес-процессах и алгоритмах системы.

Полезные советы:

1. Не превращайте модуль в «свалку функций» - Лучше разделять по зонам ответственности.

2. Выносите только повторяемую логику - Если код используется один раз, модуль может быть избыточен.

3. Делайте функции максимально детерминированными - Без скрытых побочных эффектов и зависимости от внешнего состояния.

4. Используйте единый нейминг - Это сильно упрощает поддержку больших проектов.

Чаще всего в модули удобно выносить:

• Работу с GUID;

• Очистку и нормализацию строк;

• Преобразование дат;

• Парсинг JSON/XML;

• Формирование кодов, артикулов и идентификаторов;

• Общие проверки входных данных.

Заключение

Программные модули в DATAREON Platform позволяют сделать алгоритмы компактнее, читаемее и проще в сопровождении.

Если в проекте появляется повторяющийся код хотя бы в нескольких процессах, это уже хороший сигнал вынести его в отдельную функцию и переиспользовать централизованно.

На практике такой подход сокращает количество ошибок при доработках и ускоряет поддержку интеграций.

А какие функции вы чаще всего выносите в программные модули?

Для тех кто хочет подробнее ознакомиться с функционалом описанным в статье - полезные ссылки:

• Документация DATAREON по настройке программного модуля