Генератор транзакций

Развитие и инновации
В процессе локализации системы Equation потребовалось средство, позволяющее настраивать правила учета операций. Такое средство было разработано. Первые версии EHI создавались для функционирования совместно с системой кассира, отсюда и название продукта: EHI, Enhanced CS Host Interface («Расширенный хост интерфейс системы кассира»). EHI применялся для настройки правил формирования проводок и их выполнения при совершении кассовых операций. Следующее поколение продукта было расширено, появилась возможность использовать EHI в любом приложении, где требуется гибкий настраиваемый учет операций.

Цели разработки учетного модуля
В процессе создания типичного модуля выполнения учетных операций разработчику необходимо учесть три основных аспекта:

• изучить требования к формированию учетных действий. Необходимо знать, какие действия должны быть выполнены в процессе применения транзакции;
• спроектировать формат вызова данного модуля. Формат должен содержать все параметры, необходимые для формирования учетных действий (номера счетов, суммы, валюты и т. д.);
• позаботиться о соблюдении целостности транзакции. Если какое-либо из учетных действий не может быть выполнено, вся транзакция (ранее выполненные действия) должна быть отменена.

Все перечисленные моменты должны быть учтены при проектировании и кодировании. По завершении разработки создается исходный текст, подлежащий компиляции в программный модуль. В случае изменения учетных правил, форматов вызова или прочих требований необходимо внести изменения в исходный текст и перекомпилировать программу.
Как правило, каждая функциональная область имеет свои требования к выполнению учетных операций, что приводит к необходимости повторения описанного выше процесса.
Разработав «Генератор транзакций», мы решили задачу создания единого, универсального средства, позволяющего настраивать правила выполнения учетных операций и генерировать транзакции в соответствии с определенными настройками. При этом не требуется внесение изменений в программное обеспечение.

Гибкость настройки операций
EHI может быть использован в качестве универсального учетного модуля, так как с его помощью разработчик (или IT-аналитик) может настроить правила учета, определить параметры вызова, расширить стандартные возможности модуля любыми дополнительными бизнес-функциями и интегрировать учетный модуль в свое приложение.
Во время работы ядро EHI интерпретирует настройки и выполняет транзакции в соответствии с этими настройками. О целостности транзакции также заботится EHI. Нет необходимости жестко кодировать правила учета в отдельном модуле. В случае изменения требований разработчик (или IT-аналитик) должен лишь изменить настройки транзакции, определенные в учетном модуле.

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

• тип транзакции (или «макет» — используется для получения настроек транзакции);
• режим функционирования (определяет режим работы EHI);
• шифр транзакции. Уникальный референс, позволяющий идентифицировать данную транзакцию в таблицах EHI. Может быть оставлено пустым, тогда модуль сформирует референс в соответствии с правилом формирования референса (настраивается в функции «Определение макета EHI»);
• дополнительные параметры. Дополнительные параметры могут быть использованы для передачи в «Генератор транзакций» специфических бизнес-данных. Разработчик может определить структуру параметров в соответствии со своими требованиями (при помощи функции «Настройка карт переменных»).

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

Режимы функционирования Учетный модуль EHI может работать в следующих режимах:

• Generate — выполняется только построение списка действий по транзакции. Сами действия не выполняются;
• Validate — выполняется построение списка действий, каждое действие отдельно проверяется на возможность выполнения. Если возникнут какие-либо ошибки или предупреждения (разные валюты, недостаточно средств и т. п.), то они будут возвращены в вызывающее приложение;
• Post — выполняется построение и применение списка действий. В случае возникновения ошибки при обработке какого-либо действия все ранее выполненные действия отменяются.
• Query — этот режим используется для получения информации о ранее выполненных действиях. Вызывающее приложение должно передать в EHI шифр транзакции для поиска информации;
• Delete — аналогичен режиму Query, только все выполненные действия удаляются. Например, если проводка генерировалась сегодня, то она будет удалена. Если проводка выполнялась в предыдущие дни, то будет сформирована обратная или корректирующая проводка.

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

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

Интерпретация выражений
В учетный модуль встроено средство, позволяющее выполнять интерпретацию выражений простейшего basic-подобного языка. Он работает с тремя основными типами данных: символьной строкой, числом и логическим значением.
Поддерживаются основные операторы, такие как «плюс», «минус», «разделить», «умножить» и т. д. Выражения могут содержать переменные, определенные в карте параметров. Кроме того, поддерживаются такие функции, как SUBSTR, ROUND, MIN, MAX и другие. EHI-интерпретатор может вызывать дополнительные EHI-, Equation- или OS400-связанные функции. Например, CONVERT — конвертация суммы из одной валюты в другую на основе розничных курсов, CHECKACC — проверка наличия счета, DAJOBCTL — получение содержимого области данных DAJOBCTL и т. д. Кроме того, банк может определить собственные функции и интегрировать их в интерпретатор EHI.

Расширение базовой функциональности учетного модуля В случае необходимости расширения базовой функциональности учетного модуля банк может:

• разработать дополнительные функции для использования в интерпретаторе выражений EHI. Вместе с EHI поставляется среда разработки, содержащая документацию и шаблоны программ на языках RPG и ILE C;
• разработать дополнительные типы действий. Для этого необходимо создать три дополнительных модуля: модуль добавления действия, модуль проверки действия, модуль отмены действия. Документация по EHI содержит информацию о том, как это сделать. Кроме того, вместе с EHI поставляются некоторые утилиты, применяемые для быстрого создания новых типов действий на основе журналов системы Equation;
• использовать точки вызова пользовательских программ в учетном модуле. Стандартная версия EHI не содержит точек вызова пользовательских программ, однако данная функциональность может быть добавлена по запросу банка.

Интеграция внешних систем
EHI позволяет использовать для интеграции внешних систем стандартный механизм системы Equation — Cashier Host Interface.
Механизм Cashier Host Interface позволяет выполнить из внешних систем вызов программного объекта (Action Module), которому передается стандартный перечень параметров, содержащих информацию, необходимую для выполнения операции в системе Equation.
Action Module осуществляет (в случае необходимости) дополнительное преобразование данных и выполнение требуемых операций.
В составе EHI поставляется Action Module, позволяющий использовать функциональность модуля «Генератор транзакций» из внешних приложений, использующих Cashier Host Interface, к примеру, Cashier System, EBA и собственные разработки банка.