添加映射以使用 Azure 逻辑应用在工作流中进行转换

适用于：Azure 逻辑应用（消耗 + 标准）

“转换 XML”和“Liquid”等工作流操作需要映射才能执行其任务。 例如，“转换 XML”操作需要映射才能在格式之间转换 XML。 映射是一个 XML 文档，描述如何将数据从 XML 转换为另一种格式。 映射内容包含源 XML 架构作为输入，目标 XML 架构作为输出。 你可以定义一个基本转换，例如，将名称和地址从一个文档复制到另一个文档。 或者，可以使用现成可用的映射操作创建更复杂的转换。 可以使用不同的内置函数来操作或控制数据，如字符串操作、条件分配、算术表达式、日期时间格式化程序甚至是循环构造。

例如，假设你从使用 YearMonthDay 日期格式 (YYYYMMDD) 的客户定期接收 B2B 订单或发票。 但是，你的组织使用 MonthDayYear 日期格式 (MMDDYYYY)。 在将订单或发票详细信息存储在客户活动数据库中之前，可以定义并使用一个映射，以便将 YYYYMMDD 格式转换为 MMDDYYYY 格式。

本指南演示如何为工作流添加要使用的映射。 可以将映射添加到链接集成帐户，或者如果你有标准逻辑应用，则可以直接将映射添加到逻辑应用资源。

Prerequisites

• Azure 帐户和订阅。 如果没有订阅，可以注册免费的 Azure 帐户。

• 要上传的地图。

  • 消耗工作流支持以下映射类型： Liquid、 XSLT、 XSLT 2.0、 XSLT 3.0 或 HIDX。

  • 标准工作流支持以下映射类型： XSLT、 XSLT 2.0 和 XSLT 3.0。

  • 要创建映射，可以使用以下任何工具：

    • Visual Studio Code 和数据映射器扩展。 若要从工作流调用使用数据映射器创建的映射，必须使用名为“使用数据映射器 XSLT 进行转换”的“数据映射器操作”操作，而不是名为“转换 XML”的“XML 操作”操作。 有关详细信息，请参阅使用 Visual Studio Code 为数据转换创建映射。

    • Visual Studio 2019 和 Microsoft Azure 逻辑应用企业集成工具扩展。

      注意

      不要将 Microsoft Azure 逻辑应用企业集成工具扩展与 BizTalk Server 扩展一起安装。 同时具有这两个扩展可能会导致意外行为。 请确保只安装其中一个扩展。

      在高分辨率监视器上，可能会在 Visual Studio 中遇到地图设计器显示问题。 要解决此显示问题，请在 DPI 无感知模式下重启 Visual Studio 或添加 DPIUNAWARE 注册表值。

      有关详细信息，请查看本文中的创建映射部分。

• 你需要集成帐户资源，具体取决于你使用的是消耗型还是标准型逻辑应用工作流。 通常，当你想要定义和存储项目以将其用于企业集成和 B2B 工作流时，你需要此资源。

  重要说明

  若要协同工作，集成帐户和逻辑应用资源必须存在于同一 Azure 订阅和 Azure 区域中。

  • 对于消耗逻辑应用工作流，需有一个链接到逻辑应用资源的集成帐户。

  • 对于标准逻辑应用工作流，可以根据以下情况将集成帐户与逻辑应用资源相连，直接上传映射到逻辑应用资源，或者同时进行：

    • 如果你已经有一个包含所需项目或要使用的项目的集成帐户，可以将该集成帐户链接到要在其中使用项目的多个标准型逻辑应用资源。 这样，就不必将映射上传到每个单独的逻辑应用。 有关详细信息，请查看将逻辑应用资源链接到集成帐户。

    • 通过 Liquid 内置连接器，可选择以前上传到逻辑应用资源或链接集成帐户的映射，但不能同时上传到这两者。

    因此，如果你没有集成帐户，或者你不需要集成帐户，可以使用上传选项。 否则，可以使用链接选项。 采用上述任一方式，都可以在同一逻辑应用资源中跨所有子工作流使用这些项目。

• 消费和标准工作流支持引用外部程序集的映射，使得可以直接从映射调用自定义的 .NET 代码。 为了支持此功能，消耗工作流还具有以下要求：

  • 需要一个 64 位程序集。 转换服务运行 64 位进程，因此不支持 32 位程序集。 如果有 32 位程序集的源代码，请将此代码重新编译为 64 位程序集。 如果没有源代码，但从另一个提供程序获取了二进制文件，请从该提供程序获取 64 位版本。 例如，某些供应商在包中提供有 32 位和 64 位版本的程序集。 如果可以选择，请改用 64 位版本。

  • 必须按特定的顺序将程序集和映射上传到集成帐户。 请确保先上传您的程序集，然后上传引用该程序集的地图。

  • 如果程序集或映射为 2 MB 或更小，你可以直接从 Azure 门户将程序集和映射添加到集成帐户。

  • 如果程序集大于 2 MB 但不超过程序集大小限制，则需要可上传程序集的 Azure 存储帐户和 Blob 容器。 稍后，在将程序集添加到集成帐户时，可以提供该容器的位置。 对于此任务，下表描述了所需的项：

    Item	说明
    Azure 存储帐户	在此帐户中创建程序集的 Azure Blob 容器。 了解如何创建存储帐户。
    Blob 容器	可在此容器中上传程序集。 将程序集添加到集成帐户时，也需要此容器的内容 URI 位置。 了解如何创建 Blob 容器。
    Azure 存储浏览器	借助此工具可以更轻松地管理存储帐户和 Blob 容器。 若要使用存储资源管理器， 请下载并本地安装 Azure 存储资源管理器。 然后，遵循存储资源管理器入门中的步骤将存储资源管理器连接到存储帐户。 有关详细信息，请参阅 快速入门：使用 Azure 存储资源管理器在对象存储中创建 Blob。

    若要添加较大的映射，可以使用 Azure 逻辑应用 REST API - 映射。 对于标准型工作流，Azure 逻辑应用 REST API 目前不可用。

限制

• 限制适用于每个集成帐户的项目数，例如映射。 有关详细信息，请查看 Azure 逻辑应用的限制和配置信息。

• 根据你使用的是消耗型还是标准型逻辑应用工作流，适用以下限制：

  • 消耗型工作流

    • Azure 逻辑应用会分配有限的内存来处理 XML 转换。 如果创建消耗型工作流，并且映射或有效负载转换的内存消耗较高，则此类转换可能会失败，从而导致内存不足错误。 若要避免这种情况，请考虑以下选项：

      • 编辑映射或有效负载以减少内存消耗。

      • 创建标准逻辑应用工作流，这些工作流在单租户 Azure 逻辑应用中运行，可为计算和内存资源提供专用且灵活的选项。

  • 标准工作流支持的映射类型比消耗工作流少，但映射文件大小没有限制。 有关详细信息，请参阅先决条件。

创建映射

可以使用具有数据映射器扩展的 Visual Studio Code 或具有 Microsoft Azure 逻辑应用企业集成工具扩展的 Visual Studio 来创建映射。

Visual Studio Code

使用 Visual Studio Code 和数据映射器扩展创建映射时，可以从工作流调用这些映射，但只能使用名为“使用数据映射器 XSLT 进行转换”的“数据映射器操作”操作，而不是名为“转换 XML”的“XML 操作”操作。 有关详细信息，请参阅使用 Visual Studio Code 为数据转换创建映射。

Visual Studio

如果使用 Visual Studio 创建地图，则需要使用 Visual Studio 2019 和 Microsoft Azure 逻辑应用企业集成工具扩展创建集成项目。

在集成项目中，可以生成用于直观地在两个 XML 架构文件之间映射项的集成映射文件。 这些工具提供以下映射功能：

• 可以使用映射的图形表示形式，其中会显示创建的所有关系和链接。

• 你可以在用于创建映射的 XML 架构之间直接进行数据复制。 Visual Studio 的企业集成 SDK 包含一个映射器，它能够使此任务变得非常简单，就如同绘制一条线将源 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>

添加引用的程序集

添加映射

• 如果使用的是消耗型工作流，则必须将映射添加到链接集成帐户。

• 如果使用的是标准型工作流，则有以下选项：

  • 将映射添加到链接集成帐户。 可以在多个标准型逻辑应用资源及其子工作流之间共享映射和集成帐户。

  • 将映射直接添加到逻辑应用资源。 但是，只能在同一逻辑应用资源中的子工作流之间共享该映射。

将映射添加到集成帐户

1. 在 Azure 门户中，使用 Azure 帐户凭据登录。

2. 在 Azure 门户搜索框中，输入“集成帐户”，然后选择“集成帐户”。

3. 查找并选择你的集成帐户。

4. 在集成帐户菜单的设置下，选择映射。

5. 在 “地图 ”页面工具栏上，选择“ 添加”。

对于消耗型工作流，根据映射的文件大小，现在按照相应的步骤上传不超过 2 MB 或大于 2 MB 的映射。

添加不超过 2 MB 的映射

1. 在“添加映射”窗格中，输入映射的唯一名称。

2. 在 “映射类型”下，选择类型，例如： Liquid、 XSLT、 XSLT 2.0、 XSLT 3.0 或 HIDX。

3. 选择“映射”框旁边的文件夹图标。 选择要上传的映射，然后选择“ 打开”。

   如果将“名称”属性留空，则选择映射文件后，映射的文件名将自动显示在该属性中。

4. 完成后，请选择“确定”。

   完成映射文件上传后，该映射将显示在“映射”列表中。 如果未显示地图，请在 “地图” 工具栏上选择“ 刷新”。 在你的集成帐户概述页面的项目下，你上传的映射也会显示。

添加 2 MB 以上的映射

若要为消耗型工作流添加更大的映射，请使用 Azure 逻辑应用 REST API - 映射。

将映射添加到标准型逻辑应用资源

仅当想要将映射直接添加到标准型逻辑应用资源时，以下步骤才适用。 否则，请将映射添加到集成帐户。

Azure 门户

1. 在逻辑应用菜单中的“项目”下，选择“映射”。

2. 在 “地图 ”页面工具栏上，选择“ 添加”。

3. 在 “添加映射 ”窗格中，输入地图的唯一名称，并包括文件扩展名，例如 .xslt、 .hidx 或 .liquid。

4. 选择“映射”框旁边的文件夹图标。 选择要上传的映射。

5. 完成后，请选择“确定”。

   完成映射文件上传后，该映射将显示在“映射”列表中。 在集成帐户“概述”页的“项目”下，也会显示上传的映射。

Visual Studio Code

1. 在计算机上，转到项目的 本地 文件夹，然后展开以下文件夹： Artifacts>Maps。

2. 在 “地图” 文件夹中，添加地图文件。

3. 返回到 Visual Studio Code。

   地图文件现在显示在项目中，例如：

   

编辑映射

若要更新现有的映射，必须上传一个新的映射文件，其中包含所要做出的更改。 但是，可以先下载现有的映射进行编辑。

删除映射

相关内容

• 在 Azure 逻辑应用中转换工作流的 XML
• 在 Azure 逻辑应用中验证工作流的 XML