적응형 양식에서 양식 데이터 모델 서비스를 호출하는 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);