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

适用范围：Azure 逻辑应用（消耗型 + 标准型）

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

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

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

先决条件

• Azure 帐户和订阅。 如果还没有订阅，请注册 Azure 帐户。

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

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

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

  • Visual Studio 2015 和适用于 Visual Studio 2015 的 Azure 逻辑应用企业集成工具 2.0 扩展。

    备注

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

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

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

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

  重要

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

  • 如果使用消耗型逻辑应用工作流，则需要链接到逻辑应用资源的集成帐户。

  • 如果使用标准型逻辑应用工作流，则可以根据以下情况将集成帐户链接到逻辑应用资源并且/或者直接将映射上传到逻辑应用资源：

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

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

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

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

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

  • 必须按特定的顺序将程序集和映射上传到集成帐户。 请务必先上传程序集，然后再上传引用程序集的映射。

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

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

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

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

限制

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

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

  • 标准型工作流

    • 支持 XSLT 1.0、2.0 和 3.0。

    • 映射文件大小不存在限制。

  • 消耗型工作流

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

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

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

创建映射

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

Visual Studio Code

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

Visual Studio

使用 Visual Studio 创建映射时，需要使用以下工具之一创建集成项目：

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

• Visual Studio 2015 和适用于 Visual Studio 2015 的 Azure 逻辑应用企业集成工具 2.0 扩展。

在集成项目中，可以生成用于直观地在两个 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”。

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

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

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

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

添加 2 MB 以上的映射

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

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

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

Azure 门户

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

2. 在“映射”窗格工具栏中选择“添加” 。

3. 在“添加映射”窗格中，输入地图的唯一名称，并包括 .xslt 扩展名。

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

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

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

Visual Studio Code

1. 在逻辑应用项目的结构中打开“项目”文件夹，然后打开“映射”文件夹 。

2. 在“映射”文件夹中添加映射。

编辑映射

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

删除映射

后续步骤

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