적응형 양식에서 양식 데이터 모델 서비스를 호출하는 API api-to-invoke-form-data-model-service-from-adaptive-forms

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

개요 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에는 다음 매개 변수가 필요합니다.

매개변수
설명
operationInfo
양식 데이터 모델 식별자, 작업 제목 및 작업 이름을 지정하는 구조
inputs
서비스 작업에 값을 입력하는 양식 객체를 지정하는 구조
outputs
서비스 작업에서 반환된 값으로 채울 양식 개체를 지정하는 구조

의 구조 guidelib.dataIntegrationUtils.executeOperation API는 서비스 작업에 대한 세부 사항을 지정합니다. 구조의 구문은 다음과 같습니다.

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

API 구조는 서비스 작업에 대한 다음 세부 사항을 지정합니다.

매개변수
설명
forDataModelId
이름이 포함된 양식 데이터 모델의 저장소 경로를 지정합니다
operationName
실행할 서비스 작업의 이름을 지정합니다
input
서비스 작업을 위한 입력 인수에 하나 이상의 양식 개체를 매핑합니다
출력
하나 이상의 양식 개체를 서비스 작업의 출력 값에 매핑하여 양식 필드를 채웁니다

서비스를 호출하는 샘플 스크립트 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);
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da