Show Menu
화제×

적응형 양식에서 양식 데이터 모델 서비스를 호출하는 API

개요

양식 작성자는 AEM Forms를 사용하여 적응형 양식 필드 내에서 양식 데이터 모델에 구성된 서비스를 호출하여 양식 작성 환경을 더욱 간소화하고 향상시킬 수 있습니다. 데이터 모델 서비스를 호출하려면 시각적인 편집기에서 규칙을 만들거나 guidelib.dataIntegrationUtils.executeOperation 규칙 편집기의 적응형 양식 규칙 편집기 코드 편집기에서 API를 사용하여 JavaScript를 지정할 수 있습니다.
이 문서에서는 API를 사용하여 서비스를 호출하는 guidelib.dataIntegrationUtils.executeOperation JavaScript를 작성하는 데 중점을 둡니다.

API 사용

API는 guidelib.dataIntegrationUtils.executeOperation 적응형 양식 필드 내에서 서비스를 호출합니다. API 구문은 다음과 같습니다.
guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs)

API에는 다음 매개 변수가 필요합니다.
매개 변수
설명
operationInfo
양식 데이터 모델 식별자, 작업 제목 및 작업 이름을 지정하는 구조
inputs
값이 서비스 작업에 입력되는 양식 객체를 지정하는 구조
outputs
서비스 작업에서 반환한 값으로 채울 양식 객체를 지정하는 구조입니다.
API의 구조는 guidelib.dataIntegrationUtils.executeOperation 서비스 작업에 대한 세부 사항을 지정합니다. 구조의 구문은 다음과 같습니다.
var operationInfo = {
formDataModelId,
operationTitle,
operationName
};
var inputs = {
inputField1,
inputFieldN
};
var outputs = {
outputField1,
outputFieldN
}

API 구조는 서비스 작업에 대한 다음 세부 사항을 지정합니다.
매개 변수 설명
forDataModelId 이름을 포함한 양식 데이터 모델의 저장소 경로 지정
operationName 실행할 서비스 작업 이름 지정
input 서비스 작업의 입력 인수에 하나 이상의 양식 개체 매핑
출력 하나 이상의 양식 객체를 서비스 작업의 출력 값에 매핑하여 양식 필드 채우기

서비스를 호출하는 샘플 스크립트

다음 샘플 스크립트는 API를 guidelib.dataIntegrationUtils.executeOperation 사용하여 양식 데이터 모델에 구성된 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);