Преобразование XML в рабочих процессах с помощью Azure Logic Apps

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

В сценариях корпоративной интеграции с "бизнес — бизнес" (B2B) может потребоваться преобразование XML между форматами. Рабочий процесс приложения логики может преобразовать XML с помощью действия Преобразовать XML и предопределенной карты.

Предположим, вы регулярно получаете заказы или счета от клиента "бизнес — бизнес" (B2B), который используют формат даты ГодМесяцДень (ГГГГММДД). Однако ваша организация использует дату в формате МесяцДеньГод (ММДДГГГГ). Вы можете создать и использовать карту, чтобы преобразовать формат даты ГодМесяцДень в МесяцДеньГод перед сохранением сведений о заказе или счете в базе данных деловой активности клиента.

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

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

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

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

  • Связан с той же подпиской Azure, что и ваш ресурс приложения логики.

  • Существует в том же расположении или регионе Azure, что и ресурс приложения логики, в котором вы планируете использовать действие Преобразование XML.

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

    • карта, используемая для преобразования содержимого XML;

    • ссылка на ресурс приложения логики.

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

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

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

      Примечание.

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

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

  Вам по-прежнему нужна учетная запись интеграции для хранения других артефактов, таких как партнеры, соглашения и сертификаты, вместе с использованием операций AS2, X12 и EDIFACT.

Добавление действия Преобразование XML

Расширенные возможности

Ссылки на сборки или вызов пользовательского кода из карт

Действие Transform XML поддерживает ссылки на внешние сборки из карт, которые позволяют напрямую вызывать пользовательский код .NET из карт XSLT. Дополнительные сведения см. в статье "Добавление карт XSLT для рабочих процессов в Azure Logic Apps".

Объекты расширения ссылок

В стандартных рабочих процессах действие Преобразования XML поддерживает указание объекта расширения XML для использования с картой.

1. В действии преобразования XML откройте список расширенных параметров и выберите объект расширения XML, который добавляет параметр в действие.

2. В поле объекта расширения XML укажите объект расширения, например:

   

Метка порядка байтов

По умолчанию ответ при преобразовании начинается с метки порядка байтов. Эта функция доступна только при работе в редакторе представления кода. Чтобы отключить эту функцию, необходимо задать для свойства transformOptions значение disableByteOrderMark.

"Transform_XML": {
    "inputs": {
        "content": "@{triggerBody()}",
        "integrationAccount": {
            "map": {
                "name": "TestMap"
            }
        },
        "transformOptions": "disableByteOrderMark"
    },
    "runAfter": {},
    "type": "Xslt"
}

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

• Добавление карт XSLT для преобразования XML в Azure Logic Apps
• Проверка XML для рабочих процессов в Azure Logic Apps