アダプティブフォームからフォームデータモデルサービスを呼び出すための API api-to-invoke-form-data-model-service-from-adaptive-forms

概要 overview

AEM Formsを使用すると、フォーム作成者は、フォームデータモデルで設定されたサービスをアダプティブフォームフィールド内から呼び出すことで、フォームの入力操作をさらに簡素化し、強化することができます。 データモデルサービスを呼び出すには、ビジュアルエディターでルールを作成するか、ルールエディターのコードエディターの guidelib.dataIntegrationUtils.executeOperation API を使用して JavaScript を指定します。

このドキュメントでは、guidelib.dataIntegrationUtils.executeOperation API を使用して JavaScript を記述してサービスを呼び出す方法に焦点を当てています。

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 を使用して、employeeAccount フォームデータモデルで構成された getAccountById サービス操作を呼び出しています。

getAccountById 操作は、empId 引数の入力値として employeeID フォームフィールドにある値を使用し、該当する従業員の名前、口座番号、口座残高を戻します。この出力値は指定されたフォームフィールドに入力されます。例えば、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);