数据转换器脚本任务

借助数据转换器脚本任务，您可以编写、修改和评估自定义 Jsonnet 模板，以便在集成中执行数据映射。

如需了解 Application Integration 中的数据映射，请参阅数据映射概览。

配置数据转换器脚本任务

如需向集成添加数据转换器脚本任务，请执行以下步骤：

在 Google Cloud 控制台中，前往 Application Integration 页面。
转到 Application Integration
在导航菜单中，点击 Integrations（集成）。
系统随即会显示集成页面，其中列出了 Google Cloud 项目中提供的所有集成。
选择现有集成，或点击创建集成以创建新集成。
要创建新的集成，请执行以下操作：
1. 在 Create Integration（创建集成）窗格中输入名称和说明。
2. 选择集成区域。
  注意：区域下拉列表仅列出您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
3. 为集成选择服务帐号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务帐号详细信息。
  注意：仅当您为所选区域启用了集成治理时，系统才会显示用于选择服务帐号的选项。
4. 点击创建。
系统会在集成编辑器中打开集成。
在集成编辑器导航栏中，点击 Tasks 以查看可用任务列表。
点击数据转换器脚本元素，并将其放置到集成编辑器中。
点击设计器上的数据转换器脚本元素以查看数据转换器脚本任务配置窗格。
点击打开数据转换器脚本编辑器。
此时会显示数据转换器脚本编辑器，其中显示默认的带注释的 Jsonnet 模板示例。
编写 Jsonnet 代码，完成后关闭编辑器。所有更改都将自动保存。

使用数据转换器脚本编辑器

您可以使用数据转换器脚本编辑器access集成变量、执行变量赋值以及添加或修改集成中的变量。数据转换器脚本编辑器提供了以下功能来丰富脚本体验：

语法/代码突出显示、缩进和行号，可更轻松地读取代码和识别结构。
显示脚本代码的简要概览并有助于快速导航的迷你地图。
点击复制选项，可将脚本代码复制到剪贴板。

如需打开编辑器，请转到数据转换器脚本任务配置窗格，然后点击打开数据转换器脚本编辑器。

默认情况下，Data Transformer 脚本编辑器会导入 functions，这是一个预定义的自定义库，包含一组用于在 Application Integration 中进行数据映射的 Jsonnet 函数。如需详细了解可用的自定义函数，请参阅数据转换器函数。

下图显示了数据转换器脚本编辑器的示例布局：

显示数据转换器脚本编辑器的图片

访问集成变量

如需从数据转换器脚本编辑器中读取现有集成变量，请使用预定义 functions 库中的 extVar 函数。

示例：使用数据转换器脚本编辑器读取和更新现有集成变量。

Jsonnet 脚本

local f = import "functions"; // Import predefined Data Transformer function library

local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
{
  OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
  "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
}

输出

显示 data-transformer 脚本示例的图片

最佳实践

如需了解适用于数据转换器脚本任务的用量限额，请参阅用量限额。

后续步骤

请参阅 Data Transformer 函数（预览版）