API para chamar o serviço de modelo de dados de formulário a partir de formulários adaptáveis api-to-invoke-form-data-model-service-from-adaptive-forms

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Visão geral overview

O AEM Forms permite que os autores de formulários simplifiquem e aprimorem ainda mais a experiência de preenchimento de formulários, chamando serviços configurados em um modelo de dados de formulário 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 o guidelib.dataIntegrationUtils.executeOperation API no editor de código do editor de regras.

Este documento se concentra em escrever um JavaScript usando o guidelib.dataIntegrationUtils.executeOperation API para chamar um serviço.

Uso da API using-the-api

O guidelib.dataIntegrationUtils.executeOperation A API 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 de 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 para a 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 do guidelib.dataIntegrationUtils.executeOperation A API 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 de formulário, incluindo seu nome
operationName
Especificar o nome da operação de serviço a ser executada
input
Mapear um ou mais objetos de formulário para os argumentos de entrada para a operação de serviço
Saída
Mapear 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 sample-script-to-invoke-a-service

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

O getAccountById A operação recebe o valor na variável employeeID campo de formulário como entrada para a variável empId argumento 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 em name for preenchida na variável fullName elemento de formulário e valor para accountNumber argumento em account elemento de formulário.

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