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.

Parâmetro Descrição
operationInfo Estrutura para especificar o identificador do modelo de dados do formulário, o título da operação e o nome da operação
inputs Estrutura para especificar objetos de formulário cujos valores são inseridos na operação de serviço
outputs Estrutura para especificar objetos de formulário que serão preenchidos com os valores retornados pela operação de serviço

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.

Parâmetro Descrição
forDataModelId Especifique o caminho do repositório para o modelo de dados do formulário, incluindo seu nome
operationName Especifique o nome da operação de serviço a ser executada
input Mapeie um ou mais objetos de formulário para os argumentos de entrada para a operação de serviço
Saída Mapeie um ou mais objetos de formulário para valores de saída da operação de serviço para preencher campos de formulário

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

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free