使用“针对每个循环”任务

本教程介绍如何将“For Each 循环”任务用于字符串串联。在本教程中，您将创建两个集成：主集成和子集成。主集成循环遍历一个字符串数组，对于数组中的每个元素，都会调用执行串联的子集成。运行主集成后的输出是串联的字符串。

如需完成本教程，请执行以下任务：

创建主集成

如需创建新的集成，请执行以下步骤：

  1. 转到 Apigee 界面并登录。
  2. 使用界面左上角的下拉菜单选择您的组织。
  3. 点击开发 > 集成。
  4. 点击新建。
  5. 在创建 Integrations对话框中输入名称和说明。
  6. 从支持的区域列表中选择集成的区域。
  7. 点击创建以打开集成设计器。
  8. 在集成设计器中，点击 + 添加任务/触发器 > 触发器 > API 触发器。
  9. 将 API 触发器元素拖动至集成设计器。
  10. 点击 + 添加任务/触发器 > 任务 > 针对每个循环。
  11. 将针对每个循环元素拖动到集成设计器中。
  12. 添加一条从 API 触发器元素到“针对每个循环”元素的连接（网络连接）：
    1. 点击附加到 API 触发器元素一侧的创建分支图标。
    2. 在按住鼠标指针的同时，将鼠标指针拖动到“针对每个循环”元素内的一个区域。
    3. 释放鼠标指针。

在主集成中创建变量

在主集成中创建以下变量：

  • WordArray：字符串数组。系统会将数组值发送到子集成进行串联。
  • TempString：临时字符串变量。
要创建变量，请执行以下步骤：
  1. 在主集成中，点击菜单栏上的 VAR。
  2. 点击添加 +。
  3. 在创建变量对话框中，设置以下属性：
    • 名称：输入 WordArray
    • 数据类型：选择 String Array
    • 默认值：输入 Hello, World, Apigee, Integrations
  4. 点击创建。
  5. 点击添加 +。
  6. 在创建变量对话框中，设置以下属性：
    • 名称：输入 TempString
    • 数据类型：选择 String
  7. 点击创建。
  8. 点击确定以关闭变量对话框。

创建子集成

现在，创建一个串联字符串的子集成（新集成）。

要创建子集成，请执行以下步骤：

  1. 在 Apigee 界面中，点击开发 > 集成。
  2. 点击新建。
  3. 输入集成的名称和说明，然后点击创建。
  4. 在集成设计器中，点击 + 添加任务/触发器 > 触发器 > API 触发器。
  5. 将 API 触发器元素拖动至集成设计器。
  6. 点击 + 添加任务/触发器 > 任务 > 数据映射。
  7. 将数据映射元素拖动至集成设计器。
  8. 添加一条从 API 触发器元素到“数据映射”元素的连接（网络连接）。

在子集成中创建变量

在子集成中创建以下变量：

  • SubIntegrationInput：集成的输入变量。子集成运行时，此变量会包含主集成的 WordArray 变量中的值。
  • SubIntegrationOutput：集成的输出变量。当子集成完成运行后，此变量将包含串联的字符串。
  • SubIntegrationPreviousValue：用于保存每个循环的间歇性串联字符串的输入变量。此变量的值是从主集成传递的。
要创建变量，请执行以下步骤：
  1. 在主集成中，点击菜单栏上的 VAR。
  2. 点击添加 +。
  3. 在创建变量对话框中，设置以下属性：
    • 名称：输入 VARIABLE_NAME
    • 数据类型：选择 String
  4. 指定变量是输入变量还是输出变量：
    • 如果您要创建 SubIntegrationInput 或 SubIntegrationPreviousValue 变量，请选择用作集成的输入。
    • 如果您要创建 SubIntegrationOutput 变量，请选择用作集成的输出。
  5. 点击创建。
重复在子集成中创建每个变量的步骤。

配置子集成

如需创建子集成，请执行以下步骤：
  1. 点击数据映射元素以查看配置窗格。
  2. 点击 。
  3. 在数据映射编辑器中：
    1. 将 SubIntegrationPreviousValue 变量拖动到输入列。
    2. 在 SubIntegrationPreviousValue 变量中，点击添加函数，然后选择 CONCAT。
    3. 将 SubIntegrationInput 变量拖动到 CONCAT 函数中。
    4. 将 SubIntegrationOutput 变量拖动到输出列。
  4. 关闭数据映射编辑器。
  5. 点击发布。

配置并运行主集成

现在，返回主集成并将其配置为调用子集成。

如需配置主集成，请执行以下步骤：

  1. 在集成设计器中打开主集成。
  2. 点击“For Each 循环”元素以查看任务的配置窗格。
  3. 在配置窗格中设置以下属性：
    • 迭代列表：选择 WordArray。
    • API 触发器 ID：输入子集成的触发器 ID。您可以从子集成的 API 触发器元素中获取触发器 ID 值。
    • 集成名称：输入子集成的名称。
    • 迭代元素子集成映射：选择 SubIntegrationInput。
    • 响应参数替换映射：
      • 在要映射的子集成输出下拉列表中，选择 SubIntegrationOutput。
      • 在要替换的集成变量下拉列表中，选择 TempString。
    • 映射到其他子集成输入：
      • 在要映射的集成变量下拉列表中，选择 TempString。
      • 在要映射到的子集成输入下拉列表中，选择 SubIntegrationPreviousValue。
  4. 点击发布。

如果主集成和子集成都成功运行，则在执行摘要对话框中，您可以在 TempString 变量中看到串联的字符串 HelloWorldApigeeIntegrations。