Поделиться через


Добавление схем для использования с рабочими процессами в Azure Logic Apps

Применяется к: Azure Logic Apps (Расход + Стандарт)

Для выполнения задач рабочих процессов, таких как неструктурированный файл и проверка XML, требуется схема. Например, для действия проверки XML требуется XML-схема, чтобы убедиться, что документы используют допустимый XML и имеют ожидаемые данные в предопределенном формате. Эта схема представляет собой XML-документ, использующий язык определения схемы XML (XSD) и имеющий расширение XSD-файла. Действия с неструктурированными файлами используют схему для кодирования и декодирования XML-содержимого.

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

Prerequisites

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

  • Файл схемы, который требуется добавить. Для создания схем можно использовать Visual Studio 2019 и расширение средств интеграции Microsoft Azure Logic Apps Enterprise.

    Примечание

    Не устанавливайте расширение вместе с расширением BizTalk Server. Наличие обоих расширений может привести к непредвиденному поведению. Убедитесь, что установлено только одно из этих расширений.

    На мониторах с высоким разрешением может возникнуть проблема с отображением конструктора карт в Visual Studio. Чтобы устранить эту проблему, перезапустите Visual Studio в режиме, не поддерживающем DPI, либо добавьте значение реестра DPIUNAWARE.

  • В зависимости от того, работаете ли вы над рабочим процессом приложения логики категории "Потребление" или "Стандартный", вам потребуется ресурс учетной записи интеграции. Как правило, этот ресурс требуется при определении и хранении артефактов для использования в рабочих процессах интеграции предприятия и совместной работы B2B.

    Важно

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

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

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

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

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

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

Limitations

  • Ограничения применяются к количеству артефактов, таких как схемы, для каждой учетной записи интеграции. Дополнительные сведения см. в статье Ограничения и сведения о конфигурации для Azure Logic Apps.

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

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

    • Если вы работаете с рабочими процессами потребления, применяются следующие ограничения:

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

    An error occurred while processing the XML schemas: ''SchemaLocation' must successfully resolve if <redefine> contains any child other than <annotation>.'.

    Чтобы устранить эту ошибку, необходимо использовать элемент xsd:import или xsd:include вместо xsd:redefine, или использовать URI.

Рекомендации по добавлению схем

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

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

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

    • Добавьте схему непосредственно в ресурс приложения логики. Однако эту схему можно использовать только в дочерних рабочих процессах в пределах одного ресурса логического приложения.

Добавление схемы в учетную запись интеграции

  1. Войдите на портал Azure с помощью учетных данных учетной записи Azure.

  2. В главном поле поиска Azure введите учетные записи интеграции и выберите учетные записи интеграции.

  3. Выберите учетную запись интеграции, в которой необходимо добавить схему.

  4. В меню ресурсов учетной записи интеграции в разделе "Параметры" выберите "Схемы".

  5. На панели инструментов панели "Схемы" нажмите кнопку "Добавить".

Добавление схем в приложение логики

Для рабочих процессов потребления, в зависимости от размера файла вашей схемы, выполните шаги по загрузке схемы, которая имеет размер до 2 МБ или более 2 МБ, до 8 МБ.

Добавьте схемы размером до 2 МБ

  1. В области добавления схемы введите имя схемы. Оставьте выбранным параметр Мелкий файл. Рядом с полем схемы выберите значок папки. Найдите и выберите схему, которую вы отправляете.

  2. По завершении нажмите кнопку ОК.

    После завершения отправки схемы схема появится в списке схем .

Добавление схем более 2 МБ

Чтобы добавить более крупные схемы для рабочих процессов потребления, можно использовать REST API Azure Logic Apps — схемы или отправить схему в контейнер BLOB-объектов Azure в учетной записи хранения Azure. Шаги по добавлению схем могут быть различными, если ваш контейнер blob общедоступен для чтения. Сначала проверьте, есть ли у вашего контейнера BLOB-объектов открытый доступ на чтение, выполнив следующие действия: Настройка уровня общего доступа для контейнера больших двоичных объектов

Проверка уровня доступа к контейнеру

  1. Откройте обозреватель службы хранилища Azure. В окне обозревателя разверните подписку Azure, если она еще не развернута.

  2. Разверните аккаунты хранилища> {ваш аккаунт хранилища} >контейнеры BLOB. Выберите свой контейнер BLOB.

  3. В контекстном меню контейнера больших двоичных объектов выберите Set Public Access Level (Настроить уровень общего доступа).

Загрузка данных в контейнеры с общим доступом

  1. Загрузите схему в аккаунт хранения. В правом окне нажмите кнопку "Отправить".

  2. После завершения отправки выберите отправленную схему. На панели инструментов выберите "Копировать URL-адрес ", чтобы скопировать URL-адрес схемы.

  3. Вернитесь на портал Azure, где открыта область добавления схемы . Введите имя сборки. Выберите Большой файл (более 2 МБ).

    Появится поле URI содержимого , а не поле схемы .

  4. В поле URI содержимого вставьте URL-адрес схемы. Завершите добавление схемы.

После завершения отправки схемы схема появится в списке схем . На странице обзора учетной записи интеграции в разделе Артефакты появится загруженная схема.

Загрузка в контейнеры без публичного доступа

  1. Загрузите схему в аккаунт хранения. В правом окне нажмите кнопку "Отправить".

  2. После завершения отправки создайте подписанный URL-адрес (SAS) для схемы. В контекстном меню схемы выберите "Получить разделенный ключ доступа".

  3. В области Подписи общего доступа выберите Сгенерировать URI для общего доступа на уровне контейнера>, затем нажмите Создать. После создания URL-адреса SAS рядом с полем URL-адреса нажмите кнопку "Копировать".

  4. Вернитесь на портал Azure, где открыта область добавления схемы . Выберите большой файл.

    Появится поле URI содержимого , а не поле схемы .

  5. В поле URI содержимого вставьте URI SAS, созданный ранее. Завершите добавление схемы.

После завершения отправки схемы схема появится в списке схем . На странице обзора учетной записи интеграции в разделе Артефакты появится загруженная схема.

Изменение схемы

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

  1. На портале Azure откройте свою учетную запись интеграции, если она еще не открыта.

  2. В меню учетной записи интеграции в разделе "Параметры" выберите "Схемы".

  3. После открытия области "Схемы" выберите схему. Чтобы сначала скачать и изменить схему, на панели инструментов панели "Схемы " выберите "Скачать" и сохраните схему.

  4. Когда вы будете готовы отправить обновленную схему, на панели "Схемы " выберите схему, которую требуется обновить. На панели инструментов панели "Схемы" нажмите кнопку "Обновить".

  5. Найдите и выберите обновленную схему, которую вы хотите отправить.

  6. По завершении нажмите кнопку ОК.

    После завершения отправки файла схемы обновленная схема появится в списке схем .

Удаление схемы

  1. На портале Azure откройте свою учетную запись интеграции, если она еще не открыта.

  2. В меню ресурсов учетной записи интеграции в разделе "Параметры" выберите "Схемы".

  3. После открытия области "Схемы" выберите схему и нажмите кнопку "Удалить".

  4. Чтобы подтвердить удаление схемы, нажмите кнопку "Да".