请参阅 Application Integration 支持的连接器。

JavaScript 任务

通过 JavaScript 任务，您可以为集成编写自定义 JavaScript 代码段。

使用 JavaScript 编辑器，您可以为集成编写复杂数据映射逻辑的代码，执行变量赋值，以及添加或修改集成变量。

JavaScript 编辑器支持以下功能：

  • 显示脚本代码的简要概览并有助于快速导航的迷你地图。
  • 语法/代码突出显示、缩进和行号，可更轻松地读取代码和识别结构。
  • 错误突出显示，可查找和跟踪代码中的错误。
  • 折叠功能，可展开和收起脚本代码的区域。
  • 点击复制选项，可将脚本代码复制到剪贴板。

配置 JavaScript 任务

如需为集成添加 JavaScript 任务，请执行以下步骤：

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

    转到 Application Integration

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

    系统随即会显示集成页面，其中列出了 Google Cloud 项目中提供的所有集成。

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

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

    1. 在 Create Integration（创建集成）窗格中输入名称和说明。
    2. 选择集成区域。
    3. 为集成选择服务帐号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务帐号详细信息。
    4. 点击创建。

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

  4. 在集成编辑器导航栏中，点击 Tasks 以查看可用任务列表。
  5. 点击 JavaScript 元素，并将其放入集成编辑器中。
  6. 点击设计器上的 JavaScript 元素以查看 JavaScript 任务配置窗格。
  7. 点击打开脚本编辑器以查看和修改 JavaScript 编辑器。
  8. 在 JavaScript 编辑器中自动创建的 executesScript(event) 函数内编写 JavaScript 代码。完成后关闭编辑器，系统会自动保存所有更改。

    如需了解如何访问集成变量和支持的函数，请参阅使用 JavaScript 编辑器。

    如需了解如何查看生成的执行日志，请参阅执行日志。

下图展示了 JavaScript 编辑器的示例布局： 显示 JavaScript 编辑器的图片 显示 JavaScript 编辑器的图片

使用 JavaScript 编辑器

如需查看和修改 JavaScript 编辑器，请前往 JavaScript 任务配置窗格，然后点击打开脚本编辑器。默认情况下，JavaScript 编辑器包含一个名为 executesScript(event) 的函数。

其中：

  • executesScript() 是 Application Integration 在集成运行期间执行 JavaScript 任务时调用的函数。
  • event 是 Application Integration 的内存中对象。

    如需了解 event 对象支持的方法，请参阅访问集成变量。

Application Integration 使用的 JavaScript 执行引擎基于 Rhino 1.7.14，后者仅支持部分 ES6 语法。仅支持 ES5 语法自动补全功能。如需查看所有支持的 ES6 语法，请参阅 Rhino ES2015 支持。

访问集成变量

您可以使用 Application Integration 内存中事件对象从 JavaScript 编辑器访问集成中定义的变量。

从 JavaScript 编辑器访问集成变量时，可以使用以下方法：

  1. getEventExecutionInfoId
  2. getGoogleCloudProjectId
  3. getIntegrationName
  4. getParameter
  5. getRegion
  6. 日志
  7. setParameter
函数名称 说明 用量

getEventExecutionInfoId

 返回集成的运行执行 ID。

返回类型：字符串

语法：event.getEventExecutionInfoId()

示例： 


function executeScript(event) {
  event.getEventExecutionInfoId();
  }

getGoogleCloudProjectId

 返回 Google Cloud 项目 ID。

返回类型：字符串

语法： event.getGoogleCloudProjectId()

示例： 


function executeScript(event) {
  event.getGcpProjectId();
  }

getIntegrationName

 返回集成的当前名称。

返回类型：字符串

语法： event.getIntegrationName

示例： 


function executeScript(event) {
  event.getIntegrationName();
  }

getParameter

 返回提供的集成变量的值。

返回类型：集成变量的数据类型

语法： event.getParameter("value")

输入参数：集成变量名称。

示例：


function executeScript(event) {
  event.getParameter("var1");
  }

getRegion

 返回集成区域的名称。

返回类型：字符串

语法： event.getRegion()

示例： 


function executeScript(event) {
  event.getRegion();
  }

log

 将指定的值写入执行日志。

如需了解如何查看生成的执行日志，请参阅执行日志。

语法： event.log(value)

输入参数：脚本中使用的任何变量或函数。

示例 1： 


function executeScript(event) {
  event.log(event.getParameter("var1"));
  }

示例 2： 


function executeScript(event) {
  event.log("Lorem ipsum");
  }

setParameter

 设置或更新集成变量的值。

语法： event.setParameter(value, value)

输入参数：此函数采用以下参数：

  • 第一个参数：变量名称。
  • 第二个参数：值。

示例： 


function executeScript(event) {
  event.setParameter("var1", "NewStringValue");
  }

错误处理策略

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