用于从自适应表单调用表单数据模型服务的API api-to-invoke-form-data-model-service-from-adaptive-forms

概述 overview

AEM Forms允许表单作者通过从自适应表单字段中调用在表单数据模型中配置的服务，进一步简化和增强表单填充体验。 要调用数据模型服务，您可以在可视编辑器中创建规则，或使用 guidelib.dataIntegrationUtils.executeOperation 代码编辑器中的API 规则编辑器.

本文档重点介绍如何使用 guidelib.dataIntegrationUtils.executeOperation 用于调用服务的API。

使用API using-the-api

的 guidelib.dataIntegrationUtils.executeOperation API从自适应表单字段内调用服务。 API语法如下所示：

guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs)

API需要以下参数。

的结构 guidelib.dataIntegrationUtils.executeOperation API指定有关服务操作的详细信息。 结构的语法如下所示。

var operationInfo = {
formDataModelId,
operationTitle,
operationName
};
var inputs = {
inputField1,
inputFieldN
};
var outputs = {
outputField1,
outputFieldN
}

API结构指定了有关服务操作的以下详细信息。

调用服务的示例脚本 sample-script-to-invoke-a-service

以下示例脚本使用 guidelib.dataIntegrationUtils.executeOperation 用于调用的API getAccountById 在 employeeAccount 表单数据模型。

的 getAccountById 操作采用 employeeID 表单字段作为输入 empId 参数和返回相应员工的员工名称、帐号和帐户余额。 输出值将填充在指定的表单字段中。 例如， name 参数会填充在 fullName 表单元素和值 accountNumber 参数 account 表单元素。

var operationInfo = {
"formDataModelId": "/content/dam/formsanddocuments-fdm/employeeAccount",
"operationName": "getAccountDetails"
};
var inputs = {
"empid" : employeeID
};
var outputs = {
"name" : fullName,
"accountNumber" : account,
"balance" : balance
};
guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs);