图形映射概述

图形数据映射 提供了无需编写代码即可实现消息变换的功能。 您可以使用 消息映射，子映射或本地映射。 要定义映射的输入和输出消息，您可以使用 XML、JSON 或 DFDL 模式消息模型，其定义数据结构并提供有关数据类型的信息，您也可以通过使用添加用户定义函数，在映射中对其进行动态定义。

消息映射

消息映射是 IBM® App Connect Enterprise 中图形化数据映射的实现。 它基于 XML 模式和 XPath 2.0 标准，具有对 JSON 模式草稿 4 和 Swagger 2.0 的额外支持。

消息映射 提供了实现消息变换的能力，而无需编写代码。 它提供了消息变换的可视图像，并简化了其实现以及持续进行的维护。

您可以使用 消息映射 以图形方式变换，路由和增补消息。 您可以使用 消息映射 来修改数据库系统中的数据。 可以在不进行编程的情况下，使用拖动操作来建立连接、选择变换以及构建用于对消息数据进行变换的逻辑。

有关更多信息，请参阅 消息映射。

定义映射输入和输出

要启用图形变换，必须提供数据的模型，以便 图形数据映射编辑器 可以显示该模型。 您可以使用 XML、JSON 或 DFDL 模式消息模型，也可以使用添加用户定义函数，在映射中动态定义模型。 同时还为 SOAP 和 BLOB 消息类型提供了预定义模型。 您还可以转换来自 IBM App Connect Enterprise 消息集合其他部分的数据，包括“属性”文件夹、环境、本地环境以及传输头（如 HTTP 或MQMD）。

有关更多信息，请参阅 消息映射。

子映射

子映射 是 消息映射的可复用格式。

使用子映射来复用公共数据变换。 在子元素中定义用于将一组元素从输入对象变换为输出对象的映射函数。

您可以在支持 图形数据映射的其他产品中复用子映射。

注: 如果计划在不同产品之间复用数据转换，请阅读 开发可复用图形数据映射资产的准则。

有关更多信息，请参阅 子图。

局部映射

局部映射 是属于 消息映射的输入元素和输出元素之间的数据变换子集。 通过在 消息映射中创建 本地映射 变换来定义本地映射。

局部映射不是一项独立的资源。 没有与局部映射关联的物理文件。

本地映射的作用域是 消息映射。 使用 消息映射处理本地映射。

本地映射提供了一种将大型 消息映射 拆分为映射元素的嵌套组的方法。

您可以使用局部映射来简化整体 消息映射 表示。 可以将复杂的数据变换构造成更容易管理和实现的嵌套组。

有关更多信息，请参阅 本地映射。

旧消息映射

旧消息映射 是在较低版本的 WebSphere® Message Broker (例如，在 WebSphere Message Broker V 7中) 中创建为 .msgmap 文件的 消息映射 。

IBM App Connect Enterprise 使用 WebSphere Message Broker 第8版中引入的图形数据地图格式 .map 。 这些 消息映射 替换 .msgmap 格式的先前 消息映射 。

在 IBM App Connect Enterprise 中使用旧版消息映射之前，必须将其转换为消息映射 ，具体方法请参阅 “使用或将旧版资源转换为消息映射”。

选择 图形数据映射 的类型

使用下表来标识在 " 图形数据映射编辑器" 中以图形方式变换数据时必须创建的映射类型:

表 1. 基于设计需求的映射类型
  建议使用 资源类型 IBM App Connect Enterprise 支持此功能
消息映射 图形数据映射 .map 文件 是
子映射（请参阅以下注释。） 复用公共数据变换 .map 文件 是
局部映射 在读取和管理 消息映射 时降低复杂性 无文件。 它嵌入在 消息映射 中 是
旧消息映射 重复使用在早期版本的 IBM App Connect Enterprise 中开发的地图 .msgmap 文件 这些文件必须先转换为 .map 文件，才能在 IBM App Connect Enterprise 中使用。 （请参阅以下注释。）
注：
  1. 旧版消息映射必须先转换为 .map 消息映射格式， IBM App Connect Enterprise 才能对其进行部署或修改。
  2. 不支持将子映射用于 JSON 模式模型。
注：

编辑 图形数据映射

您可以在 "图形数据映射" 编辑器中编辑 消息映射 或子映射。

图形数据映射编辑器 将 消息映射 保存为 .map 文件。

有关更多信息，请参阅 图形数据映射编辑器 和 编辑消息映射。

映射操作

您可以在 " 图形数据映射编辑器" 中使用变换以图形方式映射数据。

有关更多信息，请参阅 变换 (映射操作)。

XPath

在 " 图形数据映射编辑器" 中，可以通过以下任何方式使用 XPath 函数:
  • 您可以定义 XPath 函数，以使用内置 XPath 变换来变换数据。 有关更多信息，请参阅 内置 XPath 变换。
  • 您可以使用定制 XPath 变换来定义对多个 XPath 函数进行组合的复杂 XPath 表达式，以变换数据。 有关更多信息，请参阅 定制 XPath。
  • 您可以定义 XPath 表达式，以便对变换设置条件或者对重复元素中的元素进行过滤。 有关更多信息，请参阅 定义变换的 XPath 条件表达式。
  • 在指定 XPath 函数的参数时，可以采用直接插入方式来使用 XPath。 有关更多信息，请参阅 内置 XPath 变换。

IBM App Connect Enterprise 的内置函数

您可以使用 IBM App Connect Enterprise 的内置函数来检索 Integration Bus 数据，并进行数据类型转换和格式化。 iib: 函数通过 定制 XPath 变换中的内容辅助提供。 有关更多信息，请参阅 "图形数据映射" 编辑器中的变换类型