Сообщения Exchange X12 с помощью рабочих процессов в Azure Logic Apps

  • Статья

Область применения: Azure Logic Apps (Потребление + Стандартный)

Чтобы отправлять и получать сообщения X12 в рабочих процессах, создаваемых с помощью Azure Logic Apps, используйте соединитель X12 , который предоставляет операции, поддерживающие взаимодействие X12 и управляющие ими.

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

технический справочник по Подключение or

Соединитель X12 имеет одну версию рабочих процессов в нескольких клиентах Azure Logic Apps, azure Logic Apps с одним клиентом и средой службы интеграции (ISE). Технические сведения о соединителе X12 см. в следующей документации:

Необходимые компоненты

  • Учетная запись и подписка Azure. Если у вас еще нет подписки Azure, получите бесплатную учетную запись Azure.

  • Ресурс учетной записи интеграции, в котором вы определяете и сохраняете артефакты, такие как торговые партнеры, соглашения, сертификаты и т. д., для использования в рабочих процессах корпоративной интеграции и B2B. Этот ресурс должен соответствовать следующим требованиям.

    • Учетная запись интеграции и ресурс приложения логики должны существовать в одной подписке Azure и регионе Azure.

    • Определяет по крайней мере двух торговых партнеров, участвующих в операции X12, используемой в рабочем процессе. Определения обоих партнеров должны использовать один и тот же квалификатор бизнес-удостоверений X12.

    • Определяет соглашение X12 между торговыми партнерами, участвующими в рабочем процессе. Для каждого соглашения нужно указать главного партнера и гостевого партнера. Содержимое в сообщениях между вами и другим партнером должно соответствовать типу соглашения. Сведения о параметрах соглашения, используемых при получении и отправке сообщений, см. в параметрах сообщений X12.

      Важно!

      Если вы работаете со схемами Закона об ответственности и переносе данных о страховании здоровья граждан (HIPAA), к соглашению нужно добавить раздел schemaReferences. Дополнительные сведения см. в схемах и типах сообщений HIPAA.

    • Определяет схемы , используемые для проверки XML.

      Важно!

      Если вы работаете со схемами HIPAA, ознакомьтесь с разделом Схемы и типы сообщений HIPAA.

  • В зависимости от того, работаете ли вы над рабочим процессом приложения логики "Потребление" или "Стандартный", ресурс приложения логики может потребовать ссылки на учетную запись интеграции:

    Рабочий процесс приложения логики Требуется ссылка?
    Потребление требуется Подключение ion и ссылка на учетную запись интеграции. При добавлении операции X12 в рабочий процесс можно создать подключение.
    Standard Подключение для учетной записи интеграции требуется, но ссылка не требуется. При добавлении операции X12 в рабочий процесс можно создать подключение.

  • Ресурс приложения логики и рабочий процесс, в котором требуется использовать операции X12.

    Дополнительные сведения см. в следующей документации:

Кодирование сообщений X12

Операция кодирования сообщения X12 выполняет следующие задачи:

  • Разрешает соглашение путем сопоставления свойств контекста отправителя и получателя.
  • Сериализует обмен EDI и преобразует xml-кодированные сообщения в наборы транзакций EDI в обмене.
  • Применяет сегменты набора транзакций и заголовков трейлеров.
  • Создает контрольный номер обмена, номер группового элемента управления и контрольный номер набора транзакций для каждого исходящего обмена.
  • Заменяет разделители в полезных данных.
  • Проверяет EDI и свойства для партнеров.
    • Проверка схемы элементов данных набора транзакций в схеме сообщения.
    • Проверка EDI для элементов данных набора транзакций.
    • Расширенная проверка элементов данных набора транзакций.
  • Запрашивает техническое и функциональное подтверждение, если настроено.
    • Создает техническое подтверждение в результате проверки заголовка. Техническое подтверждение сообщает о состоянии обработки заголовка и окончания обмена получателем.
    • Создает функциональное подтверждение в результате проверки текста. Функциональное подтверждение сообщает о каждой ошибке, обнаруженной при обработке полученного документа.

  1. На портале Azure откройте ресурс и рабочий процесс приложения логики в конструкторе.

  2. В конструкторе выполните следующие общие действия, чтобы добавить действие X12 с именем кодирования в сообщение X12 по имени соглашения в рабочий процесс.

    Примечание.

    Если вы хотите использовать кодирование для сообщения X12 с помощью действия удостоверений, позже необходимо указать различные значения, такие как идентификатор отправителя и идентификатор получателя, указанные в соглашении X12. Кроме того, необходимо указать XML-сообщение для кодирования, которое может быть выходными данными триггера или предыдущего действия.

  3. При появлении запроса укажите следующие сведения о подключении для учетной записи интеграции:

    Свойство Обязательное поле Описание
    Имя подключения Да Имя подключения
    Учетная запись интеграции Да В списке доступных учетных записей интеграции выберите нужную учетную запись.

    Например:

    Screenshot showing Consumption workflow and connection information for action named Encode to X12 message by agreement name.

  4. По завершении нажмите Создать.

  5. В поле сведений о действии X12 укажите следующие значения свойств:

    Свойство Обязательное поле Описание
    Имя соглашения X12 Да Используемое соглашение X12.
    Кодируемое сообщение XML Да XML-сообщение для кодирования
    Прочие параметры No Эта операция включает следующие другие параметры:

    - Разделитель элементов данных
    - Разделитель компонентов
    - Символ замены
    - Признак конца сегмента
    - Суффикс конца сегмента
    - Контрольный номер версии
    - Идентификатор отправителя приложения или код GS02
    - Идентификатор приемника приложения или код GS03

    Дополнительные сведения см . в параметрах сообщения X12.

    Например, вы можете использовать выходные данные содержимого текста из триггера запроса в качестве полезных данных XML-сообщения:

    Screenshot showing Consumption workflow, action named Encode to X12 message by agreement name, and action properties.

Декодирование сообщений X12

Операция декодирования сообщений X12 выполняет следующие задачи:

  • Проверяет конверт на соответствие соглашению с торговым партнером.

  • Проверяет EDI и свойства для партнеров.

    • Структурная проверка EDI и расширенная проверка схемы
    • Проверка структуры конверта обмена
    • Проверка схемы конверта на соответствие схеме управления.
    • Проверка схемы элементов данных набора транзакций в схеме сообщения
    • Проверка EDI для элементов данных набора транзакций

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

    • Проверяет контрольный номер на соответствие предыдущим обменам.
    • Проверяет контрольный номер группы на соответствие контрольным номерам групп в других обменах.
    • Проверяет контрольный номер набора транзакций на соответствие контрольным номерам других наборов транзакций в той же группе.

  • Разделяет обмен на наборы транзакций или сохраняет весь обмен:

    • Разделение обмена на наборы транзакций или приостановка наборов транзакций при ошибке: анализ каждого набора транзакций. Действие декодирования X12 выводит только наборы транзакций, в которые не выполняется проверка badMessages, и выводит остальные наборы транзакций goodMessages.

    • Разделение обмена на наборы транзакций или приостановка обмена по ошибке: анализ каждого набора транзакций. Если один или несколько наборов транзакций в проверке обмена завершаются ошибкой, действие декодирование X12 выводит все наборы транзакций в этом обмене badMessages.

    • Сохраните обмен или приостанавливайте наборы транзакций при ошибке: сохраните обмен и обработайте весь пакетный обмен. Действие декодирования X12 выводит только наборы транзакций, в которые не выполняется проверка badMessages, и выводит остальные наборы транзакций goodMessages.

    • Сохраните обмен или приостанавливайте обмен при ошибке: сохраните обмен и обработайте весь пакетный обмен. Если один или несколько наборов транзакций в проверке обмена завершаются ошибкой, действие декодирование X12 выводит все наборы транзакций в этом обмене badMessages.

  • При настройке создает техническое и функциональное подтверждение.

    • Создает техническое подтверждение в результате проверки заголовка. Техническое подтверждение сообщает о состоянии обработки заголовка и окончания обмена получателем.
    • Создает функциональное подтверждение в результате проверки текста. Функциональное подтверждение сообщает о каждой ошибке, обнаруженной при обработке полученного документа.

  1. На портале Azure откройте ресурс и рабочий процесс приложения логики в конструкторе.

  2. В конструкторе выполните следующие общие действия, чтобы добавить действие X12 с именем Decode X12 в рабочий процесс.

  3. При появлении запроса укажите следующие сведения о подключении для учетной записи интеграции:

    Свойство Обязательное поле Описание
    Имя подключения Да Имя подключения
    Учетная запись интеграции Да В списке доступных учетных записей интеграции выберите нужную учетную запись.

    Например:

    Screenshot showing Consumption workflow and connection information for action named Decode X12 message.

  4. По завершении нажмите Создать.

  5. В поле сведений о действии X12 укажите следующие значения свойств:

    Свойство Обязательное поле Описание
    Неструктурированное сообщение файла X12 для декодирования Да Сообщение X12 в формате неструктурированного файла для декодирования

    Примечание. Полезные данные или содержимое XML-сообщения для массива сообщений, хорошие или плохие, закодированы в кодировке Base64. Поэтому необходимо использовать выражение, обрабатывающее это содержимое. Например, следующее выражение обрабатывает содержимое сообщения как XML:

    xml(base64ToBinary(item()?['Body']))
    Прочие параметры No Эта операция включает следующие другие параметры:

    - Сохранение обмена
    - Приостановка обмена при ошибке

    Дополнительные сведения см . в параметрах сообщения X12.

    Например, можно использовать выходные данные содержимого текста из триггера запроса в качестве полезных данных XML-сообщения, но сначала необходимо предварительно обработать это содержимое с помощью выражения:

    Screenshot showing Consumption workflow, action named Decode X12 message, and action properties.

Следующие шаги