使用带有 Enterprise Integration Pack 的 Azure 逻辑应用中的映射转换 XML

若要在 Azure 逻辑应用中的企业集成方案格式之间传输 XML 数据,逻辑应用可以使用映射,或者更具体地说,使用可扩展样式表语言转换 (XSLT) 映射。 映射是一个 XML 文档,描述如何将 XML 文档中的数据转换为另一种格式。

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

有关集成帐户和映射等项目的限制,请参阅 Azure 逻辑应用的限制和配置信息

先决条件

创建和添加映射时不需要逻辑应用。 但是,若要使用映射,逻辑应用需要链接到存储该映射的集成帐户。 了解如何将逻辑应用链接到集成帐户。 如果没有逻辑应用,请了解如何创建逻辑应用

添加引用的程序集

  1. 使用 Azure 帐户凭据登录到 Azure 门户

  2. 若要查找并打开集成帐户,请在 Azure 主菜单中选择“所有服务”。
    在搜索框中,输入“集成帐户”。 选择“集成帐户”。

    查找集成帐户

  3. 选择要将程序集添加到的集成帐户,例如:

    选择“集成帐户”

  4. 在集成帐户的“概述”页上的“组件”下,选择“程序集”磁贴 。

    选择“程序集”

  5. “程序集”页打开后,请选择“添加”。

    此屏幕截图突出显示了“程序集”页上的“添加”按钮。

根据程序集文件的大小,遵循相应的步骤来上传不超过 2 MB大于 2 MB 但不超过 8 MB 的程序集。 有关集成帐户中程序集数量的限制,请参阅 Azure 逻辑应用的限制和配置

备注

如果更改程序集,则无论映射是否有更改,都必须更新映射。

添加不超过 2 MB 的程序集

  1. 在“添加程序集”下,输入程序集的名称。 将“小文件”保持选定状态。 选择“程序集”框旁边的文件夹图标。 找到并选择要上传的程序集,例如:

    上传小型程序集

    选择程序集后,该程序集的文件名会自动显示在“程序集名称”属性中。

  2. 准备就绪后,选择“确定” 。

    完成程序集文件上传后,该程序集将显示在“程序集”列表中。

    加载的程序集列表

    在集成帐户的“概述”页上的“组件”下,“程序集”磁贴现在会显示已上传的程序集数目,例如 :

    上传的程序集数目

添加 2 MB 以上的程序集

若要添加更大的程序集,可将程序集上传到 Azure 存储帐户中的 Azure Blob 容器。 添加程序集的步骤因 Blob 容器是否具有公共读取访问权限而异。 因此,首先请执行以下步骤检查 Blob 容器是否具有公共读取访问权限:为 Blob 容器设置公共访问级别

检查容器访问级别

  1. 打开 Azure 存储资源管理器。 在“资源管理器”窗口中展开你的 Azure 订阅(如果尚未展开)。

  2. 展开“存储帐户”>“{你的存储帐户}”>“Blob 容器”。 选择你的 Blob 容器。

  3. 在 Blob 容器的快捷菜单中,选择“设置公共访问级别”。

上传到具有公共访问权限的容器

  1. 将程序集上传到存储帐户。 在右侧窗口中,选择“上传”。

  2. 完成上传后,选择上传的程序集。 在工具栏中,选择“复制 URL”以复制程序集的 URL。

  3. 返回 Azure 门户,其中已打开“添加程序集”窗格。
    输入程序集的名称。 选择“大文件(大于 2 MB)”。

    此时会显示“内容 URI”框而不是“程序集”框。

  4. 在“内容 URI”框中,粘贴程序集的 URL。
    完成添加程序集。

完成程序集上传后,架构将显示在“程序集”列表中。 在集成帐户的“概述”页上的“组件”下,“程序集”磁贴现在会显示已上传的程序集数目。

上传到没有公共访问权限的容器

  1. 将程序集上传到存储帐户。 在右侧窗口中,选择“上传”。

  2. 上传完成后,为程序集生成共享访问签名 (SAS)。 在程序集的快捷菜单中,选择“获取共享访问签名”。

  3. 在“共享访问签名”窗格中,选择“生成容器级共享访问签名 URI” > “创建”。
    生成 SAS URL 后,选择“URL”框旁边的“复制”。

  4. 返回 Azure 门户,其中已打开“添加程序集”窗格。
    输入程序集的名称。 选择“大文件(大于 2 MB)”。

    此时会显示“内容 URI”框而不是“程序集”框。

  5. 在“内容 URI”框中,粘贴前面生成的 SAS URI。 完成添加程序集。

完成程序集上传后,该程序集将显示在“架构”列表中。 在集成帐户的“概述”页上的“组件”下,“程序集”磁贴现在会显示已上传的程序集数目。

创建映射

若要创建可用作映射的 XSLT 文档,可以在 Visual Studio 2015 中使用 Enterprise Integration Pack 创建 BizTalk 集成项目。 在此项目中,可以生成用于直观地在两个 XML 架构文件之间映射项的集成映射文件。 生成此项目后,会获得一个 XSLT 文档。 有关集成帐户中映射数量的限制,请参阅 Azure 逻辑应用的限制和配置

添加映射

上传映射引用的所有程序集之后,接下来可以上传映射。

  1. 如果尚未登录,请使用 Azure 帐户凭据登录到 Azure 门户

  2. 如果你的集成帐户尚未打开,请在 Azure 主菜单中选择“所有服务”。
    在搜索框中,输入“集成帐户”。 选择“集成帐户”。

    查找集成帐户

  3. 选择要将映射添加到的集成帐户,例如:

    选择“集成帐户”

  4. 在集成帐户的“概述”页上的“组件”下,选择“映射”磁贴。

    选择“映射”

  5. “映射”页打开后,请选择“添加” 。

    选择“添加”

添加不超过 2 MB 的映射

  1. 在“添加映射”下,输入映射的名称。

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

  3. 将“小文件”保持选定状态。 选择“映射”框旁边的文件夹图标。 找到并选择要上传的映射,例如:

    上传映射

    如果将“名称”属性留空,则选择映射文件后,映射的文件名将自动显示在该属性中。
    但是,可以使用任何唯一名称。

  4. 准备就绪后,选择“确定” 。 完成映射文件上传后,该映射将显示在“映射”列表中。

    上传的映射列表

    在集成帐户的“概述”页上的“组件”下,“映射”磁贴现在会显示已上传的映射数目,例如:

    上传的映射数目

添加 2 MB 以上的映射

目前,若要添加较大的映射,需要使用 Azure 逻辑应用 REST API - 映射

编辑映射

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

  1. Azure 门户中,找到并打开你的集成帐户(如果尚未打开)。

  2. 在 Azure 主菜单中,选择“所有服务” 。 在搜索框中,输入“集成帐户”。 选择“集成帐户”。

  3. 选择要在其中更新映射的集成帐户。

  4. 在集成帐户的“概述”页上的“组件”下,选择“映射”磁贴。

  5. “映射”页打开后,请选择你的映射。
    若要先下载并编辑映射,请选择“下载”,然后保存映射。

  6. 准备好上传更新的映射时,请在“映射”页上选择要更新的映射,然后选择“更新”。

  7. 找到并选择要上传的已更新映射。 完成映射文件上传后,更新的映射将显示在“映射”列表中。

删除映射

  1. Azure 门户中,找到并打开你的集成帐户(如果尚未打开)。

  2. 在 Azure 主菜单中,选择“所有服务” 。 在搜索框中,输入“集成帐户”。 选择“集成帐户”。

  3. 选择要在其中删除映射的集成帐户。

  4. 在集成帐户的“概述”页上的“组件”下,选择“映射”磁贴。

  5. “映射”页打开后,请选择你的映射,然后选择“删除”。

  6. 若要确认删除该映射,请选择“是”。

后续步骤