Utilizar modelo de dados do formulário 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

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 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. 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. 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 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.

    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.

    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 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 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 selecione Visualizar.

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

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 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, 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:

  1. Abra o Navegador de conteúdo e selecione a variável Contêiner do guia componente do seu Formulário adaptável.

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

  3. Clique em Envio guia.

  4. No Ação de envio selecione Enviar usando modelo de dados do formulário.

    Configuração de ação

  5. Especifique a 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 e um Documento de registro (DoR) para a fonte de dados. Para obter informações sobre o modelo de dados de formulário, 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 na Ação de envio do formulário adaptável artigo.

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

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 invoke-form-data-model-using-custom-functions

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.

NOTE
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.

Artigos relacionados

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