查看 Application Integration 支持的连接器

JavaScript 任务

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

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

JavaScript 编辑器支持以下功能:

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

配置 JavaScript 任务

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

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

    转到 Application Integration

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

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

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

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

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

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

  4. 集成编辑器导航栏中,点击任务以查看可用任务和连接器的列表。
  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:应用集成的内存对象

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

JavaScript 执行引擎

应用集成使用基于 Rhino 1.7.14 的 JavaScript 执行引擎,该引擎不支持所有 ES6 语法,例如不支持使用 let 进行变量声明。仅支持 ES5 语法自动补全。如需查看所有支持的 ES6 语法,请参阅 Rhino ES2015 支持

访问集成变量

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

JavaScript 编辑器访问集成变量时,可以使用以下方法:

函数名称 说明 用量

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");
  }

设置任务参数

如果您的集成中有多个 JavaScript 任务未使用的大型参数,您可以为 JavaScript 任务设置 TaskParameter 字段以提高性能。

如需为 JavaScript 任务设置 TaskParameter 字段,请选择以下选项之一:

控制台

  1. 转到 Application Integration 页面。

    前往“Application Integration”

  2. 选择一个集成。系统随即会打开集成编辑器。
  3. 点击 操作 > Download Integration > Integration Version(集成版本)。系统会以 JSON 文件的形式下载集成版本。
  4. 在编辑器中打开集成版本文件,然后执行以下操作:
    1. 找到任务为 JavaScriptTasktaskConfigs 字段。在 parameters 字段中,找到名为 script 的参数。
      "taskConfigs": [{
        "task": "JavaScriptTask",
        "taskId": 1,
        "parameters": {
          "script": {
            "key": "script",
            "value": {
              "stringValue": "function that is called during the JavaScriptTask execution"
            }
        }"
      }]
      
    2. 在此 parameters 字段中,使用以下模板添加要在 JavaScriptTask 字段中使用的参数:
      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      
  5. 保存您对集成版本文件所做的更改。
  6. 集成版本文件上传到集成。

API

  1. 如需下载集成版本,请调用 projects.locations.integrations.versions.download 方法,并将 filFormat 设置为 JSON
  2. 在编辑器中打开集成版本文件,然后执行以下操作:
    1. 找到任务为 JavaScriptTasktaskConfigs 字段。在 parameters 字段中,找到名为 script 的参数。
      "taskConfigs": [{
        "task": "JavaScriptTask",
        "taskId": 1,
        "parameters": {
          "script": {
            "key": "script",
            "value": {
              "stringValue": "function that is called during the JavaScriptTask execution"
            }
        }"
      }]
      
    2. 在此 parameters 字段中,使用以下模板添加 JavaScriptTask 字段中使用的参数:
      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      
  3. 如需上传集成版本,请使用更新后的集成版本文件调用 projects.locations.integrations.versions.upload 方法。

错误处理策略

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

配额和限制

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

后续步骤