Добавьте карты для преобразований в рабочих процессах с Azure Logic Apps.

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

Действия рабочих процессов, такие как преобразование XML и Liquid, требуют сопоставления для выполнения своих задач. Например, действие Преобразование XML требует карты для конвертации XML между форматами. Карта — это XML-документ, описывающий преобразование данных из XML в другой формат. Содержимое карты содержит исходную XML-схему в качестве входных данных и целевую XML-схему в качестве выходных данных. Вы можете задать простое преобразование, например, копирование имени и адреса из одного документа в другой. Но вы также можете создавать и более сложные преобразования с помощью операций сопоставления, предоставляемых изначально. Вы можете использовать разные встроенные функции, помогающие работать с данными и управлять ими, включая действия со строками, условные назначения, арифметические выражения, модули форматирования даты и времени и даже циклические конструкции.

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

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

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

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

• Карта, которую вы хотите отправить.

  • Процессы потребления поддерживают следующие типы карт: Liquid, XSLT, XSLT 2.0, XSLT 3.0 или HIDX.

  • Стандартные рабочие процессы поддерживают следующие типы карт: XSLT, XSLT 2.0 и XSLT 3.0.

  • Для создания карт можно использовать любой из следующих средств:

    • Visual Studio Code и расширение Data Mapper. Чтобы вызвать карты, созданные с помощью Data Mapper из рабочего процесса, необходимо использовать действие "Операции сопоставления данных", названное "Преобразование с помощью Data Mapper XSLT", а не действие "XML Операции" с именем "Transform XML". Дополнительные сведения см. в статье "Создание карт для преобразования данных с помощью Visual Studio Code".

    • Visual Studio 2019 и расширение Средств интеграции Microsoft Azure Logic Apps Enterprise.

      Примечание.

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

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

      Дополнительные сведения см. в разделе Создание сопоставлений в этой статье.

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

  Внимание

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

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

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

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

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

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

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

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

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

  • Если ваша сборка или сопоставление имеет размер 2 МБ или меньше, вы можете добавить свою сборку и сопоставление в учетную запись интеграции непосредственно на портале Azure.

  • Если сборка больше 2 МБ, но не больше чем ограничение размера для сборок, вам потребуется учетная запись хранения Azure и контейнер BLOB-объектов для отправки в него сборки. Вы сможете указать расположение контейнера позже — при добавлении сборки в учетную запись интеграции. Для этой задачи в следующей таблице описаны необходимые элементы:

    Элемент	Описание
    Учетная запись хранения Azure	В этом аккаунте создайте контейнер Blob Azure для вашего проекта. Узнайте, как создать учетную запись хранения.
    Контейнер блоб-объектов	В этот контейнер можно загрузить сборку. Вам также понадобится расположение URI содержимого этого контейнера при добавлении сборки в учетную запись интеграции. Узнайте, как создать контейнер объектов blob.
    Обозреватель службы хранилища Azure	Это средство упрощает управление учетными записями хранения и BLOB-контейнерами. Чтобы использовать обозреватель службы хранилища, скачайте и локально установите обозреватель службы хранилища Azure. Затем подключите Обозреватель службы хранилища к учетной записи хранения, следуя шагам из статьи Начало работы с Обозревателем службы хранилища. Дополнительные сведения см. в кратком руководстве по созданию большого двоичного объекта в хранилище объектов с помощью обозревателя службы хранилища Azure.

    Для добавления больших карт используйте REST API Azure Logic Apps – Карты. Для рабочих процессов уровня "Стандартный" интерфейс REST API Azure Logic Apps в настоящее время недоступен.

Ограничения

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

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

  • Рабочие процессы потребления

    • Azure Logic Apps выделяет ограниченный объем памяти для обработки преобразований XML. Если вы создаете рабочие процессы с использованием уровня "Потребление", и преобразования карты или полезной нагрузки имеют высокий уровень потребления памяти, такие преобразования могут закончиться сбоем, вызванным ошибками из-за нехватки памяти. Чтобы избежать этого, рассмотрите описанные ниже варианты.

      • Измените карты или нагрузки, чтобы уменьшить потребление памяти.

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

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

Создание карт

Вы можете создавать карты с помощью Visual Studio Code с расширением Data Mapper или Visual Studio с расширением Microsoft Azure Logic Apps Enterprise Integration Tools.

Visual Studio Code

При создании карт с помощью Visual Studio Code и расширения "Сопоставление данных" эти карты можно вызывать из рабочего процесса, но только с операцией "Операции сопоставления данных" с именем "Преобразование с помощью средства сопоставления данных XSLT", а не с операцией "XML Operations" с именем "Преобразование XML". Дополнительные сведения см. в статье "Создание карт для преобразования данных с помощью Visual Studio Code".

Visual Studio

Если вы создаете карты с Помощью Visual Studio, вам потребуется создать проект интеграции с Visual Studio 2019 и расширением Microsoft Azure Logic Apps Enterprise Integration Tools.

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

• Вы работаете с графическим представлением карты, которое показывает все создаваемые вами отношения и связи.

• Можно создать прямую копию данных между схемами XML, которые используются для создания карты. Пакет SDK для корпоративной интеграции для Visual Studio включает средство сопоставления, которое делает эту задачу такой же простой, как рисование линии, соединяющей элементы исходной схемы XML с их аналогами в целевой схеме XML.

• Доступны операции или функции для нескольких карт, включая строковые функции, функции даты, времени и т. д.

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

• После создания этого проекта вы получите XSLT-документ.

Ваша карта должна иметь следующие атрибуты и раздел CDATA, содержащий вызов ассемблерного кода.

• name — имя пользовательской сборки.

• namespace — это пространство имен в вашей сборке, которое включает настраиваемый код.

В следующем примере показана карта, которая ссылается на сборку с именем XslUtilitiesLib и вызывает circumference метод из сборки.

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
<msxsl:script language="C#" implements-prefix="user">
    <msxsl:assembly name="XsltHelperLib"/>
    <msxsl:using namespace="XsltHelpers"/>
    <![CDATA[public double circumference(int radius){ XsltHelper helper = new XsltHelper(); return helper.circumference(radius); }]]>
</msxsl:script>
<xsl:template match="data">
<circles>
    <xsl:for-each select="circle">
        <circle>
            <xsl:copy-of select="node()"/>
                <circumference>
                    <xsl:value-of select="user:circumference(radius)"/>
                </circumference>
        </circle>
    </xsl:for-each>
</circles>
</xsl:template>
</xsl:stylesheet>

Добавление сборок, на которые делаются ссылки

Добавление карт

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

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

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

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

Добавить карту в учетную запись интеграции

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

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

3. Найдите и выберите учетную запись интеграции.

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

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

Для рабочих процессов уровня «Потребление» выполните действия по загрузке карты в зависимости от ее размера: до 2 МБ или более 2 МБ.

Добавление карт размером до 2 МБ

1. В области Добавление карты введите уникальное имя карты.

2. В разделе Тип карты выберите тип, например, Liquid, XSLT, XSLT 2.0, XSLT 3.0 или HIDX.

3. Выберите значок папки рядом с полем Карта. Выберите карту для отправки и нажмите кнопку "Открыть".

   Если оставить свойство Имя пустым, имя файла карты автоматически появится в этом свойстве после выбора файла карты.

4. По завершении нажмите кнопку OK.

   Когда файл карты будет отправлен, карта появится в списке Карты. Если карта не отображается, на панели инструментов "Карты " нажмите кнопку "Обновить". На странице обзора учетной записи интеграции в разделе "Артефакты" также появится отправленная карта.

Добавление карт размером более 2 МБ

Чтобы добавить более крупные сопоставления для рабочих процессов уровня "Потребление", используйте REST API Azure Logic Apps для сопоставлений.

Добавить карту в ресурс логического приложения уровня Стандартных

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

Портал Azure

1. В меню приложения логики в разделе "Артефакты" выберите "Карты".

2. На панели инструментов страницы "Карты" нажмите кнопку "Добавить".

3. В области добавления карты введите уникальное имя карты и добавьте расширение файла, например XSLT, HIDX или .liquid.

4. Выберите значок папки рядом с полем Карта. Выберите карту для отправки.

5. По завершении нажмите кнопку OK.

   Когда файл карты будет отправлен, карта появится в списке Карты. Отправленная карта также появится на странице Обзор учетной записи интеграции в разделе Артефакты.

Visual Studio Code

1. На компьютере перейдите в папку проекта Local и разверните следующие папки: Artifacts>Maps.

2. В папке Maps добавьте файл карты.

3. Вернитесь в Visual Studio Code.

   Файл карты теперь отображается в проекте, например:

   

Изменение карты

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

Удаление карты

Связанный контент

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