從最適化表單叫用表單資料模型服務的API

概覽

AEM Forms可讓表單作者從最適化表單欄位中叫用表單資料模型中設定的服務，進一步簡化並增強表單填寫體驗。 若要叫用資料模型服務，您可以在視覺編輯器中建立規則，或在規則編輯器的程式碼編輯器中使用guidelib.dataIntegrationUtils.executeOperation API指定JavaScript。

本檔案著重於使用guidelib.dataIntegrationUtils.executeOperation API來編寫JavaScript以叫用服務。

使用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結構指定服務操作的以下詳細資訊。

調用服務的示例指令碼

以下示例指令碼使用guidelib.dataIntegrationUtils.executeOperation API調用employeeAccount表單資料模型中配置的getAccountById服務操作。

getAccountById操作將employeeID表單欄位中的值作為empId參數的輸入，並返回相應員工的員工姓名、帳戶編號和帳戶餘額。 輸出值會填入指定的表單欄位。 例如，name參數中的值會填入fullName表單元素中，而account表單元素中accountNumber參數的值會填入。

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