Usar modelo de dados de formulário use-form-data-model
A integração de dados do AEM Forms permite usar diferentes fontes de dados de backend para criar um modelo de dados de formulário que pode ser usado como schema em vários formulários adaptáveis e fluxos de trabalho de comunicações interativas. Ela requer a configuração de fontes de dados e a criação de um modelo de dados de formulário com base em objetos e serviços de modelo de dados disponíveis em fontes de dados. Para obter mais informações, consulte:
Um modelo de dados de formulário é uma extensão do esquema JSON que pode ser usada para:
- Criar formulários e fragmentos adaptáveis
- Criar comunicações interativas e blocos de construção como fragmentos de texto, lista e condição
- Visualizar comunicações interativas com dados de amostra
- Preencher previamente formulários adaptáveis e comunicações interativas
- Gravar dados de formulário adaptável enviados de volta em fontes de dados
- Invocar serviços usando regras de formulário adaptáveis
Criar formulários e fragmentos adaptáveis create-af
Você pode criar formulários adaptáveis e fragmentos de formulário adaptáveis com base em um modelo de dados de formulário. Faça o seguinte para usar um modelo de dados de formulário ao criar um formulário adaptável ou fragmento de formulário adaptável:
-
Na guia Modelo de formulário na tela Adicionar propriedades , selecione Modelo de dados do formulário no Selecionar de lista suspensa.
-
Toque para expandir Selecionar Modelo de Dados de Formulário. Todos os modelos de dados de formulário disponíveis são listados.
Selecione um do modelo de dados.
-
(Somente fragmentos de formulário adaptáveis) É possível criar um fragmento de formulário adaptável com base em apenas um objeto de modelo de dados em um modelo de dados de formulário. Expandir Definições do Modelo de dados de formulário lista suspensa. Ele lista todos os objetos de modelo de dados no modelo de dados de formulário especificado. Selecione um objeto de modelo de dados na lista.
Depois que o formulário adaptável ou o fragmento de formulário adaptável com base em um modelo de dados de formulário for criado, os objetos de modelo de dados de formulário aparecerão na variável Objetos do modelo de dados do navegador Conteúdo no editor de formulário adaptável.
É possível arrastar e soltar objetos de modelo de dados no formulário ou fragmento adaptável para adicionar campos de formulário. Os campos de formulário adicionados mantêm as propriedades de metadados e o vínculo com as propriedades de objetos do modelo de dados. O vínculo garante que os valores do campo sejam atualizados nas fontes de dados correspondentes no envio do formulário e pré-preenchidos no momento em que o formulário for renderizado.
Criar comunicações interativas create-ic
É possível criar uma comunicação interativa com base em um modelo de dados de formulário que pode ser usado para preencher previamente a comunicação interativa com dados de fontes de dados configuradas. Além disso, os blocos de construção de uma comunicação interativa, como fragmentos de documento de texto, lista e condição, podem ser baseados em um modelo de dados de formulário.
É possível escolher um modelo de dados de formulário ao criar uma comunicação interativa ou um fragmento de documento. A imagem a seguir mostra a guia Geral da caixa de diálogo Criar comunicação interativa .
Guia Geral da caixa de diálogo Criar comunicação interativa
Para obter mais informações, consulte:
Criar uma comunicação interativa
Texto em Comunicações interativas
Condições em comunicações interativas
Visualizar com dados de amostra preview-ic
O editor de modelo de dados de formulário permite gerar e editar dados de amostra para objetos de modelo de dados no modelo de dados de formulário. Você pode usar esses dados para visualizar e testar comunicações interativas e formulários adaptáveis. Você deve gerar os dados de amostra antes de visualizar conforme descrito em Trabalhar com o modelo de dados de formulário.
Para visualizar uma comunicação interativa com dados de modelo de dados de formulário de amostra:
- Em AEM instância do autor, navegue até Forms > Forms e documentos.
- Selecione uma comunicação interativa e toque em Visualizar na barra de ferramentas a ser selecionada Canal da Web, Canal de impressão ou Ambos os canais para visualizar a comunicação interativa.
- Na Visualização [canal] , assegure que Testar dados do modelo de dados de formulário está selecionado e toque em Visualizar.
A comunicação interativa é aberta com dados de amostra pré-preenchidos.
Da mesma forma, para visualizar um formulário adaptável com dados de amostra, abra o formulário adaptável no modo de criação e toque em Visualizar.
Preencher previamente usando o serviço de modelo de dados de formulário prefill
O AEM Forms fornece o serviço de preenchimento prévio do modelo de dados de formulário pronto para uso que você pode ativar para formulários adaptáveis e comunicações interativas com base no modelo de dados de formulário. O serviço de preenchimento prévio consulta fontes de dados para objetos de modelo de dados no formulário adaptável e na comunicação interativa e, portanto, preenche os dados previamente ao renderizar o formulário ou a comunicação.
Para ativar o Serviço de preenchimento prévio do modelo de dados de formulário para um formulário adaptável, abra as propriedades do contêiner de formulário adaptável e selecione Serviço de preenchimento prévio do modelo de dados de formulário do Serviço de preenchimento prévio na opção Básico . Em seguida, salve as propriedades.
Para configurar o serviço de preenchimento prévio do modelo de dados de formulário em uma comunicação interativa, você pode selecionar Serviço de preenchimento prévio do modelo de dados de formulário na lista suspensa Serviço de preenchimento prévio ao criá-lo ou posteriormente, modificando as propriedades.
Caixa de diálogo Editar propriedades para uma comunicação interativa
Gravar dados de formulário adaptável enviados em fontes de dados write-af
Quando um usuário envia um formulário com base em um modelo de dados de formulário, é possível configurar o formulário para gravar dados enviados de um objeto de modelo de dados em suas fontes de dados. Para obter esse caso de uso, a AEM Forms fornece Ação de envio do Modelo de dados de formulário, disponível somente para formulários adaptáveis com base em um modelo de dados de formulário. Ele grava dados enviados para um objeto de modelo de dados em sua fonte de dados.
Para configurar a ação de envio do Modelo de dados de formulário, abra as propriedades do Contêiner de formulário adaptável e selecione Enviar usando o Modelo de dados de formulário no menu suspenso Enviar ação sob a opção Enviar. Em seguida, navegue e selecione um objeto de modelo de dados no Nome do objeto de modelo de dados a ser enviado lista suspensa. Salve as propriedades.
No envio do formulário, os dados do objeto de modelo de dados configurado são gravados na respectiva fonte de dados.
Também é possível enviar anexos de formulário para uma fonte de dados usando a propriedade de objeto de modelo de dados binário. Faça o seguinte para enviar anexos a uma fonte de dados JDBC:
-
Adicione um objeto de modelo de dados que inclua uma propriedade binária ao modelo de dados de formulário.
-
No formulário adaptável, arraste e solte a variável Anexo de arquivo componente do navegador Componentes no formulário adaptável.
-
Toque para selecionar o componente adicionado e toque em
-
No campo Referência de associação, toque em
Toque
-
Na seção Envio das propriedades do Contêiner de formulário adaptável, ative Enviar anexos de formulário. Ele envia o anexo no campo de propriedade binária para a fonte de dados no envio do formulário.
Invocar serviços em formulários adaptáveis usando regras invoke-services
Em um formulário adaptável baseado em um modelo de dados de formulário, é possível criar regras para chamar os serviços configurados no modelo de dados de formulário. O Invocar serviços em uma regra lista todos os serviços disponíveis no modelo de dados de formulário e permite selecionar campos de entrada e saída para o serviço. Também é possível usar a variável Definir valor tipo de regra para invocar um serviço de modelo de dados de formulário e definir o valor de um campo para a saída retornada pelo serviço.
Por exemplo, a regra a seguir chama um serviço get que utiliza a ID do Funcionário como entrada e os valores retornados são preenchidos nos campos ID Dependente, Sobrenome, Nome e Gênero correspondentes no formulário.
Além disso, você pode usar o guidelib.dataIntegrationUtils.executeOperation API para gravar um JavaScript no editor de códigos do editor de regras. Para obter detalhes da API, consulte API para chamar o serviço de modelo de dados de formulário.