Integrar formulário adaptável ao banco de dados usando o fluxo de trabalho AEM submit-forms-to-database-using-forms-portal

O serviço de automated forms conversion (AFCS) permite converter um formulário de PDF não interativo, um formulário do Acro ou um formulário de PDF baseado em XFA em um formulário adaptável. Ao iniciar o processo de conversão, você tem a opção de gerar um formulário adaptável com ou sem vínculos de dados.

Se você optar por gerar um formulário adaptável sem associações de dados, será possível integrar o formulário adaptável convertido com um modelo de dados de formulário, esquema XML ou esquema JSON após a conversão. Para o modelo de dados de formulário, é necessário vincular campos de formulário adaptáveis manualmente com o modelo de dados de formulário. No entanto, se você gerar um formulário adaptável com vinculações de dados, o serviço de conversão associará automaticamente os formulários adaptáveis a um esquema JSON e criará uma vinculação de dados entre os campos disponíveis no formulário adaptável e no esquema JSON. Em seguida, você pode integrar o formulário adaptável a um banco de dados de sua escolha, preencher dados no formulário e enviá-lo para o banco de dados. Da mesma forma, após a integração bem-sucedida com o banco de dados, é possível configurar campos no formulário adaptável convertido para recuperar valores do banco de dados e preencher previamente os campos de formulário adaptável.

A figura a seguir descreve os diferentes estágios de integração de um formulário adaptável convertido com um banco de dados:

Este artigo descreve as instruções passo a passo para executar com êxito todos esses estágios de integração.

Pré-requisitos pre-requisites

Exemplo de formulário adaptável sample-adaptive-form

Para executar o caso de uso para integrar formulários adaptáveis convertidos ao banco de dados usando um fluxo de trabalho AEM, baixe o seguinte arquivo de PDF de amostra.

Você pode baixar o exemplo de formulário Fale Conosco usando:

Obter arquivo

O arquivo PDF serve como entrada para o serviço de Automated forms conversion (AFCS). O serviço converte esse arquivo em um formulário adaptável. A imagem a seguir representa o formulário entre em contato conosco de amostra em formato PDF.

Instale o arquivo mysql-connector-java-5.1.39-bin.jar install-mysql-connector-java-file

Execute as seguintes etapas, em todas as instâncias de autor e publicação, para instalar o arquivo mysql-connector-java-5.1.39-bin.jar:

Preparar dados para o modelo de formulário prepare-data-for-form-model

A Integração de dados do AEM Forms permite configurar e conectar-se a diferentes fontes de dados. Depois de gerar um formulário adaptável usando o processo de conversão, você pode definir o modelo de formulário com base em um modelo de dados de formulário, XSD ou um esquema JSON. Você pode usar um banco de dados, o Microsoft Dynamics ou qualquer outro serviço de terceiros para criar um modelo de dados de formulário.

Este tutorial usa o banco de dados MySQL como a fonte para criar um modelo de dados de formulário. Crie um esquema no banco de dados e adicione a tabela contactus ao esquema com base nos campos disponíveis no formulário adaptável.

Você pode usar a seguinte instrução DDL para criar a tabela contactus no banco de dados.

CREATE TABLE `contactus` (
   `name` varchar(45) NOT NULL,
   `email` varchar(45) NOT NULL,
   `phonenumber` varchar(10) DEFAULT NULL,
   `issuedesc` varchar(1000) DEFAULT NULL,
   PRIMARY KEY (`email`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Configurar conexão entre a instância do AEM e o banco de dados configure-connection-between-aem-instance-and-database

Execute as seguintes etapas de configuração para criar uma conexão entre a instância do AEM e o banco de dados MYSQL:

Criar modelo de dados de formulário create-form-data-model

Depois de configurar o MYSQL como a fonte de dados, execute as seguintes etapas para criar um modelo de dados de formulário:

Você pode baixar o modelo de dados de formulário de amostra usando:

Obter arquivo

Gerar formulários adaptáveis com vinculação JSON generate-adaptive-forms-with-json-binding

Use o serviço do Automated forms conversion (AFCS) para converter o formulário Fale Conosco em um formulário adaptável com associação de dados. Certifique-se de não marcar a caixa de seleção Generate adaptive form(s) without data bindings ao gerar o formulário adaptável.

Selecione o Formulário Fale Conosco convertido, disponível na pasta output em Forms & Documents, e toque em Edit. Toque em Preview, insira valores nos campos de formulário adaptável e toque em Submit.

Faça logon em crx-repository e navegue até /content/forms/fp/admin/submit/data para exibir os valores enviados no formato JSON. A seguir estão exemplos de dados no formato JSON quando você envia o formulário adaptável Fale Conosco convertido:

{
  "afData": {
    "afUnboundData": {
      "data": {}
    },
    "afBoundData": {
      "data": {
        "name1": "Gloria",
        "email": "abc@xyz.com",
        "phone_number": "2346578965",
        "issue_description": "Test message"
      }
    },
    "afSubmissionInfo": {
      "computedMetaInfo": {},
      "stateOverrides": {},
      "signers": {},
      "afPath": "/content/dam/formsanddocuments/docs_conversion/output/sample_form_json",
      "afSubmissionTime": "20191204014007"
    }
  }
}

Agora é necessário criar um modelo de fluxo de trabalho que possa processar esses dados e enviá-los ao banco de dados MYSQL usando o modelo de dados de formulário criado nas seções anteriores.

Criar um modelo de fluxo de trabalho para processar dados JSON create-workflow-model

Execute as seguintes etapas para criar um modelo de fluxo de trabalho e enviar os dados do formulário adaptável para o banco de dados:

Configurar envio de formulário adaptável configure-adaptive-form-submission

Execute as seguintes etapas para enviar o formulário adaptável para o modelo de fluxo de trabalho criado na seção anterior:

Configurar formulário adaptável para preencher previamente os valores do banco de dados

Execute as seguintes etapas para configurar o formulário adaptável para preencher previamente os valores do banco de dados MYSQL com base na chave primária definida na tabela (Email neste caso):

Você pode baixar a amostra de formulário adaptável convertido usando:

Obter arquivo