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

Adobe은 현대적이고 확장 가능한 데이터 캡처를 사용할 것을 권장합니다 핵심 구성 요소 대상 새 적응형 Forms 만들기 또는 AEM Sites 페이지에 적응형 Forms 추가. 이러한 구성 요소는 적응형 Forms 작성의 중요한 발전을 나타내어 인상적인 사용자 경험을 보장합니다. 이 문서에서는 기초 구성 요소를 사용하여 적응형 Forms을 작성하는 이전 방법에 대해 설명합니다.

개요

AEM Forms을 사용하면 양식 작성자가 적응형 양식 필드 내에서 양식 데이터 모델에 구성된 서비스를 호출하여 양식 채우기 경험을 보다 단순화하고 향상시킬 수 있습니다. 데이터 모델 서비스를 호출하려면 비주얼 편집기에서 규칙을 만들거나 guidelib.dataIntegrationUtils.executeOperation 의 코드 편집기에서 API 규칙 편집기.

이 문서는 guidelib.dataIntegrationUtils.executeOperation 서비스를 호출하는 API입니다.

API 사용

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

guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs)

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

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

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

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

다음 샘플 스크립트는 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);

콜백 함수와 함께 API 사용

다음을 사용하여 양식 데이터 모델 서비스를 호출할 수도 있습니다. guidelib.dataIntegrationUtils.executeOperation 콜백 함수를 사용하는 API입니다. API 구문은 다음과 같습니다.

guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, callbackFunction)

콜백 함수에는 success 및 failure callback 함수.

성공 및 실패 콜백 함수가 있는 샘플 스크립트

다음 샘플 스크립트는 guidelib.dataIntegrationUtils.executeOperation 를 호출하는 API GETOrder 에 구성된 서비스 작업 employeeOrder 양식 데이터 모델.

다음 GETOrder 작업은 의 값을 가져옵니다. Order ID 양식 필드를 다음에 대한 입력으로 orderId 인수 및 반환 주문 수량 값 success callback 함수. 다음과 같은 경우 success callback 함수는 주문 수량인 failure callback 함수는 Error occured 메시지.

var operationInfo = {
    "formDataModelId": "/content/dam/formsanddocuments-fdm/employeeOrder",
    "operationTitle": "GETOrder",
    "operationName": "GETOrder"
};
var inputs = {
    "orderId" : Order ID
};
var outputs = {};
var success = function (wsdlOutput, textStatus, jqXHR) {
order_quantity.value = JSON.parse(wsdlOutput).quantity;
 };
var failure = function(){
alert('Error occured');
};
guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, success, failure);