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 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);

Uso da API com a função de retorno de chamada

Você também pode chamar o serviço de modelo de dados de formulário usando a API guidelib.dataIntegrationUtils.executeOperation com uma função de retorno de chamada. A sintaxe da API é a seguinte:

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

A função de retorno de chamada pode ter success e failure funções de retorno de chamada.

Exemplo de script com funções de retorno de sucesso e falha

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

A operação GETOrder usa o valor no campo de formulário Order ID como entrada para o argumento orderId e retorna o valor da quantidade da ordem na função de retorno de chamada success. Se a função de retorno de chamada success não retornar a quantidade do pedido, a função de retorno de chamada failure exibirá a mensagem 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);