查看 Application Integration 支持的连接器。

数据映射任务

通过数据映射任务，您可以在集成中执行变量分配、获取和设置 json 对象的属性以及将嵌套转换函数应用于值。变量可以是集成变量或任务变量。

例如，您可以将集成变量 X 的值分配给任务变量 Y，或将任务变量 Y 的数据值分配给集成变量 X。如需详细了解 Application Integration 中的变量，请参阅在 Application Integration 中使用变量。

配置数据映射任务

如需配置数据映射任务，请执行以下步骤：

1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

   转到 Application Integration

2. 在导航菜单中，点击集成。

   系统会显示集成页面，其中列出了 Google Cloud 项目中可用的所有集成。

3. 选择现有集成，或点击创建集成以创建新的集成。

   要创建新的集成，请执行以下操作：

   1. 在创建集成窗格中输入名称和说明。
   2. 选择集成的区域。
      注意：区域下拉列表仅列出您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
   3. 选择用于集成的服务账号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务账号详细信息。
      注意：仅当您为所选区域启用了集成治理后，系统才会显示用于选择服务账号的选项。
   4. 点击创建。

   系统随即会在集成编辑器中打开该集成。

4. 在集成编辑器导航栏中，点击任务查看可用任务和连接器的列表。
5. 点击数据映射元素，并将其放置到集成编辑器中。
6. 点击设计器上的数据映射元素以查看数据映射任务配置窗格。
7. 点击打开数据映射编辑器以查看任务的默认值并添加新映射。如需了解添加映射的详细步骤，请参阅添加映射。

   如需详细了解数据映射编辑器布局，请参阅数据映射概览。

添加映射

如需添加映射，请执行以下步骤：

1. 在数据映射任务配置窗格中，点击打开数据映射编辑器。
2. 配置映射输入：
   输入：数据映射输入的来源。源可以是映射函数的字面量值、基本函数或输入变量。
   1. 将变量或其子字段从变量列表拖动到“输入”行中。如需查看变量的可用子字段，请在变量列表中点击相应变量旁边的 （展开）。
   2. 或者，在“输入”行中，点击变量或值并执行以下操作：
      • 选择变量以搜索和使用现有变量。如需创建新变量，请点击 + 添加新变量，然后输入新变量的名称和数据类型。
      • 选择值，输入 string、integer、double 或 Boolean 类型的字面量值。
      • 选择函数以搜索并使用基本函数。

        基本函数用于在集成执行期间检索或生成值。例如，生成随机 UUID 或检索当前集成区域。如需了解支持的基本函数，请参阅支持的基本函数。

      • 点击保存。
   3. 点击“输入”行中任意输入变量、值或基本函数的 +（添加函数），从可用映射函数列表中添加映射函数。映射函数可以有一个或多个参数。每个参数可以进一步具有值、变量或基本函数，后跟映射函数。
      • 如需添加嵌套函数，请点击函数参数旁边的 +（添加函数）。同样地，如需移除或删除最近添加的函数，请点击 -（删除上一个函数）。
      • 如需在映射表达式之间添加、移除或更改函数，请点击一个函数，然后相应地选择添加函数、移除函数或更改函数。

      如需详细了解映射函数，请参阅映射函数。

      如需了解受支持的映射函数，请参阅受支持的数据类型和映射函数。

      • 如需移除映射表达式中的变量，请点击“变量”行旁边的 （移除）。
      • 如需移除整个“输入”行，请点击该行中的 （清除）。
3. 配置映射输出：
   输出：数据映射的目标变量输出。目标变量可用于映射后续输入行。
   1. 将变量从变量列表拖动到“输出”行中。如果该变量不可用，请点击创建新变量以配置新变量的名称和数据类型。或者，您可以点击输出变量，然后选择是使用该变量作为集成的输出还是用作其他集成的输入。
   2. 如需移除输出变量，请点击 （清除）。
4. （可选）如需删除映射行，请点击（删除此映射）。
5. 映射完成后，关闭数据映射编辑器。所有更改都将自动保存。

已完成的数据映射可通过数据映射任务配置窗格进行查看，如下图所示：

受支持的数据类型和映射函数

对于数据映射任务中的变量，Apigee Integration 支持以下数据类型：

• 字符串和字符串数组
• 整数和整数数组
• 双精度型和双精度型数组
• 布尔值和布尔值数组
• JSON

下表列出了每种数据类型的可用数据映射函数。

数据类型	支持的映射函数
布尔值	AND, EQUALS, NAND, NOR, NOT, OR, TO_JSON, TO_STRING, XNOR, XOR
布尔值数组	APPEND, APPEND_ALL, CONTAINS, FILTER, FOR_EACH, GET, REMOVE, REMOVE_AT, SET, SIZE, TO_JSON, TO_SET
双精度型	ADD, DIVIDE, CEIL, EQUALS, EXPONENT, GREATER_THAN, GREATER_THAN_EQUAL_TO, FLOOR, LESS_THAN, LESS_THAN_EQUAL_TO, MOD, MULTIPLY, ROUND, SUBTRACT, TO_JSON, TO_STRING
双精度型数组	APPEND, APPEND_ALL, AVG, CONTAINS, FILTER, FOR_EACH, GET, MAX, MIN, REMOVE, REMOVE_AT, SET, SIZE, SUM, TO_JSON, TO_SET
整数	ADD, DIVIDE, EPOCH_TO_HUMAN_READABLE_TIME, EQUALS, EXPONENT, GREATER_THAN, GREATER_THAN_EQUAL_TO, LESS_THAN, LESS_THAN_EQUAL_TO, MOD, MULTIPLY, SUBTRACT, TO_DOUBLE, TO_JSON, TO_STRING
整数数组	APPEND, APPEND_ALL, AVG, CONTAINS, FILTER, FOR_EACH, GET, MAX, MIN, REMOVE, REMOVE_AT, SET, SIZE, SUM, TO_JSON, TO_SET
JSON	APPEND_ELEMENT, FLATTEN, FILTER, FOR_EACH, GET_ELEMENT, GET_PROPERTY, MERGE, REMOVE_PROPERTY, RESOLVE_TEMPLATE, SET_PROPERTY, SIZE, TO_BOOLEAN, TO_BOOLEAN_ARRAY, TO_DOUBLE, TO_DOUBLE_ARRAY, TO_INT, TO_INT_ARRAY, TO_STRING, TO_STRING_ARRAY
字符串	CONCAT, CONTAINS, DECODE_BASE64_STRING, EQUALS, EQUALS_IGNORE_CASE, LENGTH, REPLACE_ALL, RESOLVE_TEMPLATE, SPLIT, SUBSTRING, TO_BASE_64, TO_BOOLEAN, TO_DOUBLE, TO_INT, TO_JSON, TO_LOWERCASE, TO_UPPERCASE
字符串数组	APPEND, APPEND_ALL, CONTAINS, FILTER, FOR_EACH, GET, REMOVE, REMOVE_AT, SET, SIZE, TO_JSON, TO_SET

如需详细了解每个数据映射函数，请参阅数据映射函数参考文档。

支持的基本函数

下表列出了可用的数据映射基本函数：

数据类型	支持的基本函数
整数	NOW_IN_MILLIS
整数数组	INT_LIST
字符串	GENERATE_UUID、GET_EXECUTION_ID、GET_INTEGRATION_NAME、GET_INTEGRATION_REGION、GET_PROJECT_ID

如需详细了解每个数据映射基本函数，请参阅数据映射函数参考文档。

最佳做法

使用数据映射任务可以有效地将键变量传递给集成中的各种任务。构建集成时，请牢记以下几点提示：

• 系统会按顺序从上到下依次运行映射。也就是说，如果输入变量 A 映射到第一行中的输出变量 B，则变量 B 可在后续行中用于映射。
• 在每一行中，“输入”行的数据类型必须与“输出”行的数据类型相匹配。如需转换类型，请使用转换函数，如 TO_STRING 和 TO_INT。
• 转换链长度不受限制。但是，调试大型链式转换可能很困难。我们建议确保输入转换可读，并将复杂转换拆分为多个映射。
• 如果映射需要回退值，请为映射设置回退值。如果您未提供回退值，则当输入值或转换返回 null 时，映射将返回错误。
• 删除变量时，请确保删除包含此变量的所有映射。

如需了解适用于数据映射任务的用量限额，请参阅用量限额。

注意事项

对于 JSON 变量，基于 JSON 架构，Application Integration 会在以下情况下将该变量的子属性解释为 JSON 类型：

• 如果子属性类型指定 null。例如：

  {
    "properties": {
      "PersonID": {
        "type": [
          "double",
          "null"
        ],
        "readOnly": false
      }
    }
  }

• 如果子属性的类型指定多种数据类型。例如：

  {
    "properties": {
      "PersonID": {
        "type": [
          "integer",
          "string",
          "number"
        ],
        "readOnly": false
      }
    }
  }

在这些情况下，您必须使用数据映射函数将子变量明确转换为所需的类型。

以下示例演示了各种类型的属性声明，并说明了如何使用数据映射函数获取所需的类型：

示例 1

{
  "type": "object",
  "properties": {
    "dbIntegers": {
      "type": "array",
      "items": {
        "type": [
          "integer",
          "null"
        ]
      }
    },
    "dbBooleans": {
      "type": [
        "array"
      ],
      "items": {
        "type": "boolean"
      }
    }
  }
}

Application Integration 将 dbIntegers 解释为 JSON 类型，将 dbBooleans 解释为 BOOLEAN_ARRAY 类型。

若要转换 dbIntegers，请使用以下代码：

dbIntegers.TO_INT_ARRAY()

示例 2

{
  "type": "object",
  "properties": {
    "dbId": {
      "type": [
        "number",
        "null"
      ],
      "readOnly": false
    },
    "dbStatus": {
      "type": [
        "boolean",
        "null"
      ],
      "readOnly": false
    }
  }
}

应用集成可将 dbId 和 dbStatus 识别为 JSON 类型，但 dbId 是可以接受单个双精度值或 null 值的参数，而 dbStatus 是可以接受单个布尔值或 null 值的参数。

若要转换 dbId 和 dbStatus，请使用以下代码：

dbId.TO_DOUBLE()

dbStatus.TO_BOOLEAN()

示例 3

{
  "type": "object",
  "properties": {
    "dbString": {
      "type": [
        "string"
      ],
      "readOnly": false
    }
  }
}

应用集成将 dbString 识别为字符串类型。

错误处理策略

任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略，以及了解不同类型的错误处理策略，请参阅错误处理策略。

配额和限制

如需了解配额和限制，请参阅配额和限制。

后续步骤

• 了解所有任务和触发器。
• 了解数据映射任务函数
• 了解如何测试和发布集成。
• 了解 错误处理。
• 了解集成执行日志。