Проверка XML в рабочих процессах с Azure Logic Apps

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

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

Если вы не знакомы с приложениями логики, ознакомьтесь со статьей Что такое Azure Logic Apps? Дополнительные сведения о корпоративной интеграции B2B см. в статье Рабочие процессы интеграции корпоративного уровня B2B с использованием Azure Logic Apps и Пакета интеграции Enterprise.

Предварительные требования

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

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

    Если у вас пустой рабочий процесс, используйте любой триггер. В этом примере используется триггер запроса.

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

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

    • Находится в том же расположении или регионе Azure, что и ресурс приложения логики, в котором планируется использовать действие проверки XML *.

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

    • Если вы используете тип ресурса Приложение логики (стандартный), вам не нужно хранить схемы в учетной записи интеграции. Можно добавить схемы непосредственно в ресурс приложения логики либо на портале Azure, либо в Visual Studio Code. Затем можно использовать эти схемы в нескольких рабочих процессах в одном ресурсе приложения логики.

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

      Примечание

      В настоящее время операции RosettaNet поддерживаются только типом ресурсов Приложение логики (потребление). Тип ресурса Приложение логики (стандартный) не включает операции RosettaNet.

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

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

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

    Чтобы добавить триггер запроса, в поле поиска конструктора введите HTTP request и выберите триггер запроса с именем При получении HTTP-запроса.

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

    Для приложения логики на основе плана "Потребление" или ISE выберите шаг:

    • Чтобы добавить действие Проверка XML в конце рабочего процесса, выберите Новый шаг.

    • Для добавления действия Проверка XML между существующими шагами переместите указатель на стрелку, соединяющую эти шаги, чтобы появился символ "плюс" ( + ). Нажмите этот символ "плюс", затем выберите Добавить действие.

    Для приложения логики на основе плана "Стандартный" выберите шаг:

    • Чтобы добавить действие Проверка XML в конце рабочего процесса, нажмите символ "плюс" ( + ), а затем выберите Добавить действие.

    • Для добавления действия Проверка XML между существующими шагами нажмите символ "плюс" ( + ), который отображается между этими шагами, а затем выберите Добавить действие.

  4. В разделе Choose an operation (Выберите операцию) выберите Встроено. В поле поиска введите xml validation. В списке действий выберите Проверка XML.

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

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

    Для приложения логики на основе плана "Потребление" или ISE конструктор выглядит как в следующем примере.

    Снимок экрана: конструктор для мультитенантного приложения с открытым списком динамического содержимого и курсором в поле

    Для приложения логики на основе плана "Стандартный" конструктор выглядит как в следующем примере.

    Снимок экрана: конструктор для однотенантного приложения с открытым списком динамического содержимого и курсором в поле

  6. Из списка динамического содержимого выберите токен свойства для содержимого, требующего проверки.

    В примере выбран токен Текст из триггера.

  7. Чтобы указать схему, используемую для проверки, откройте список Имя схемы и выберите добавленную ранее схему.

  8. Когда закончите, сохраните рабочий процесс приложения логики.

    Таким образом, вы завершили настройку действия Проверка XML. В реальном приложении вы захотите сохранить проверенные данные в бизнес-приложении, например в SalesForce. Чтобы отправить проверенные выходные данные в Salesforce, добавьте действие Salesforce.

  9. Чтобы проверить действие проверки, активируйте и запустите рабочий процесс. Например, для триггера запроса отправьте запрос в URL-адрес конечной точки триггера.

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

Дальнейшие действия