数据转换器脚本任务

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

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

配置数据转换器脚本任务

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

在 Apigee 界面中，选择您的 Apigee 组织。
点击开发 > 集成。
选择现有集成，或通过点击创建集成来创建新集成。
要创建新的集成，请执行以下操作：
1. 在创建 Integrations对话框中输入名称和说明。
2. 从支持的区域列表中选择集成的区域。
3. 点击创建。
这将在集成设计器中打开集成。
在集成设计器导航栏中，点击 + 添加任务/触发器 > 任务以查看可用任务列表。
点击数据转换器脚本元素，并将其放置到集成编辑器中。
点击设计器上的数据转换器脚本元素以查看数据转换器脚本任务配置窗格。
点击打开数据转换器脚本编辑器。
此时会显示数据转换器脚本编辑器，其中显示默认的带注释的 Jsonnet 模板示例。
编写 Jsonnet 代码，完成后关闭编辑器。所有更改都将自动保存。

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

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

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

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

默认情况下，数据转换器脚本编辑器会导入 functions，这是一个预定义的自定义库，其中包含一组用于在 Apigee 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 脚本示例的图片

最佳实践

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