Usar o modelo de dados de formulário (FDM) use-form-data-model

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

integração de dados

A integração de dados do Experience Manager Forms permite que você use fontes de dados de back-end diferentes para criar um Modelo de Dados de Formulário (FDM) que você pode usar como esquema em vários fluxos de trabalho do Adaptive Forms. Ela requer a configuração de fontes de dados e a criação do Modelo de dados de formulário (FDM) 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 (FDM) é uma extensão do esquema JSON que você pode usar para:

Criar Forms adaptável e fragmentos create-af

Você pode criar Forms adaptável e Fragmentos de formulário adaptável com base em um modelo de dados de formulário (FDM). Faça o seguinte para usar um Modelo de dados de formulário (FDM) 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 de formulário na lista suspensa Selecionar de.

    criar-af-1-1

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

    Selecione um do modelo de dados.

    criar-af-2-1

  3. (Fragmentos de formulário adaptáveis somente) É 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 (FDM). Expanda o menu suspenso Definições do Modelo de Dados de Formulário. Ela lista todos os objetos do modelo de dados no modelo de dados de formulário (FDM) 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 (FDM) for criado, os objetos de modelo de dados de formulário aparecerão na guia Fontes de dados do navegador de conteúdo no editor de formulário adaptável.

    note note
    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 Fontes de dados.

    guia-objetos-modelo-de-dados

    Você pode arrastar e soltar objetos de modelo de dados no Formulário adaptável ou fragmento 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.

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 (FDM). Você pode usar esses dados para visualizar e testar o Adaptive Forms. Você deve gerar os dados de amostra antes de visualizar como descrito em Trabalhar com o modelo de dados de formulário.

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

O Experience Manager Forms fornece o Serviço de Preenchimento de Modelo de Dados de Formulário pronto para uso que você pode habilitar para o Adaptive Forms com base no modelo de dados de formulário (FDM). O serviço de preenchimento prévio consulta as fontes de dados para objetos de modelo de dados no Formulário Adaptável e, consequentemente, preenche os dados enquanto renderiza o formulário ou a comunicação.

Para habilitar o Serviço de Preenchimento de 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 de Modelo de Dados de Formulário no menu suspenso Serviço de Preenchimento Prévio na opção Básico. Em seguida, salve as propriedades.

serviço de preenchimento

Gravar dados do Formulário adaptável enviado nas fontes de dados write-af

Quando um usuário envia um formulário com base em um modelo de dados de formulário (FDM), é 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, Experience Manager Forms forneça a Ação de envio do modelo de dados de formulário, disponível e pronta para uso somente para o Adaptive Forms com base em um modelo de dados de formulário (FDM). 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:

  1. Abra o navegador Conteúdo e selecione o componente Contêiner do Guia do seu Formulário adaptável.

  2. Clique no ícone de propriedades do Guia Contêiner Propriedades do Guia . A caixa de diálogo Contêiner de formulário adaptável é aberta.

  3. Clique na guia Envio.

  4. Na lista suspensa Enviar Ação, selecione Enviar usando o Modelo de Dados de Formulário.

    Configuração de ação

  5. Especifique o Modelo de dados para enviar.

  6. Clique em Concluído

No envio do formulário, os dados do objeto de modelo de dados configurado são gravados na respectiva fonte de dados. Além disso, você pode enviar um anexo de formulário usando um Modelo de dados de formulário (FDM) e um Documento de registro (DoR) para a fonte de dados. Para obter informações sobre o modelo de dados de formulário (FDM), consulte AEM Forms Integração de Dados.

NOTE
O AEM as a Cloud Service oferece várias ações de envio prontas para uso para manipular envios de formulários. Você pode saber mais sobre essas opções no artigo Ação de envio do formulário adaptável.

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 (FDM).

  2. No Formulário adaptável, arraste e solte o componente Anexo de Arquivo do navegador Componentes no Formulário adaptável.

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

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

    Selecione o botão de seleção para salvar as propriedades. O campo de anexo agora está vinculado à propriedade binary do modelo de dados de formulário (FDM).

  5. Na seção Envio das propriedades do Contêiner de formulário adaptável, habilite 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 no Adaptive Forms usando regras invoke-services

Em um Formulário adaptável baseado em um modelo de dados de formulário (FDM), você pode criar regras para chamar serviços configurados no modelo de dados de formulário (FDM). A operação Invocar Serviços em uma regra lista todos os serviços disponíveis no Modelo de Dados de Formulário (FDM) e permite selecionar campos de entrada e saída para o serviço. Você também pode usar o tipo de regra Definir Valor 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 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.

invocar-serviço

Além disso, você pode usar a API guidelib.dataIntegrationUtils.executeOperation para escrever uma JavaScript no editor de códigos do editor de regras.

Chamar um modelo de dados de formulário (FDM) usando funções personalizadas invoke-form-data-model-using-custom-functions

Você pode invocar um modelo de dados de formulário do editor de regras usando funções personalizadas. Para chamar o modelo de dados de formulário (FDM), adicione um modelo de dados de formulário ao arquivo de inclui na lista de permissões. Para adicionar um modelo de dados de formulário a uma lista de permissões:

  1. Vá para o Experience Manager web console em https://server:host/system/console/configMgr.
  2. Localize Lista de Permissões de Nível de Formulário Adaptável do Modelo de Dados de Formulário para Invocação de Serviço - Fábrica de Configuração.
  3. Clique no ícone de adição para adicionar a configuração.
  4. Adicione o Padrão de caminho de conteúdo para especificar o local do Forms Adaptável. Por padrão, o valor é /content/forms/af/(.*), que inclui todo o Forms adaptável. Você também pode especificar o caminho para um Formulário adaptável específico.
  5. Adicione Padrão de caminho do Modelo de Dados de Formulário para especificar o local do modelo de dados de formulário (FDM). Por padrão, o valor é /content/dams/formsanddocuments-fdm/(.*), que inclui todo o Modelo de dados de formulário (FDM). Você também pode especificar o caminho para um Modelo de dados de formulário (FDM) específico.
  6. Salve as configurações.

A configuração adicionada é salva na Lista de Permissões de Nível de Formulário Adaptável do Modelo de Dados de Formulário para Invocação de Serviço - Fábrica de Configuração.

NOTE
Para chamar um modelo de dados de formulário (FDM) no editor de regras usando funções personalizadas por meio de um projeto de arquétipo AEM:
  1. Criar um arquivo de configuração.
  2. Definir as propriedades getContentPathPattern e getFormDataModelPathPattern.
  3. Implante o projeto.

Artigos relacionados

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab