Preenchimento e fluxos de trabalho recomendados com base na fonte de dados para formulários adaptáveis

É possível usar qualquer uma das seguintes fontes de dados com formulários adaptáveis convertidos usando o serviço de Automated forms conversion:

  • Modelo de dados de formulário, OData ou qualquer outro serviço de terceiros
  • Schema JSON
  • Schema XSD

Com base na fonte de dados, você pode optar por gerar um formulário adaptável com ou sem um modelo de dados.

Este artigo descreve os workflows recomendados para preencher previamente os valores de campo e as opções de envio depois de selecionar uma fonte de dados e gerar um formulário adaptável usando o serviço de conversão.

Fonte de Dados Fluxo de trabalho recomendado

Modelo de dados de formulário, OData ou qualquer outro serviço de terceiros

Opção 1: Você seleciona o modelo de dados de formulário, OData ou qualquer outro serviço de terceiros como a fonte de dados. Você gera um formulário adaptável sem vínculo de dados usando o serviço de Automated forms conversion. Vincule os campos de formulário adaptáveis às entidades do modelo de dados manualmente e use a opção Serviço de preenchimento prévio do modelo de dados de formulário para preencher previamente os valores de campo. Use a opção Enviar usando o Modelo de dados de formulário para enviar o formulário adaptável.

Opção 2: Você seleciona o modelo de dados de formulário, OData ou qualquer outro serviço de terceiros como a fonte de dados. Você gera um formulário adaptável sem vínculo de dados usando o serviço de Automated forms conversion. Vincule os campos de formulário adaptáveis usando o editor de regras para preencher previamente os valores de campo. Modifique os valores de campo, se necessário, e envie dados para o repositório crx.

Para obter instruções passo a passo para executar esses workflows, consulte Usar banco de dados, OData ou qualquer serviço de terceiros como a fonte de dados.

Schema JSON

Você seleciona schema JSON como a fonte de dados. Com base na fonte de dados selecionada:

Opção 1: Você gera um formulário adaptável sem vínculo de dados usando o serviço de Automated forms conversion e configura o schema JSON como a fonte de dados. Vincule os campos de formulário adaptáveis ao schema JSON manualmente e use qualquer um dos protocolos suportados para preencher os valores de campo antecipadamente. Modifique os valores de campo, se necessário, e envie dados para o repositório crx.

Para obter instruções passo a passo para executar os workflows, consulte Usar o schema JSON como a fonte de dados.

Opção 2: Você gera um formulário adaptável com vínculo de dados JSON usando o serviço de Automated forms conversion. O serviço de preenchimento prévio e a função de envio de formulário funcionam perfeitamente. Você não precisa de nenhuma etapa de configuração.

Para obter instruções passo a passo para executar os workflows, consulte Usar o schema JSON como a fonte de dados.

Schema XSD

Você seleciona schema XSD como a fonte de dados. Com base na fonte de dados selecionada, você gera um formulário adaptável sem vínculo de dados usando o serviço de Automated forms conversion e configura o schema XSD como a fonte de dados. Vincule os campos de formulário adaptáveis ao schema XSD manualmente e use qualquer um dos protocolos suportados para preencher os valores de campo antecipadamente. Modifique os valores de campo, se necessário, e envie dados para o repositório crx.

Para obter instruções passo a passo para executar os workflows, consulte Usar o schema XSD como a fonte de dados.

Para obter mais informações sobre o serviço de Automated forms conversion, consulte os seguintes artigos:

As informações fornecidas neste artigo baseiam-se no pressuposto de que qualquer pessoa que as leia tem conhecimento básico dos conceitos de formas adaptativas.

Pré-requisitos

Exemplo de formulário adaptável

Para executar os casos de uso para preencher previamente valores de campo em um formulário adaptável e enviá-los para a fonte de dados, baixe o arquivo PDF de amostra a seguir.

Formulário de pedido de empréstimo de amostra

Obter arquivo

O arquivo PDF serve como entrada para o serviço do Automated forms conversion. O serviço converte esse arquivo em um formulário adaptável. A imagem a seguir descreve o aplicativo de empréstimo de amostra em um formato PDF.

formulário de pedido de empréstimo de amostra

Preparar dados para o modelo de formulário

A Integração de dados da AEM Forms permite que você configure e conecte-se a fontes de dados diferentes. 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 schema 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 schema loanapplication no banco de dados e adicione uma tabela candidato ao schema com base nos campos disponíveis no formulário adaptável.

Dados de amostra mysql

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

CREATE TABLE `applicant` (
   `name` varchar(45) DEFAULT NULL,
   `address` varchar(45) DEFAULT NULL,
   `phonenumber` int(11) NOT NULL,
   `email` varchar(45) DEFAULT NULL,
   `occupation` varchar(45) DEFAULT NULL,
   `annualsalary` varchar(45) DEFAULT NULL,
   `familymembers` int(11) DEFAULT NULL,
   PRIMARY KEY (`phonenumber`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Se você estiver usando um schema XSD como modelo de formulário para executar os casos de uso, crie um arquivo XSD com o seguinte texto:

<?xml version="1.0" encoding="utf-8" ?>
    <xs:schema targetNamespace="http://adobe.com/sample.xsd"
                    xmlns="http://adobe.com/sample.xsd"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="sample" type="SampleType"/%3E%20%20%3Cxs:complexType%20name=?lang=pt-BR"SampleType">
    <xs:sequence>
      <xs:element name="name" type="xs:string"/%3E%20%20%20%3Cxs:element%20name=?lang=pt-BR"address" type="xs:string"/%3E%20%20%20%3Cxs:element%20name=?lang=pt-BR"phonenumber" type="xs:int"/%3E%20%20%20%3Cxs:element%20name=?lang=pt-BR"email" type="xs:string"/%3E%20%20%20%3Cxs:element%20name=?lang=pt-BR"occupation" type="xs:string"/%3E%20%20%20%3Cxs:element%20name=?lang=pt-BR"annualsalary" type="xs:string"/%3E%20%20%20%3Cxs:element%20name=?lang=pt-BR"familymembers" type="xs:string"/>
 </xs:sequence>
  </xs:complexType>

  </xs:schema>

Ou baixe o schema XSD no sistema de arquivos local.

Schema XSD do aplicativo de empréstimo de amostra

Obter arquivo

Para obter mais informações sobre como usar o schema XSD como modelo de formulário em formulários adaptáveis, consulte Criar formulários adaptáveis usando o schema XML.

Se você estiver usando um schema JSON como o modelo de formulário para executar os casos de uso, crie um arquivo JSON com o seguinte texto:

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "definitions": {
        "loanapplication": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "address": {
                    "type": "string"
                },
    "phonenumber": {
                    "type": "number"
                },
    "email": {
                    "type": "string"
                },
    "occupation": {
                    "type": "string"
                },
    "annualsalary": {
                    "type": "string"
                },
    "familymembers": {
                    "type": "number"
                }
            }
        }
 },
 "type": "object",
    "properties": {
        "employee": {
            "$ref": "#/definitions/loanapplication"
        }
    }
}

Ou baixe o schema JSON no sistema de arquivos local.

Amostra de schema JSON

Obter arquivo

Para obter mais informações sobre como usar o schema JSON como modelo de formulário em formulários adaptáveis, consulte Criar formulários adaptáveis usando o schema JSON.

Gerar formulários adaptáveis sem vínculo de dados

Use o serviço de Automated forms conversion para converter o formulário de aplicação de empréstimo de exemplo para um formulário adaptável sem vínculo de dados. Certifique-se de marcar a caixa de seleção Generate adaptive form(s) without data bindings para gerar o formulário adaptável sem vínculo de dados.

Formulário adaptável sem vínculo de dados

Depois de gerar um formulário adaptável sem vínculo de dados, selecione uma fonte de dados para o formulário adaptável:

OBSERVAÇÃO

Se o formulário adaptável que você converte usando o serviço de Automated forms conversion contiver vários campos com o mesmo nome, verifique se esses campos estão vinculados a entidades de fonte de dados para evitar uma possível perda de dados durante o envio.

Usar banco de dados, OData ou qualquer serviço de terceiros como a fonte de dados

Caso de uso: Você gera um formulário adaptável sem vínculo de dados usando o serviço de Automated forms conversion e configura o banco de dados MYSQL como a fonte de dados. Vincule os campos de formulário adaptáveis às entidades do modelo de dados manualmente e use a opção Form Data Model Prefill Service para preencher previamente os valores de campo. Use a opção Submit using Form Data Model para enviar o formulário adaptável.

Antes de executar o caso de uso:

Com base no caso de uso, crie o modelo de dados de formulário loanapplication e vincule o argumento de serviço de leitura a um valor Literal. O valor literal de número de telefone deve ser de um dos registros configurados no schema candidato do banco de dados MySQL. Os serviços usam o valor como um argumento para buscar detalhes da fonte de dados. Você também pode selecionar Atributo do Perfil do usuário ou Atributo de solicitação na lista suspensa Binding To

Configurar modelo de dados de formulário

OBSERVAÇÃO

Certifique-se de adicionar get e inserir serviços ao modelo de dados de formulário, configurar e testar os serviços antes de executar o caso de uso.

Execute as seguintes etapas:

  1. Selecione o formulário de aplicação de empréstimo de amostra convertido disponível na pasta output e toque em Properties.

  2. Toque na guia Form Model, selecione Form Data Model na lista suspensa Select From e toque em Select Form Data Model para selecionar o modelo de dados de formulário loanapplication. Toque em Save & Close para salvar o formulário.

  3. Selecione o formulário de aplicação de empréstimo de amostra e toque em Edit.

  4. Na guia Content, toque no ícone de configuração:

    configurar container de formulário

    1. Na seção Basic, selecione Form Data Model Prefill service na lista suspensa Prefill Service.

    2. Na seção Submission, selecione Submit using Form Data Model na lista suspensa Submit Action.

    3. Selecione o modelo de dados usando o campo Data Model to submit.

    4. Toque em ícone concluído para salvar as propriedades.

  5. Toque na caixa de texto Nome do candidato e selecione ícone de configuração (Configurar).

    1. No campo Vincular referência, selecione Candidato > Nome e toque em ícone concluído para salvar as propriedades. Da mesma forma, crie um vínculo de dados para Endereço, Número de telefone, Email, Ocupação, Salário anual (em dólares) e Não. dos campos de membros da família dependentes com as entidades do modelo de dados de formulário.

    Referências de vinculação

  6. Toque em Preview para visualização os valores de campo de formulário adaptável pré-preenchido.

  7. Modifique os valores de campo, se necessário, e envie o formulário adaptável. Os valores de campo são submetidos ao banco de dados MySQL. Você pode atualizar a tabela candidato no banco de dados para visualização dos valores atualizados na tabela.

Caso de uso: você gera um formulário adaptável sem vínculo de dados usando o serviço de Automated forms conversion e configura o banco de dados MYSQL como a fonte de dados. Vincule os campos de formulário adaptáveis usando o editor de regras para preencher previamente os valores de campo. Modifique os valores de campo, se necessário, e envie dados para o repositório crx.

Execute as seguintes etapas para usar editor de regras para chamar o serviço de modelo de dados de formulário para vincular campos e valores de preenchimento prévio em um formulário adaptável:

  1. Selecione o formulário de aplicação de empréstimo de amostra na pasta output e toque em Edit.

  2. Na guia Content, toque no ícone de configuração:

    configurar container de formulário

    Na seção Basic, selecione Form Data Model Prefill service na lista suspensa Prefill Service.

  3. Toque na caixa de texto Applicant Name e toque em Edit Rules.

    Editar regras para criar vínculos de dados

  4. Toque em Create na página do Editor de regras.

  5. Na página Rule Editor:

    1. Selecione um estado para a caixa de texto Nome do Candidato. Por exemplo, is initialized, que resulta na execução da condição Then quando você renderiza o formulário no modo Preview.

    2. Na seção Then, selecione Invoke Service na lista suspensa Select Action. Todos os serviços em sua instância do Forms são exibidos na lista suspensa.

    3. Selecione um serviço Get na seção que lista os modelos de dados do formulário. O campo Entrada exibe phonenumber, que é a chave primária definida para o modelo de dados requerente. O sistema recupera e preenche previamente os valores no formulário adaptável para campos na seção Saída com base nesse campo.

    4. Crie um vínculo para os campos de formulário adaptáveis com as entidades do modelo de dados de formulário usando a seção Saída. Por exemplo, vincule o campo de formulário adaptável Applicant Name à entidade name.

    5. Tocar Done. Toque em Done novamente na página do Editor de regras.

    Editor de regras para vincular referências

  6. Toque em Preview para visualização os valores de campo de formulário adaptável pré-preenchido.

    OBSERVAÇÃO

    Certifique-se de que a propriedade Return Array esteja definida como OFF para a propriedade de serviço get no modelo de dados de formulário associado ao formulário adaptável.

  7. Modifique os valores de campo, se necessário, e envie o formulário adaptável. Os dados enviados estão disponíveis no seguinte local no repositório crx:

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Usar o schema JSON como fonte de dados

Caso de uso: você gera um formulário adaptável sem vínculo de dados usando o serviço do Automated forms conversion e configura o schema JSON como a fonte de dados. Vincule os campos de formulário adaptáveis ao schema JSON manualmente e use a opção Pré-visualização com data para preencher previamente os valores de campo. Modifique os valores de campo, se necessário, e envie dados para o repositório crx.

Antes de executar o caso de uso, verifique se você:

Execute as seguintes etapas:

  1. Selecione o formulário do aplicativo de empréstimo de amostra convertido disponível na pasta output e toque em Properties.

  2. Toque na guia Form Model, selecione Schema na lista suspensa Select From e toque em Select Schema para fazer upload do schema demo.schema JSON salvo no sistema de arquivos local. Toque em Save & Close para salvar o formulário.

  3. Selecione o formulário de aplicação de empréstimo de amostra e toque em Edit.

  4. Toque na caixa de texto Nome do candidato e selecione ícone de configuração (Configurar).

    No campo Vincular referência, selecione Candidato > Nome e toque em ícone concluído para salvar as propriedades. Da mesma forma, crie um vínculo de dados para Endereço, Número de telefone, Email, Ocupação, Salário anual (em dólares) e Não. dos campos de membros da família dependentes com as entidades do schema JSON.

  5. Selecione novamente o formulário de aplicação de empréstimo de amostra convertido disponível na pasta output e selecione Preview > Preview with Data.

    Baixar arquivo de dados de amostra

    Obter arquivo

  6. Modifique os valores de campo, se necessário, e envie o formulário adaptável. Os dados enviados estão disponíveis no seguinte local no repositório crx:

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Usar o schema XSD como fonte de dados

Caso de uso: você gera um formulário adaptável sem vínculo de dados usando o serviço de Automated forms conversion e configura o schema XSD como a fonte de dados. Vincule os campos de formulário adaptáveis ao schema XSD manualmente e use a Pré-visualização com data para preencher previamente os valores de campo. Modifique os valores de campo, se necessário, e envie dados para o repositório crx.

Antes de executar o caso de uso, verifique se você:

Execute as seguintes etapas:

  1. Selecione o formulário de aplicação de empréstimo de amostra convertido disponível na pasta output e toque em Properties.

  2. Toque na guia Form Model, selecione Schema na lista suspensa Select From e toque em Select Schema para fazer upload do schema loanapplication XSD salvo no sistema de arquivos local. Selecione o elemento raiz para o schema XSD e toque em Save & Close para salvar o formulário.

  3. Selecione o formulário de aplicação de empréstimo de amostra e toque em Edit.

  4. Toque na caixa de texto Nome do candidato e selecione ícone de configuração (Configurar).
    No campo Vincular referência, selecione Candidato > Nome e toque em Ícone concluído para salvar as propriedades. Da mesma forma, crie um vínculo de dados para Endereço, Número de telefone, Email, Ocupação, Salário anual (em dólares) e Não. dos campos de membros da família dependentes com as entidades do schema XSD.

  5. Selecione novamente o formulário de aplicação de empréstimo de amostra convertido disponível na pasta output e selecione Preview > Preview with Data.

    Baixar arquivo de dados de amostra

    Obter arquivo

  6. Modifique os valores de campo, se necessário, e envie o formulário adaptável. Os dados enviados estão disponíveis no seguinte local no repositório crx:

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Gerar formulários adaptáveis com vínculo JSON

Use o serviço de Automated forms conversion para converter o formulário de aplicação de empréstimo de exemplo para um formulário adaptável com vínculo 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.

Formulário adaptável com vínculo JSON

Usar o schema JSON como fonte de dados

Caso de uso: você gera um formulário adaptável com vínculo de dados JSON usando o serviço do Automated forms conversion. O serviço de preenchimento prévio e a função de envio de formulário funcionam perfeitamente. Você não precisa de nenhuma etapa de configuração.

Antes de executar o caso de uso, verifique se você tem um formulário adaptável com vínculo de dados.

Execute as seguintes etapas:

  1. Selecione novamente o formulário de aplicação de empréstimo de amostra convertido disponível na pasta output e selecione Preview > Preview with Data.

    Baixar arquivo de dados de amostra

    Obter arquivo

  2. Modifique os valores de campo, se necessário, e envie o formulário adaptável. Os dados enviados estão disponíveis no seguinte local no repositório crx:

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Converter dados JSON de formulário adaptável enviados para o formato XML

Quando você insere valores em campos de formulário adaptáveis e os envia, os dados ficam disponíveis no formato JSON no repositório crx. Você pode converter o formato de dados JSON em XML usando a API org.apache.sling.commons.json.xml ou o seguinte código de amostra:

import org.apache.sling.commons.json.JSONException;
import org.apache.sling.commons.json.JSONObject;
import org.apache.sling.commons.json.xml.XML;
 
public class ConversionUtils {
 
    public static String jsonToXML(String jsonString) throws JSONException {
        //https://sling.apache.org/apidocs/sling5/org/apache/sling/commons/json/xml/XML.html#toString(java.lang.Object)
        //jar - http://maven.ibiblio.org/maven2/org/apache/sling/org.apache.sling.commons.json/2.0.18/
        //Note: Need to extract boundData part before converting to XML
        return XML.toString(new JSONObject(jsonString));
    }
}

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free