Интеграционный модуль

Назначение модуля
Модуль предназначен для организации межсистемного взаимодействия Equation и других банковских систем обработки информации.
Стандартный подход, который предлагается для организации взаимодействия с внешними системами, — использование API Equation. При этом возникают следующие проблемы:

• API Equation расположены на сервере iSeries. Это значит, что вызов данных функций требует определенных навыков и знаний по системе Equation и iSeries;
• банковская операция — это набор отдельных транзакций (открытие счетов, формирование проводок, регистрация дополнительной информации и т. д.). Надо уметь объединять вызовы отдельных API в целостные банковские операции;
• для успешной обработки информации в системе Equation необходимо знать особенности этой системы (см. пример по типу счета из раздела о миграции данных).

Описанные выше проблемы затрудняют использование функций Equation до такой степени, что разработчики других систем, сделав несколько попыток, приходят к выводу о сложности или даже невозможности интеграции своих приложений в Equation или о необходимости использования файлового обмена информацией.
Для организации межсистемного взаимодействия создан коммуникационный модуль Equation Gate&Interfaces.

Состав модуля
Модуль состоит из трех частей:

• сервер, обеспечивающий многопоточную обработку информации, поступающей из внешних систем. Сервер функционирует на платформе iSeries;
• библиотека функций прикладного программного интерфейса платформы Windows, реализующая на данный момент набор из 50 операций (идентификация клиента, открытие счета, ввод документов определенных типов и т. д.). Библиотека содержит специальные функции, позволяющие управлять количеством процессов обработки информации, запускаемых на iSeries. Библиотека обеспечивает корректное с точки зрения системы Equation выполнение работ (установка соединения, проверка доступности системы, создание рабочей среды, идентификация пользователя и т. д.);
• программы и опции по выгрузке из системы Equation во внешнюю систему клиентов, счетов и документов. Существует возможность как автоматической выгрузки информации по мере ее появления или изменения в системе, так и выгрузки информации по запросу пользователя.

Связь с внешними расчетными системами
При загрузке и выгрузке информации могут быть использованы различные механизмы вызова функций. Например, при взаимодействии в направлении Equation → Diasoft использовались веб-сервисы, а при вызове функций Equation использовалась библиотека функций Windows.

Примеры использования модуля
После выноса функций Equation на платформу Windows и оформления в виде банковских операций проблема межмодульного взаимодействия была решена. Примером может служить проект внедрения Equation в банке «АК БАРС». Компания Diasoft смогла использовать для выгрузки и загрузки информации в систему Diasoft специальный адаптер, который, помимо транспортных функций, позволяет выполнять аудит процесса обмена информацией и сверку балансов двух систем. Компания EsterDev, являющаяся разработчиком программного обеспечения фронт-офиса банка «АК БАРС», смогла обеспечить для фронт-офисных приложений запрос информации из системы Equation, открытие клиентов и счетов и загрузку в систему Equation банковских операций.

Версия 3.0

Интеграционный модуль (EQSoap) представляет собой высокопроизводительный сервер, предназначенный для обслуживания клиентских запросов по протоколу SOAP. EQSoap реализован и функционирует на платформе IBM i, для его работы не требуется наличия никаких дополнительных серверных компонент. EQSoap построен с использованием пакета разработки SOAP/Web сервисов gSOAP.

gSOAP является open source средством генерации программного кода на языке C/C++ различных клиентских и серверных компонент SOA архитектуры. Генерируемый код может использоваться для построения высокопроизводительных компонент SOA приложений, включая компоненты серилизации/ десерилизации XML документов, компоненты серверной и клиентской части по обслуживанию HTTP(s)/SOAP протокола, а также реализации отдельных стандартов SOAP протокола. gSOAP генерирует чистый код на языке C/C++, который может быть использован при построении программных комплексов на различных программных и аппаратных платформах. Этот код характеризуется высокой производительностью, так как реализует только те функции, которые должны присутствовать в конкретной задаче. Кроме того, этот программный код самодостаточен, то есть для полноценной работы требуемой функциональности не требуется наличия дополнительных серверных или клиентских приложений, таких как WebSphere, JBoss или прочих.

Архитектура EQSoap спроектирована таким образом, чтобы обеспечить максимальную производительность и отказоустойчивость SOAP сервера. Для этого использованы различные алгоритмы, включая мультипоточную обработку запросов, очереди, предварительно стартованные потоки обработки, динамическое увеличение количества потоков в зависимости от нагрузки на сервер и прочие.

В состав EQSoap входит «генератор сервисов», позволяющий создать модуль-оболочку для преобразования любой программы IBM i в полноценный web-сервис. Для того чтобы программа на платформе IBM i стала доступна по протоколу SOAP, достаточно подготовить PCML файл описания ее входных и выходных параметров, и сгенерировать на его основе модуль-оболочку, которую будет использовать EQSoap для трансляции обращений к сервису в вызовы данной программы.

Как большинство SOAP серверов, в EQSoap реализован протокол SOAP поверх протокола HTTP(s). Реализация HTTP сервера в EQSoap, кроме SOAP протокола (POST запросы), включает реализацию GET протокола для получения статических файлов, находящихся на файловой системе IBM i, а также для взаимодействия со стандартным API системы EQUATION посредством специально сформированных GET запросов.
Модуль взаимодействия с EQUATION, входящий в EQSoap, позволяет клиентским приложениям обращаться к любому API EQUATION, поддерживающему K484 Enhanced API. Для этого клиентское приложение должно отправить в EQSoap специальным образом сформированный HTTP GET запрос, содержащий входные параметры для API, и в ответ будет получен XML документ с выходными параметрами данного API.

Кроме поддержки стандартного API EQUATION, в EQSoap существует возможность прямого обращения к функциональности Генератора Транзакций (EHI). Для вызова любого макета EHI не требуется какое-либо дополнительное кодирование – достаточно сформировать SOAP XML запрос требуемой структуры, и вызвать сервис взаимодействия с EHI - ehiCall. В ответном сообщении будет содержаться результат выполнения, включающий все перечень всех выполненных действий.

В рамках взаимодействия с IBM i, в EQSoap включены базовые механизмы создания и использования прикладного соединения с IBM i. Для обращения к сервисам EQSoap, необходимо создать прикладное соединение, так называемую «сессии EQSoap», в которой будут обслуживаться все клиентские запросы. При создании сессии указывается идентификатор пользователя IBM i, сама сессия представляет собой отдельную работу на сервере IBM i, работающую под именем и в соответствии с полномочиями указанного пользователя, таким образом, любые обращения к данной сессии будут обслуживаться так же, как если бы пользователь работал бы в классической терминальной сессии IBM i.