Usar modelo de dados de formulário use-form-data-model

Versão
Link do artigo
AEM as a Cloud Service
Clique aqui
AEM 6.5
Este artigo

hero-image

A integração de dados do AEM Forms permite usar fontes de dados de back-end diferentes para criar um modelo de dados de formulário que você pode usar como esquema em vários formulários adaptáveis e workflows de comunicações interativas. Ele requer a configuração de fontes de dados e a criação de um modelo de dados de formulário com base nos objetos e serviços do modelo de dados disponíveis nas fontes de dados. Para obter mais informações, consulte o seguinte:

Um modelo de dados de formulário é uma extensão do esquema JSON que você pode usar para:

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:

  1. Na guia Modelo de formulário na tela Adicionar propriedades, selecione Modelo de dados do formulário no Selecionar de lista suspensa.

    create-af-1-1

  2. Selecionar para expandir Selecionar modelo de dados do formulário. Todos os modelos de dados de formulário disponíveis estão listados.

    Selecione um do modelo de dados.

    create-af-2-1

  3. (Somente fragmentos de formulário adaptável) Você pode 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 menu suspenso. Ele lista todos os objetos do modelo de dados no modelo de dados de formulário especificado. Selecione um objeto de modelo de dados na lista.

    create-af-3

Depois que o formulário adaptável ou o fragmento de formulário adaptável baseado em um modelo de dados de formulário for criado, os objetos de modelo de dados de formulário aparecerão no Objetos do modelo de dados do Navegador de conteúdo no editor de formulários adaptáveis.

NOTE
Para um fragmento de formulário adaptável, somente o objeto de modelo de dados selecionado no momento da criação e seus objetos de modelo de dados associados aparecem na guia Objetos do modelo de dados.

data-model-objects-tab

Você pode 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 retêm as propriedades de metadados e a vinculação com as propriedades do objeto de modelo de dados. O vínculo garante que os valores de campo sejam atualizados nas fontes de dados correspondentes no envio do formulário e preenchidos previamente quando o formulário for renderizado.

Criar comunicações interativas create-ic

Você pode 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 texto, lista e fragmentos de documento de condição podem ser baseados em um modelo de dados de formulário.

Você pode 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.

create-ic

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

Listar fragmentos

Visualizar com dados de amostra preview-ic

O editor do 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 pré-visualizar e testar comunicações interativas e formulários adaptáveis. Gere 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:

  1. Na instância do autor AEM, navegue até Forms > Forms e documentos.
  2. Selecione uma comunicação interativa e selecione Visualizar na barra de ferramentas para selecionar Canal da Web, Canal de impressão ou Ambos os canais para visualizar a comunicação interativa.
  3. Na visualização [channel] , certifique-se de que Testar dados do modelo de dados do formulário está selecionado e selecione Visualizar.

A comunicação interativa é aberta com dados de amostra pré-preenchidos.

visualização da web

Da mesma forma, para visualizar um formulário adaptável com dados de amostra, abra o formulário adaptável no modo de autor e selecione Visualizar.

Preencher previamente usando o serviço de modelo de dados de formulário prefill

A AEM Forms fornece o Serviço de preenchimento prévio do modelo de dados de formulário pronto para uso que você pode habilitar 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 enquanto renderiza o formulário ou a comunicação.

Para habilitar o Serviço de preenchimento 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 do modelo de dados de formulário do Preencher Serviço na opção Básico. Em seguida, salve as propriedades.

serviço de preenchimento

Para configurar o serviço de preenchimento do modelo de dados de formulário em uma comunicação interativa, você pode selecionar o Serviço de preenchimento do modelo de dados de formulário no menu suspenso Serviço de preenchimento ao criá-lo ou posteriormente, modificando as propriedades.

edit-ic-props

Caixa de diálogo Editar propriedades para uma comunicação interativa

Gravar dados de formulário adaptável enviados nas fontes de dados write-af

Quando um usuário envia um formulário com base em um modelo de dados de formulário, você pode 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 pronto para uso 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 modelo de dados do formulário no menu suspenso Enviar ação, na opção Envio. Em seguida, procure e selecione um objeto de modelo de dados na Nome do objeto de modelo de dados a ser enviado menu suspenso. 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.

envio de dados

Você também pode enviar anexos de formulário para uma fonte de dados usando a propriedade de objeto de modelo de dados binários. Faça o seguinte para enviar anexos para uma origem de dados JDBC:

  1. Adicione um objeto de modelo de dados que inclua uma propriedade binária ao modelo de dados de formulário.

  2. No formulário adaptável, arraste e solte a Anexo de arquivo componente do navegador Componentes no formulário adaptável.

  3. Selecione para selecionar o componente adicionado e settings_icon para abrir o navegador Propriedades do componente.

  4. No campo Referência de vinculação, selecione foldersearch_18 e navegue para selecionar a propriedade binária adicionada no modelo de dados de formulário. Configure outras propriedades, conforme apropriado.

    Selecionar botão de seleção para salvar as propriedades. O campo de anexo agora está associado à propriedade binária do modelo de dados de formulário.

  5. Na seção Envio das propriedades do Contêiner de formulário adaptável, ative Enviar anexos do formulário. Ele envia o anexo no campo de propriedade binária para a fonte de dados no envio do formulário.

Chamar serviços em formulários adaptáveis usando regras invoke-services

Em um formulário adaptável com base em um modelo de dados de formulário, você pode criar regras para chamar serviços configurados no modelo de dados de formulário. A variável Chamar serviços a operação 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. Você também pode usar a variável Definir valor tipo de regra para chamar 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 usa a ID do Funcionário como entrada e os valores retornados são preenchidos nos campos ID do Dependente, Sobrenome, Nome e Gênero correspondentes no formulário.

invoke-service

Além disso, você pode usar a variável guidelib.dataIntegrationUtils.executeOperation API para gravar um JavaScript no editor de código do editor de regras. Para obter detalhes sobre a API, consulte API para chamar o serviço de modelo de dados de formulário.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2