API para chamar o serviço de modelo de dados de formulário a partir de formulários adaptáveis

Visão geral

A AEM Forms permite que os autores de formulários simplifiquem e aprimorem ainda mais a experiência de preenchimento de formulários, chamando os serviços configurados em um modelo de dados de formulário a partir de um campo de formulário adaptável. Para chamar um serviço de modelo de dados, você pode criar uma regra no editor visual ou especificar um JavaScript usando a API guidelib.dataIntegrationUtils.executeOperation no editor de código do editor de regras.

Este documento foca em gravar um JavaScript usando a API guidelib.dataIntegrationUtils.executeOperation para chamar um serviço.

Uso da API

A API guidelib.dataIntegrationUtils.executeOperation chama um serviço de dentro de um campo de formulário adaptável. A sintaxe da API é a seguinte:

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

A API exige os seguintes parâmetros.

A estrutura da API guidelib.dataIntegrationUtils.executeOperation especifica detalhes sobre a operação do serviço. A sintaxe da estrutura é a seguinte.

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

A estrutura da API especifica os seguintes detalhes sobre a operação do serviço.

Exemplo de script para chamar um serviço

O script de exemplo a seguir usa a API guidelib.dataIntegrationUtils.executeOperation para chamar a operação de serviço getAccountById configurada no modelo de dados de formulário employeeAccount.

A operação getAccountById usa o valor no campo de formulário employeeID como entrada para o argumento empId e retorna o nome do funcionário, o número da conta e o saldo da conta do funcionário correspondente. Os valores de saída são preenchidos nos campos de formulário especificados. Por exemplo, o valor no argumento name é preenchido no elemento de formulário fullName e no valor do argumento accountNumber no elemento de formulário 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);