Utilizar modelo de dados do formulário

Última atualização em 2023-11-21
  • Criado para:
  • Beginner
    Intermediate
    User
Versão Link do artigo
AEM 6.5 Clique aqui
AEM as a Cloud Service Este artigo

integração de dados

Experience Manager Forms a integração de dados 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 Forms adaptáveis fluxos de trabalho. Ele requer a configuração de fontes de dados e a criação do 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 Forms adaptável e fragmentos

Você pode criar Forms adaptável e fragmentos de formulário adaptável 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 um 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. Toque 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 do modelo de dados de formulário aparecerão no Fontes de dados do Navegador de conteúdo no editor de Formulário adaptável.

    OBSERVAÇÃO

    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.

    data-model-objects-tab

    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

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 Forms adaptável. 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 toque em Visualizar.

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

Experience Manager Forms O fornece o Serviço de preenchimento prévio do modelo de dados de formulário pronto para uso que você pode ativar para o Adaptive Forms com base no modelo de dados do formulário. O serviço de preenchimento prévio consulta as fontes de dados para objetos de modelo de dados no Formulário adaptável 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

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

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, Experience Manager Forms fornecer Ação de envio do modelo de dados de formulário, disponível pronto para uso somente para o Adaptive Forms 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.

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. Toque para selecionar o componente adicionado e toque em settings_icon para abrir o navegador Propriedades do componente.

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

    Toque 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 no Adaptive Forms usando regras

Em um Formulário adaptável baseado 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.

Chamar um modelo de dados de formulário usando funções personalizadas

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

  1. Acesse o console da Web do Experience Manager em https://server:host/system/console/configMgr.
  2. Localizar Lista de permissões no nível do formulário adaptável do modelo de dados de formulário para chamada de serviço - Fábrica de configuração.
  3. Clique em ícone de adição ícone para adicionar a configuração.
  4. Adicionar Padrão do caminho de conteúdo para especificar a localização do Forms adaptável. Por padrão, o valor é /content/forms/af/(.*) que inclui todo o Adaptive Forms. Você também pode especificar o caminho para um Formulário adaptável específico.
  5. Adicionar Padrão de caminho do modelo de dados de formulário para especificar o local do modelo de dados de formulário. Por padrão, o valor é /content/dams/formsanddocuments-fdm/(.*) que inclui todo o Modelo de dados do formulário. Você também pode especificar o caminho para um modelo de dados de formulário específico.
  6. Salve as configurações.

A configuração adicionada é salva em Lista de permissões no nível do formulário adaptável do modelo de dados de formulário para chamada de serviço - Fábrica de configuração opção.

OBSERVAÇÃO

Para chamar um modelo de dados de formulário do 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.

Nesta página