Анализ и создание файлов узлов из мейнфреймов IBM для стандартных рабочих процессов в Azure Logic Apps
Область применения: Azure Logic Apps (стандартная версия)
Чтобы проанализировать и создать новые файлы узлов IBM и физические файлы серии i из стандартных рабочих процессов в Azure Logic Apps, можно использовать встроенный соединитель поставщика услуг. С момента внедрения систем мейнфреймов файлы универсального узла используются для хранения богатых данных для критически важных систем. Хотя этот соединитель не требует доступа к системе мейнфрейма IBM или среднего уровня, необходимо сделать файл узла доступным для рабочего процесса уровня "Стандартный" с помощью других механизмов, таких как FTP, хранилище BLOB-объектов, сервер интеграции узла или партнерское программное обеспечение (модуль). Соединитель файлов узла IBM доступен во всех регионах Azure Logic Apps, за исключением Azure для государственных организаций и Microsoft Azure, управляемых 21Vianet.
В этом руководстве описаны следующие аспекты соединителя файлов узла IBM:
Почему в Azure Logic Apps используется соединитель файлов узла IBM
Предварительные требования и настройка для использования соединителя файлов узла IBM
Действия по добавлению действий соединителя файлов узла IBM в рабочий процесс приложения логики уровня "Стандартный"
Зачем использовать этот соединитель?
В мейнфреймах IBM методы доступа, которые являются специальными компонентами в операционной системе, обрабатывают обработку файлов. В 1970-х годах был создан метод виртуального служба хранилища доступа (VSAM) и стал самым широко используемым методом доступа в мейнфреймах IBM. VSAM предоставляет следующие типы файлов: наборы данных с последовательностью входа, наборы данных с последовательностью ключей и относительные наборы данных записи.
Сегодня на рынке есть несколько решений, которые напрямую подключаются к файлам узлов и выполняют операции с данными. Многие решения требуют установки программного обеспечения в системе мейнфрейма. Хотя этот вариант хорошо подходит для некоторых клиентов, другие хотят избежать роста присутствия в своих системах мейнфреймов.
Сервер интеграции узлов Майкрософт (HIS) предоставляет управляемый адаптер для файлов узлов и не требует установки программного обеспечения на мейнфрейме. Однако ДЛЯ ЕГО необходимо включить подсистему мейнфрейма IBM Distributed File Manager (DFM), которая требует LU 6.2. Этот управляемый поставщик также требует настройки шлюза SNA, который предоставляет доступ к DFM.
В большинстве случаев управляемый поставщик работает как обычный поставщик данных. Вы можете подключиться к файловой системе узла, выполнить команды и получить данные. Хотя отличный вариант для некоторых клиентов, соединитель файлов узла IBM требует, чтобы файлы узлов IBM были доступны в двоичном формате в стандартных рабочих процессах в Azure Logic Apps. Это требование снижает сложность этого решения и позволяет использовать выбранные средства для доступа к данным в файлах узлов и управления ими. После того как файл узла будет доступен в месте, где рабочий процесс уровня "Стандартный" может использовать триггер для чтения файла, операция соединителя файлов узла IBM может проанализировать этот файл.
Для клиентов, заинтересованных в доступе и использовании баз данных, таких как SQL Server или Cosmos DB, в их средах мейнфреймов соединитель узла IBM предоставляет возможность создавать файлы узлов в формате JSON. Таким образом, эти файлы узлов можно использовать в выбранной облачной базе данных и отправлять данные обратно в качестве файла узла в мейнфрейм или среды среднего порядка.
На следующей схеме показано, как соединитель файлов узла IBM в Azure Logic Apps взаимодействует с другими системами:
Чтобы расширить гибридные облачные сценарии, соединитель файлов узла IBM работает с конструктором HIS для Logic Apps, который можно использовать для создания определения данных или карты данных файла узла мейнфрейма. Для этой задачи КОНСТРУКТОР ЕГО преобразует эти данные в метаданные, которые соединитель файлов узла IBM использует при выполнении действия в рабочем процессе. Соединитель выполняет преобразования типов данных, которые необходимы для получения входных данных из предыдущих операций рабочего процесса и отправки выходных данных для использования последующими действиями рабочего процесса. Соединитель также предоставляет табличное определение данных и перевод кодовой страницы.
После создания файла метаданных в качестве XML-файла конструктора интеграции узлов (HIDX) из конструктора HIS можно добавить этот файл в качестве артефакта карты в ресурс приложения логики "Стандартный". Таким образом, рабочий процесс может получить доступ к метаданным приложения при добавлении действия соединителя файлов узла IBM. Соединитель считывает файл метаданных из ресурса приложения логики и динамически представляет структуру двоичного файла для использования с действиями соединителя узла IBM в рабочем процессе.
технический справочник по Подключение or
В следующем разделе описываются операции соединителя файлов узла IBM, которые в настоящее время включают только следующие действия:
Действие анализа содержимого файла узла
| Параметр | Обязательное поле | Тип | Описание |
|---|---|---|---|
| Имя HIDX | Да | Строка | Выберите файл HIDX узла мейнфрейма, который вы хотите использовать. |
| Имя схемы | Да | Строка | Выберите схему файла узла в файле HIDX, который вы хотите использовать. |
| Двоичное содержимое | Да | Binary | Выберите двоичные данные с записью фиксированной длины, извлеченной из мейнфрейма. |
Создание действия "Содержимое файла узла"
| Параметр | Обязательное поле | Тип | Описание |
|---|---|---|---|
| Имя HIDX | Да | Строка | Выберите файл HIDX узла мейнфрейма, который вы хотите использовать. |
| Имя схемы | Да | Строка | Выберите схему файла узла в файле HIDX, который вы хотите использовать. |
| Строки | Да | JSON | Выберите массив или отдельные строки. Чтобы ввести весь объект данных в формате JSON, можно выбрать параметр Switch для ввода всего массива . |
Ограничения
В настоящее время этот соединитель требует передачи HIDX-файла непосредственно в ресурс приложения логики уровня "Стандартный", а не учетную запись интеграции.
Необходимые компоненты
Учетная запись и подписка Azure. Если у вас еще нет подписки Azure, зарегистрируйтесь для получения бесплатной учетной записи Azure.
XML-файл КОНСТРУКТОРа интеграции узлов (HIDX), предоставляющий необходимые метаданные для соединителя файлов узла IBM для распознавания структуры данных файла узла.
Чтобы создать этот HIDX-файл, скачайте и установите ЕГО конструктор для Azure Logic Apps. Единственным необходимым условием является наличие Microsoft .NET Framework 4.8.
Для эффективного анализа и создания файлов узлов рабочий процесс должен понять метаданные файла узла. Однако в качестве ключевого различия между файлом узла и таблицей базы данных файл узла не содержит метаданных, описывающих структуру данных. Чтобы создать эти метаданные, используйте конструктор HIS для Logic Apps. С помощью этого средства можно вручную создать структуру файлов узла, которую использует рабочий процесс. Вы также можете импортировать определения COBOL (книги копирования), которые предоставляют эти структуры данных.
Средство создает XML-файл КОНСТРУКТОРа интеграции узлов (HIDX), который предоставляет необходимые метаданные для соединителя для распознавания структуры данных файла узла. Если вы используете ЕГО, с помощью конструктора TI можно создать HIDX-файл.
Рабочий процесс приложения логики уровня "Стандартный", в котором требуется проанализировать или создать файл узла.
Соединитель файлов узла IBM не имеет триггеров, поэтому используйте любой триггер для запуска рабочего процесса, например триггер повторения или триггера Хранилище BLOB-объектов Azure. Затем можно добавить действия соединителя файлов узла IBM. Чтобы приступить к работе, создайте пустой рабочий процесс в ресурсе приложения логики "Стандартный".
Определение и создание метаданных
После скачивания и установки ЕГО конструктора для Azure Logic Apps выполните следующие действия, чтобы создать ФАЙЛ HIDX из артефакта метаданных.
Отправка HIDX-файла
Чтобы рабочий процесс использовал HIDX-файл, выполните следующие действия.
Перейдите в папку, в которой сохранен файл HIDX, и скопируйте файл.
В портал Azure отправьте HIDX-файл в виде сопоставления с ресурсом приложения логики "Стандартный".
Далее в этом руководстве при добавлении действия "Анализ содержимого файла узла" в рабочий процесс появится запрос на создание подключения. После создания подключения можно выбрать ранее добавленный HIDX-файл, схему и используемые параметры.
Добавление действия анализа содержимого файла узла
В портал Azure откройте ресурс приложения логики "Стандартный" и рабочий процесс в конструкторе.
Если вы еще не добавили триггер для запуска рабочего процесса, выполните следующие общие действия, чтобы добавить нужный триггер.
В этом примере продолжается встроенный триггер на основе поставщика услуг Хранилище BLOB-объектов Azure с именем "При добавлении или обновлении большого двоичного объекта".
Чтобы получить содержимое из добавленного или обновленного большого двоичного объекта, выполните следующие общие действия, чтобы добавить Хранилище BLOB-объектов Azure встроенное действие соединителя с именем Read BLOB-объектов.
После появления области сведений о подключении укажите следующие сведения:
Параметр Обязательное поле значение Описание Имя подключения Да <имя_соединения> Имя подключения. Кодовая страница No <кодовая страница> Номер кодовой страницы, используемый для преобразования текста Из iSeries No <MF-iseries> Происходит ли файл с сервера серии i Например:
По завершении нажмите кнопку "Создать".
После появления области сведений о действии в разделе "Параметры " укажите необходимые сведения:
Параметр Обязательное поле значение Описание Имя HIDX Да <HIDX-file-name> Выберите файл HIDX узла мейнфрейма, который вы хотите использовать. Имя схемы Да <имя схемы> Выберите схему в файле HIDX, который вы хотите использовать. Двоичное содержимое Да <двоичное содержимое> Выберите двоичные данные с фиксированной длиной записи, извлеченной из узла. Например, на следующем рисунке показан Visual Studio с примером файла HIDX узла с таблицей CUSTOMER и схемой CUSTOMER_RECORD в конструкторе HIS для Logic Apps:
Предоставление HIDX-файла и схемы
Выбор двоичных данных для чтения из большого двоичного объекта
После завершения действия действие "Анализ содержимого файла узла" выглядит следующим образом с последующим действием, создающим файл на сервере SFTP:
Закончив работу, сохраните свой рабочий процесс. На панели инструментов конструктора нажмите кнопку "Сохранить".
Добавление действия "Создание содержимого файла узла"
В портал Azure откройте ресурс приложения логики "Стандартный" и рабочий процесс в конструкторе.
Если вы еще не добавили триггер для запуска рабочего процесса, выполните следующие общие действия, чтобы добавить нужный триггер.
В этом примере продолжается встроенный триггер на основе поставщика услуг Хранилище BLOB-объектов Azure с именем "При добавлении или обновлении большого двоичного объекта".
Чтобы получить содержимое из добавленного или обновленного большого двоичного объекта, выполните следующие общие действия, чтобы добавить Хранилище BLOB-объектов Azure встроенное действие соединителя с именем Read BLOB-объектов.
После появления области сведений о подключении укажите следующие сведения:
Параметр Обязательное поле значение Описание Имя подключения Да <имя_соединения> Имя подключения. Кодовая страница No <кодовая страница> Номер кодовой страницы, используемый для преобразования текста Из iSeries No <MF-iseries> Происходит ли файл с сервера серии i Например:
По завершении нажмите кнопку "Создать".
После появления области сведений о действии в разделе "Параметры " укажите необходимые сведения:
Параметр Обязательное поле значение Описание Имя HIDX Да <HIDX-file-name> Укажите имя файла HIDX узла мейнфрейма, который вы хотите использовать. Имя схемы Да <имя схемы> Укажите имя схемы в файле HIDX, который вы хотите использовать. Строки Да <rows> Предоставьте массив записей для преобразования в формат IBM. Чтобы выбрать выходные данные из предыдущей операции рабочего процесса, выполните следующие действия.
1. Выберите внутри поля "Строки" , а затем выберите параметр динамического содержимого (молния болт).
2. В списке динамического содержимого выберите выходные данные из предыдущего действия. Например, в разделе "Чтение содержимого BLOB-объектов" выберите "Ответ" из содержимого действия большого двоичного объекта.
Совет. Чтобы ввести весь объект данных в формате JSON, выберите параметр "Переключиться на ввод всего массива ".Например, на следующем рисунке показан Visual Studio с примером HIDX-файла в конструкторе HIS для Logic Apps:
Предоставление HIDX-файла и схемы
Выбор строк из большого двоичного объекта для чтения и преобразования
После завершения действия действие "Создать содержимое файла узла" выглядит следующим образом с последующим действием, создающим файл на сервере SFTP:
Закончив работу, сохраните свой рабочий процесс. На панели инструментов конструктора нажмите кнопку "Сохранить".
Тестирование рабочего процесса
Чтобы запустить рабочий процесс, в меню рабочего процесса выберите "Обзор". На панели инструментов "Обзор" нажмите кнопку "Выполнить".>
После завершения выполнения рабочего процесса появится журнал выполнения рабочего процесса. Успешные шаги показывают проверка метки, в то время как неудачные шаги показывают восклицательный знак (!).
Чтобы проверить входные и выходные данные для определенного шага, разверните его.
Чтобы просмотреть выходные данные, выберите Показать необработанные выходные данные.
Следующие шаги
- Мониторинг состояния выполнения рабочего процесса, проверка и журнал выполнения рабочего процесса и настройка оповещений в Azure Logic Apps
- Просмотр метрик для работоспособности и производительности рабочих процессов в Azure Logic Apps
- Мониторинг и сбор диагностических данных для рабочих процессов в Azure Logic Apps
- Включение и просмотр расширенной телеметрии в приложении Аналитика для рабочих процессов уровня "Стандартный" в Azure Logic Apps