JavaScript 任务

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

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

JavaScript 编辑器支持以下功能:

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

配置 JavaScript 任务

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

  1. Apigee 界面中,选择您的 Apigee 组织
  2. 点击开发 > 集成
  3. 选择现有集成,或通过点击创建集成来创建新集成。

    要创建新的集成,请执行以下操作:

    1. 创建 Integrations对话框中输入名称和说明。
    2. 从支持的区域列表中选择集成的区域
    3. 点击创建

    这将在集成设计器中打开集成。

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

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

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

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

使用 JavaScript 编辑器

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

其中:

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

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

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

访问集成变量

您可以使用 Apigee Integration 内存中 event 对象从 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("variable_name")

输入参数:集成变量名称。 如果 variable_name 是自动生成的变量,请使用英文反引号 (``) 将变量括起来。例如 `responseBody`

示例

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("variable_name", "variable_value")

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

  • 第一个参数:变量名称。如果 variable_name 是自动生成的变量,请使用英文反引号 (``) 将变量括起来。例如 `responseBody`
  • 第二个参数:值。

示例:

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

错误处理策略

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