Gerar documento de registro para formulários adaptáveis

O Adobe recomenda o uso da captura de dados moderna e extensível Componentes principais para criação de um novo Forms adaptável ou adição de Forms adaptável às páginas do AEM Sites. Esses componentes representam um avanço significativo na criação do Forms adaptável, garantindo experiências de usuário impressionantes. Este artigo descreve a abordagem mais antiga para criar o Forms adaptável usando componentes de base.

Visão geral

Depois de enviar um formulário, seus clientes geralmente querem manter um registro, em formato impresso ou de documento, das informações que preencheram no formulário para referência futura. Isso é chamado de documento de registro.

Este artigo explica como gerar um documento de registro para formulários adaptáveis.

Tipos de formulário adaptável e seus documentos de registro

Ao criar um formulário adaptável, você pode selecionar um modelo de formulário. As opções são:

• Modelos de formulário
  Permite selecionar um modelo XFA para o formulário adaptável. Ao selecionar um modelo XFA, você pode usar o arquivo XDP associado para o documento de registro, conforme descrito acima.

• Esquema XML
  Permite selecionar uma definição de esquema XML para o formulário adaptável. Ao selecionar um esquema XML para seu formulário adaptável, você pode:

  • Associe um modelo XFA para o documento de registro. Certifique-se de que o modelo XFA associado use o mesmo esquema XML que o formulário adaptável
  • Gerar automaticamente documento de registro

• Nenhum Permite criar um formulário adaptável sem um modelo de formulário. O documento de registro é gerado automaticamente para o formulário adaptável.

Ao selecionar um modelo de formulário, configure o documento de registro usando as opções disponíveis em Documento de configuração do modelo de registro. Consulte Documento de configuração de modelo de registro.

Documento de registro gerado automaticamente

Um documento de registro permite que seus clientes mantenham uma cópia do formulário enviado para fins de impressão. Quando você gera automaticamente um documento de registro, sempre que você altera o formulário, o documento de registro dele é atualizado imediatamente. Por exemplo, você remove o campo de idade para clientes que selecionam Estados Unidos da América como seu país. Quando esses clientes geram um documento de registro, o campo de idade não fica visível para eles no documento de registro.

O documento de registro gerado automaticamente tem as seguintes vantagens:

• Ele cuida da vinculação de dados.
• Ele oculta automaticamente os campos marcados como excluir do documento de registro no momento do envio. Não é necessário nenhum esforço extra.
• Ele economiza tempo para projetar o documento do modelo de registro.
• Ele permite tentar diferentes estilos e aparências usando diferentes modelos base e escolher o melhor estilo e aparência para o Documento de registro. As aparências de estilo são opcionais e, se você não especificar o estilo, os estilos do sistema serão definidos como padrão.
• Garante que qualquer alteração no formulário seja refletida imediatamente no documento de registro.

Componentes para gerar automaticamente um documento de registro

Para gerar um documento de registro para formulários adaptáveis, você precisa dos seguintes componentes:

Formulário adaptável Formulário adaptável para o qual você deseja gerar um documento de registro.

Modelo base (recomendado) Modelo XFA (arquivo XDP) criado no AEM Designer. O modelo base é usado para especificar informações de estilo e identidade visual para o documento de modelo de registro.

Consulte Modelo base de um documento de registro

Documento do modelo de registro Modelo XFA (arquivo XDP) gerado de um formulário adaptável.

Consulte Documento de configuração de modelo de registro.

Dados de formulário Informações preenchidas por um usuário no formulário adaptável. Ele é mesclado com o documento do modelo de registro para gerar o documento de registro.

Mapeamento de elementos de formulário adaptáveis

As seções a seguir descrevem como os elementos de formulário adaptáveis aparecem no documento de registro.

Campos

Contêineres

Componentes estáticos

Tabelas

Os componentes da tabela de formulários adaptáveis, como cabeçalho, rodapé e mapa de linhas para componentes XFA correspondentes. Você pode mapear painéis repetíveis para tabelas no documento de registro.

Modelo base de um documento de registro

O modelo base fornece informações de estilo e aparência ao documento de registro. Ele permite personalizar a aparência padrão do documento de registro gerado automaticamente. Por exemplo, você deseja adicionar o logotipo da empresa no cabeçalho e as informações de direitos autorais no rodapé do documento de registro. A página mestra do modelo base é usada como uma página mestra do documento de modelo de registro. A página-mestre pode ter informações como cabeçalho, rodapé e número de página que podem ser aplicadas ao documento de registro. É possível aplicar essas informações ao documento de registro usando o modelo base para geração automática do documento de registro. O uso do template base permite alterar as propriedades padrão dos campos.

Siga Convenções do modelo base ao criar o modelo base.

Convenções do modelo base

Um modelo base é usado para definir o cabeçalho, rodapé, estilo e aparência de um documento de registro. O cabeçalho e o rodapé podem incluir informações como o logotipo da empresa e o texto de direitos autorais. A primeira página mestra no modelo base é copiada e usada como página mestra do documento de registro, que contém o cabeçalho, o rodapé, o número da página ou qualquer outra informação que deva aparecer em todas as páginas do documento de registro. Se você estiver usando um modelo base que não esteja em conformidade com as convenções do modelo base, a primeira página mestra do modelo base ainda será usada no documento de modelo de registro. É altamente recomendável que você crie seu modelo base de acordo com suas convenções e o use para a geração automática do documento de registro.

Convenções da página principal

• No modelo base, você deve nomear o subformulário raiz como AF_METATEMPLATE e a página principal como AF_MASTERPAGE.

• A página mestra com o nome AF_MASTERPAGE localizado abaixo de AF_METATEMPLATE o subformulário raiz recebe preferência para extrair informações de cabeçalho, rodapé e estilo.

• Se AF_MASTERPAGE estiver ausente, a primeira página principal presente no modelo base será usada.

Convenções de estilo para campos

• Para aplicar estilo nos campos no documento de registro, o modelo base fornece campos localizados na variável AF_FIELDSSUBFORM subde sob o AF_METATEMPLATE subformulário raiz.

• As propriedades desses campos são aplicadas aos campos no documento de registro. Esses campos devem seguir o AF_<name of field in all caps>_XFO convenção de nomenclatura. Por exemplo, o nome do campo da caixa de seleção deve ser AF_CHECKBOX_XFO.

Para criar um template base, faça o seguinte no AEM Designer.

1. Clique em Arquivo > Novo.

2. Selecione o Com base em um modelo opção.

3. Selecione o Forms - Documento de registro categoria.

4. Selecionar Modelo base do DoR.

5. Clique em Próxima e fornecer as informações necessárias.

6. (Opcional) Modifique o estilo e a aparência dos campos que deseja aplicar nos campos do documento de registro.

7. Salve o formulário.

Agora você pode usar o formulário salvo como um modelo base para o documento de registro.
Não modifique ou remova scripts presentes no modelo base.

Modificação do modelo base

• Se você não estiver aplicando nenhum estilo sobre os campos no modelo base, é aconselhável remover esses campos do modelo base para que todas as atualizações do modelo base sejam selecionadas automaticamente.
• Ao modificar o modelo base, não remova, adicione ou modifique scripts.

Documento de configuração modelo de registro

Configure o documento de modelo de registro do seu formulário para permitir que os clientes baixem uma cópia impressa do formulário enviado. Um arquivo XDP serve como o documento do modelo de registro. O documento de download dos clientes do registro é formatado de acordo com o layout especificado no arquivo XDP.

Execute as seguintes etapas para configurar um documento de registro para formulários adaptáveis:

1. Na instância do autor AEM, clique em Forms > Forms e documentos.

2. Selecione um formulário e clique em Propriedades da exibição.

3. Na janela Propriedades, toque em Modelo de formulário.
   Você também pode selecionar um modelo de formulário ao criar um formulário.

   OBSERVAÇÃO

   Na guia Modelo de formulário, selecione Esquema ou Nenhum do Selecionar de menu suspenso. O documento de registro não é compatível com formulários baseados em XFA ou adaptáveis com o Modelo de formulário como modelo de formulário.

4. Na seção Document of Record Template Configuration da guia Form Model, selecione uma das seguintes opções.

   Nenhum Selecione essa opção se não quiser configurar o documento de registro para o formulário.

   Associar o modelo de formulário como o documento de modelo de registro Selecione essa opção se você tiver um arquivo XDP que deseja usar como modelo para o documento de registro. Ao selecionar essa opção, todos os arquivos XDP disponíveis no repositório do AEM Forms são exibidos. Selecione o arquivo apropriado.

   O arquivo XDP selecionado é associado ao formulário adaptável.

   Gerar documento de registro Selecione essa opção para usar um arquivo XDP como modelo base para definir o estilo e a aparência do documento de registro. Ao selecionar essa opção, todos os arquivos XDP disponíveis no repositório do AEM Forms são exibidos. Selecione o arquivo apropriado.

   OBSERVAÇÃO

   Verifique se o esquema usado para criar o formulário adaptável e o esquema (esquema de dados) do Formulário XFA são iguais se:

   * Seu formulário adaptável é baseado em esquema
   * Você está usando **Associar o modelo de formulário como o documento de modelo de registro** opção para documento de registro
   

5. Clique em Concluído.

Personalizar as informações de marca no documento de registro

Ao gerar um documento de registro, você pode alterar as informações de marca do documento de registro na guia Documento de registro. A guia Documento de registro inclui opções como logotipo, aparência, layout, cabeçalho e rodapé, aviso de isenção e se você deseja ou não incluir opções de caixa de seleção e botão de opção não selecionados.

Para localizar as informações de marca inseridas na guia Documento de registro, é necessário garantir que o local do navegador esteja definido adequadamente. Para personalizar as informações de marca do documento de registro, conclua as seguintes etapas:

1. Selecione um painel (painel raiz) no documento de registro e toque em .

2. Toque . A guia Documento de registro é exibida.

3. Selecione o modelo padrão ou um modelo personalizado para renderizar o documento de registro. Se você selecionar o modelo padrão, uma visualização em miniatura do documento de registro será exibida abaixo do menu suspenso Modelo.

   

   Se você optar por selecionar um modelo personalizado, procure e selecione um XDP no servidor do AEM Forms. Se quiser usar um modelo que ainda não esteja no servidor do AEM Forms, primeiro faça upload do XDP para o seu servidor do AEM Forms.

4. Se você selecionar um modelo padrão ou personalizado, algumas ou todas as propriedades a seguir serão exibidas na guia Documento de registro. Especifique esses itens adequadamente:

   • Imagem de logotipo: Você pode optar por usar a imagem de logotipo do formulário adaptável, escolher um do DAM ou fazer upload de um do seu computador.
   • Título do formulário
   • Texto do cabeçalho
   • Rótulo do aviso
   • Aviso
   • Texto do aviso
   • Cor de realce: A cor na qual o texto do cabeçalho e as linhas separadoras são renderizados no PDF do documento ou do registro
   • Família da fonte: Família de fontes do texto no documento de PDF de registro
   • Para os componentes Caixa de seleção e Botão de opções, mostrar apenas os valores selecionados
   • Separador para vários valores selecionados
   • Incluir objetos de formulário que não estão vinculados ao modelo de dados
   • Excluir campos ocultos do documento de registro
   • Ocultar descrição de painéis

   Se o modelo XDP personalizado selecionado incluir várias páginas mestras, as propriedades dessas páginas aparecerão no conteúdo seção do Documento do registro guia.

   

   As propriedades da página principal incluem Imagem de logotipo, Texto do cabeçalho, Título do formulário, Rótulo do aviso e Texto do aviso. Você pode aplicar propriedades de formulário adaptável ou modelo XDP ao documento de registro. Por padrão, o AEM Forms aplica as propriedades do modelo ao Documento de registro. Você também pode definir valores personalizados para as propriedades da página-mestre. Para obter informações sobre como aplicar várias páginas-mestre em um documento de registro, consulte Aplicar várias páginas-mestre a um documento de registro.

   OBSERVAÇÃO

   Se você estiver usando um modelo de formulário adaptável criado com uma versão do Designer anterior à 6.3, para que as propriedades de Cor de ênfase e Família de fontes funcionem, verifique se o seguinte está presente no modelo de formulário adaptável no subformulário raiz:

   <proto>
   <font typeface="Arial"/>
   <fill>
   <color value="4,166,203"/>
   </fill>
   <edge>
   <color value="4,166,203"/>
   </edge>
   </proto>
   

5. Para salvar as alterações de marca, toque em Concluído.

Layouts de tabela e coluna para painéis no documento de registro

O formulário adaptável pode ser longo, com vários campos de formulário. Talvez você não queira salvar um documento de registro como uma cópia exata do formulário adaptável. Agora é possível escolher um layout de tabela ou coluna para salvar um ou mais painéis de formulário adaptáveis no documento de PDF de registro.

Antes de gerar um documento de registro, nas configurações de um painel, selecione Layout do documento de registro desse painel como Tabela ou Coluna. Os campos no painel são organizados de acordo no documento de registro.

Campos em um painel renderizado em um layout de tabela no documento de registro

Campos em um painel renderizado em um layout de coluna no documento de registro

Configurações do documento de registro

As configurações de documento de registro permitem escolher as opções que deseja incluir no documento de registro. Por exemplo, um banco aceita nome, idade, número de seguridade social e número de telefone em um formulário. O formulário gera um número de conta bancária e detalhes da agência. Você pode optar por exibir somente o nome, o número de seguridade social, a conta bancária e os detalhes da agência no documento de registro.

O documento de configurações de registro de um componente está disponível em suas propriedades. Para acessar as propriedades de um componente, selecione o componente e clique em na sobreposição. As propriedades são listadas na barra lateral e você pode encontrar as seguintes configurações.

Configurações de nível de campo

• Excluir do documento de registro: Definir a propriedade como true exclui o campo do documento de registro. Esta é uma propriedade que pode ser gerada por script chamada excludeFromDoR. Seu comportamento depende da Excluir campos de DoR se ocultos propriedade de nível de formulário.

• Exibir painel como tabela: Definir a propriedade exibe o painel como tabela no documento de registro se o painel tiver menos de 6 campos. Aplicável somente para o painel.

• Excluir título do documento de registro: Definir a propriedade exclui o título do painel/tabela do documento de registro. Aplicável somente para painel e tabela.

• Excluir descrição do documento de registro: Definir a propriedade exclui a descrição do painel/tabela do documento de registro. Aplicável somente para painel e tabela.

• Paginação > Local: determina onde colocar o painel.

  • Local > Seguinte Anterior: coloca o painel depois do objeto anterior no painel principal.
  • Local > Na área de conteúdo > Nome da área de conteúdo: coloca o painel na área de conteúdo especificada.
  • Local > Parte superior da próxima área de conteúdo: Coloca o painel na parte superior da próxima área de conteúdo.
  • Local > Parte superior da área de conteúdo > Nome da área de conteúdo: coloca o painel na parte superior da área de conteúdo especificada.
  • Local > Na página > Nome da página-mestre: coloca o painel na página especificada. Se uma quebra de página não for inserida automaticamente, AEM Forms adiciona uma quebra de página.
  • Local > Parte superior da próxima página: coloca o painel na parte superior da próxima página. Se uma quebra de página não for inserida automaticamente, AEM Forms adiciona uma quebra de página.
  • Local > Início da página > Nome da página-mestre: coloca o painel na parte superior da página quando a página especificada é renderizada. Se uma quebra de página não for inserida automaticamente, AEM Forms adiciona uma quebra de página.

• Paginação > Depois: determina qual área deve ser preenchida depois que um painel é posicionado. Os seguintes campos estão disponíveis na Depois seção:

  • Depois > Continuar preenchendo o pai: continua mesclando os dados de todos os objetos que ainda não foram preenchidos no painel principal.
  • Depois > Ir para a próxima área de conteúdo: começa a preencher a próxima área de conteúdo depois de posicionar o painel.
  • Depois > Ir para área de conteúdo > Nome da área de conteúdo: começa a preencher a área de conteúdo especificada depois de colocar o painel.
  • Depois > Ir para a próxima página: começa a preencher a próxima página após colocar o painel.
  • Depois > Ir para página > Nome da página: começa a preencher a página especificada depois de colocar o painel.

• Paginação > Estouro: define um estouro para um painel ou uma tabela que abrange páginas. Os seguintes campos estão disponíveis no Estouro seção:

  • Estouro > Nenhum: começa a preencher a próxima página. Se uma quebra de página não for inserida automaticamente, AEM Forms adiciona uma quebra de página.
  • Estouro > Ir para a área de conteúdo > Nome da área de conteúdo: começa a preencher a área de conteúdo especificada.
  • Estouro > Ir para página > Nome da página: começa a preencher a página especificada.

Para obter informações sobre como aplicar quebras de página e aplicar várias páginas-mestre em um documento de registro, consulte Aplicar quebra de página em um documento de registro e Aplicar várias páginas-mestre a um documento de registro.

Configurações do nível de formulário

• Incluir campos desatados em DoR: A configuração da propriedade inclui campos não vinculados do formulário adaptável baseado em esquema no documento de registro. Por padrão, é verdadeiro.
• Excluir campos de DoR se ocultos: Definir a propriedade da qual excluir os campos ocultos Documento do registro no envio do formulário. Quando você habilita Revalidar no servidor, o servidor recalcula os campos ocultos antes de excluir esses campos da Documento do registro.

Aplicar uma quebra de página em um documento de registro

Você pode aplicar quebras de página em um Documento de registro usando vários métodos.

Para aplicar uma quebra de página a um documento de registro:

1. Toque no painel e selecione

2. Expandir Documento do registro para exibir as propriedades.

3. No Paginação seção, toque em no Local campo.

4. Toque Parte superior da próxima página e toque em Selecionar. Você também pode tocar em Início da página, selecione a página mestra e toque em Selecionar para aplicar a quebra de página.

5. Toque em para salvar as propriedades.

O painel selecionado é movido para a próxima página.

Aplicar várias páginas-mestre a um documento de registro

Se o modelo XDP personalizado selecionado incluir várias páginas mestras, as propriedades dessas páginas aparecerão no conteúdo seção do Documento do registro guia. Para obter mais informações, consulte Personalizar as informações de marca no documento de registro.

Você pode aplicar várias páginas-mestre a um documento de registro aplicando páginas-mestre diferentes aos componentes de um formulário adaptável. Use o Paginação seção das propriedades do documento de registro para aplicar várias páginas-mestre.

Este é um exemplo de como aplicar várias páginas-mestre a um Documento de registro: você faz upload de um modelo XDP que inclui quatro páginas-mestre para o AEM Forms servidor. AEM Forms O aplica as propriedades do modelo ao Documento de registro por padrão. AEM Forms O também aplica as propriedades da primeira página-mestre no modelo ao documento de registro.

Para aplicar as propriedades da segunda página-mestre a um painel e as propriedades da terceira página-mestre aos painéis seguintes, execute as seguintes etapas:

1. Toque no painel para aplicar a segunda página-mestre e selecione .
2. No Paginação seção, toque em no Local campo.
3. Toque Na página, selecione a segunda página-mestre e toque em Selecionar.
   O AEM Forms aplica a segunda página-mestre ao painel e a todos os painéis subsequentes no formulário adaptável.
4. No Paginação seção, toque em no Depois campo.
5. Toque Ir para página, selecione a terceira página-mestre e toque em Selecionar.
6. Toque em para salvar as propriedades.
   O AEM Forms aplica a terceira página-mestre ao painel e a todos os painéis subsequentes no formulário adaptável.

Considerações principais ao trabalhar com documento de registro

Lembre-se das seguintes considerações e limitações ao trabalhar em um documento de registro para formulários adaptáveis.

• Os modelos de documento de registro não dão suporte a rich text. Portanto, qualquer rich text no formulário adaptável estático ou nas informações preenchidas pelo usuário final aparece como texto simples no documento de registro.
• Fragmentos de documento em um formulário adaptável não aparecem no documento de registro. No entanto, os fragmentos de formulário adaptáveis são compatíveis.
• Não há suporte para a associação de conteúdo no documento de registro gerado para o formulário adaptável baseado em esquema XML.
• A versão localizada do documento de registro é criada sob demanda para um local quando o usuário solicita a renderização do documento de registro. A localização do documento de registro ocorre juntamente com a localização do formulário adaptável. Para obter mais informações sobre a localização do documento de registro e formulários adaptáveis, consulte Uso do fluxo de trabalho de tradução do AEM para localizar formulários adaptáveis e documentos de registro.

Recursos do Business.Adobe.com

Multichannel Communication Auto Form Fill Personalized Experiences Customer Communications Web Content Management Dynamic Forms