[AEM Forms]{class="badge positive" title="Aplicável ao AEM Forms)."}
Gerar um PDF de envio (antigo Documento de registro) para o Adaptive Forms
Visão geral overview
Quando um formulário é preenchido ou enviado, você pode manter um registro do formulário, impresso ou no formato do documento. Esse registro é chamado de PDF de envio (antigo Documento de registro ou DoR). É um PDF para impressão do formulário enviado. Você também pode consultar o PDF de envio para obter as informações que os clientes preencheram posteriormente ou usar o PDF de envio para arquivar formulários e conteúdo juntos no formato PDF.
Para criar uma PDF de envio, um modelo baseado em XFA ou acroforma é mesclado com os dados coletados por meio de um formulário adaptável. Você pode gerar um PDF de envio automaticamente ou sob demanda.
A opção sob demanda permite especificar um modelo XFA ou baseado em acroforma personalizado para fornecer uma aparência personalizada ao seu PDF de envio.
É possível:
Antes de começar components-to-automatically-generate-a-document-of-record
Antes de começar a aprender e preparar os ativos necessários para uma PDF de envio:
Modelo base: um modelo XFA (arquivo XDP) criado no Forms Designer ou em um formulário Acrobat (AcroForm). O Modelo base é usado para especificar informações de estilo e identidade visual para uma PDF de Envio. Faça upload do modelo XFA (arquivo XDP) na instância do AEM Forms antes de
Formulário adaptável: um Formulário adaptável para o qual o PDF de Envio deve ser gerado.
Gerar uma PDF de envio com base em XFA generate-an-XFA-based-document-of-record
Faça upload do modelo XFA (arquivo XDP) na instância do AEM Forms. Execute as seguintes etapas para configurar um Formulário adaptável para usar o modelo XFA (arquivo XDP) como modelo para o PDF de envio:
- Na instância do autor do Experience Manager, clique em Forms > Forms e Documentos.
- Selecione um formulário e clique em Propriedades.
- Na janela Propriedades, selecione Modelo de formulário.
- Na guia Modelo de Formulário, no menu suspenso Selecionar de, selecione Esquema ou Nenhum. Você também pode selecionar um modelo de formulário ao criar um formulário.
- Na seção Document of Record Template Configuration da guia Form Model, selecione Associar Modelo de Formulário como Documento de Modelo de Registro. Ao selecionar essa opção, todos os modelos XFA (arquivos XDP) disponíveis em sua máquina são exibidos. Selecione o arquivo apropriado. Além disso, verifique se o mesmo esquema (esquema de dados) é usado para o Formulário adaptável e o modelo XFA selecionado (arquivo XDP).
- Clique em Concluído
O formulário adaptável agora está configurado para usar um arquivo XDP como modelo para PDF de envio. A próxima etapa é vincular componentes do Formulário adaptável com campos de modelo correspondentes.
Gerar uma PDF de envio com base em acroforma generate-an-Acroform-based-document-of-record
Faça upload do Adobe Acrobat PDF (Acrobat) na sua instância do AEM Forms. Execute as seguintes etapas para configurar um Formulário adaptável para usar o Adobe Acrobat PDF (AcroForm) como modelo para o Submission PDF:
- Na instância do autor do Experience Manager, clique em Forms > Forms e Documentos.
- Selecione um formulário e clique em Propriedades.
- Na janela Propriedades, selecione Modelo de formulário.
- Na guia Modelo de Formulário, no menu suspenso Selecionar de, selecione Esquema ou Nenhum. Você também pode selecionar um modelo de formulário ao criar um formulário.
- Na seção Document of Record Template Configuration da guia Form Model, selecione Associar Modelo de Formulário como Documento de Modelo de Registro. Ao selecionar essa opção, todas as Acrobat PDF (Acrobat) disponíveis em sua máquina são exibidas. Selecione o arquivo apropriado.
- Clique em Concluído
O formulário adaptável agora está configurado para usar um acroforma como modelo para o PDF de envio. A próxima etapa é vincular componentes do Formulário adaptável com campos de modelo correspondentes.
Gerar automaticamente uma PDF de envio auto-generate-a-document-of-record
Quando um Formulário adaptável é configurado para gerar automaticamente um PDF de envio, sempre que um formulário é alterado, seu PDF de envio é atualizado imediatamente. Por exemplo, se um campo for removido de um formulário adaptável existente, o campo correspondente também será removido e não estará visível no PDF de envio. Existem muitas outras vantagens de gerar automaticamente uma PDF de envio:
- Os desenvolvedores de formulários não precisam manter as associações de dados manualmente. O Submission PDF gerado automaticamente cuida das atualizações relacionadas à vinculação de dados.
- Os desenvolvedores de formulários não precisam ocultar manualmente os campos marcados como excluir do PDF de envio. As PDF de envio geradas automaticamente são pré-configuradas para excluir esses campos.
- A opção Submission PDF gerada automaticamente economiza tempo necessário para criar um modelo de Formulário para PDF de envio.
- A opção Submission PDF gerada automaticamente permite usar estilos e aparências diferentes usando modelos base diferentes. Ele ajuda a selecionar o melhor estilo e aparência para o PDF de envio para sua organização. Se você não especificar o estilo, os estilos do sistema serão definidos como padrão.
- O Submission PDF gerado automaticamente garante que qualquer alteração no formulário seja refletida imediatamente no Submission PDF.
Execute as seguintes etapas para configurar um Formulário adaptável para gerar automaticamente uma PDF de envio:
- Na instância do autor do Experience Manager, clique em Forms > Forms e Documentos.
- Selecione um formulário e clique em Propriedades.
- Na janela Propriedades, selecione Modelo de formulário.
- Na guia Modelo de Formulário, no menu suspenso Selecionar de, selecione Esquema ou Nenhum. Você também pode selecionar um modelo de formulário ao criar um formulário.
- Na seção Document of Record Template Configuration da guia Form Model, selecione Gerar Documento de Registro.
- Clique em Concluído
Vincular componentes do formulário adaptável a campos de modelo bind-adaptive-form-components-with-template-fields
Vincule campos de formulário adaptável com campos de modelo para exibir dados de formulário capturados no campo PDF de envio correspondente. Para vincular componentes do Formulário adaptável aos campos de modelo do PDF de envio correspondentes:
-
Abra o Formulário adaptável, configurado para usar um modelo de formulário personalizado para edição.
-
Selecione um componente de Formulário adaptável e clique em abrir o ícone Configurar
. Ele abre o navegador de propriedades. -
No navegador de propriedades, navegue e selecione um campo.
- (Para o modelo AcroForm) a propriedade campo Referência de Associação de Documento de Registro.
- (Para modelo XFA) a propriedade Referência de Associação de Modelo de Dados.
-
Clique em Salvar.
Você pode usar Enviar Email, a ação de envio do Fluxo de Trabalho do Experience Manager juntamente com a etapa Documento de Registro e outras ações de envio para receber uma PDF de Envio.
Atualizações incrementais no modelo de PDF de envio document-of-record-template-incremental-updates
Os formulários adaptáveis e os modelos de PDF de envio correspondentes podem evoluir ao longo do tempo. Você pode optar por adicionar, remover ou modificar campos para um formulário adaptável ou um modelo de PDF de envio.
Ao alterar um modelo de PDF de envio e fazer upload do modelo alterado para o AEM Forms, o editor do Adaptive Forms detecta automaticamente as associações alteradas e informa sobre os componentes de formulário adaptáveis que exigem novas associações. Ele permite fazer atualizações incrementais em um modelo de PDF de envio.
Por exemplo, uma organização, We.Retail, tem um modelo de PDF de envio baseado em AcroForm, we-retail-Invoice.pdf. O modelo tem a seguinte aparência:
Depois de usar o modelo por algum tempo, a organização decide renomear o campo invoice-number para o campo bill-number e capturar o endereço de email dos compradores. Um desenvolvedor atualiza o nome do campo invoice-number e adiciona um campo de email ao modelo. Ele também cria uma nova versão do modelo chamada we-retail-Invoice-v2.pdf.
O desenvolvedor faz upload e se aplica ao modelo atualizado para o formulário adaptável. O formulário adaptável detecta e exibe automaticamente uma lista de campos em que a associação foi alterada.
O desenvolvedor do formulário vincula os campos do Adaptive Forms ao modelo Submission PDF correspondente.
Agora, quando o Formulário adaptável for enviado, um PDF de envio atualizado será criado.
Considerações principais ao trabalhar com o Submission PDF key-considerations-when-working-with-document-of-record
Lembre-se das seguintes considerações e limitações ao trabalhar no PDF de envio para o Adaptive Forms.
- Suporte a rich text: o PDF de envio oferece suporte a marcas de marcação HTML em campos de rich text. Para obter detalhes completos sobre as marcas com suporte e considerações de acessibilidade, consulte Marcações do HTML com suporte no Submission PDF.
- Fragmentos de documento em um Formulário adaptável não aparecem no PDF de envio. No entanto, os fragmentos de formulário adaptável são compatíveis.
- A vinculação de conteúdo no Submission PDF gerado para o Formulário adaptável baseado em esquema XML não é suportada.
- A versão localizada do PDF de envio é criada sob demanda para um local quando o usuário solicita a renderização do PDF de envio. A localização do PDF de envio ocorre junto com a localização do Formulário adaptável.
Mapeamento de elementos do formulário adaptável mapping-of-adaptive-form-elements
A tabela a seguir descreve os componentes do Formulário adaptável e os componentes XFA correspondentes e se eles aparecem em uma PDF de envio.
Campos fields
Contêineres containers
Componentes estáticos static-components
Tabelas tables
Os componentes da tabela Adaptive Forms, como cabeçalho, rodapé e mapa de linhas para componentes XFA correspondentes. Você pode mapear painéis repetíveis para tabelas no PDF de envio.
Modelo base de uma PDF de envio base-template-of-a-document-of-record
O modelo base fornece informações de estilo e aparência para o PDF de envio. Ela permite personalizar a aparência padrão do Submission PDF gerado automaticamente. Por exemplo, você pode usar o modelo base para adicionar o logotipo da sua empresa nas informações de cabeçalho e direitos autorais no rodapé do PDF de envio.
A página mestra do modelo base é usada como uma página mestra do modelo PDF de envio. A página mestra pode ter informações como cabeçalho, rodapé e número de página que podem ser aplicadas ao Submission PDF. É possível aplicar essas informações ao PDF de envio usando o modelo base para a geração automática do PDF de envio. O uso do template base permite alterar as propriedades padrão dos campos.
Sempre siga as Convenções do modelo base ao criar o modelo base.
Convenções do modelo base base-template-conventions
Um modelo base é usado para definir o cabeçalho, rodapé, estilo e aparência de um PDF de envio. 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 PDF de envio, que contém o cabeçalho, o rodapé, o número da página ou qualquer outra informação que deve aparecer em todas as páginas do PDF de envio. Se você usar 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 modelo de PDF de envio. É altamente recomendável que você projete seu modelo base de acordo com suas convenções e o use para a geração automática do Submission PDF.
Convenções de página mestra
-
No modelo base, nomeie o subformulário raiz como
AF_METATEMPLATEe a página mestra comoAF_MASTERPAGE. -
A página mestra com o nome
AF_MASTERPAGE, localizada no subformulário raizAF_METATEMPLATE, é preferível para extrair informações de cabeçalho, rodapé e estilo. -
Se
AF_MASTERPAGEestiver ausente, a primeira página mestra presente no modelo base será usada.
Convenções de estilo para campos
-
Para aplicar estilo nos campos no PDF de Envio, o modelo base fornece campos localizados no subformulário
AF_FIELDSSUBFORMsob o subformulário raizAF_METATEMPLATE. -
As propriedades desses campos são aplicadas aos campos no PDF de envio. Esses campos devem seguir a convenção de nomenclatura
AF_<name of field in all caps>_XFO. Por exemplo, o nome do campo da caixa de seleção deve serAF_CHECKBOX_XFO.
Para criar um template base, faça o seguinte no Forms Designer.
-
Clique em Arquivo > Novo.
-
Selecione a opção Baseado em um modelo.
-
Selecione a categoria Forms - Documento de Registro.
-
Selecione Modelo Base DoR.
-
Clique em Avançar e forneça as informações necessárias.
-
(Opcional) Modifique o estilo e a aparência dos campos que deseja aplicar nos campos do PDF de envio.
-
Salve o formulário.
Agora você pode usar o formulário salvo como um modelo base para o PDF de envio. Não modifique ou remova scripts presentes no modelo base.
Modificando modelo base
- Se não aplicar 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.
Siga rigorosamente as convenções e instruções mencionadas acima para criar um modelo base.
Personalizar as informações sobre a marca no Submission PDF customize-the-branding-information-in-document-of-record
Ao gerar uma PDF de Envio, você pode alterar as informações de marca da PDF de Envio 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, certifique-se de que o local do navegador esteja definido adequadamente. Para personalizar as informações sobre marca do PDF de Submissão, execute as seguintes etapas:
-
Selecione um painel (painel raiz) no PDF de Envio e, em seguida, selecione
.
-
Selecione
. A guia Documento de registro é exibida.
-
Selecione o template padrão ou um template personalizado para renderizar o PDF de envio. Se você selecionar o modelo padrão, uma pré-visualização em miniatura do PDF de envio será exibida abaixo do menu suspenso Modelo.
-
Se você selecionar um modelo padrão ou personalizado, algumas das propriedades a seguir, ou todas as propriedades, serão exibidas na guia Documento de registro. Especifique as propriedades mencionadas abaixo para definir a aparência do PDF de envio:
-
Propriedades básicas:
-
Modelo: se você optar por selecionar um modelo personalizado, procure um XDP selecionado no servidor AEM Forms. Se quiser usar um modelo que ainda não esteja no servidor AEM Forms, primeiro carregue o XDP no servidor AEM Forms.
-
Cor de Ênfase: a cor na qual o texto do cabeçalho e as linhas de separador são renderizados na PDF de Envio.
-
Família da Fonte: Família da fonte do texto no PDF de Envio.
note note NOTE O AEM Forms oferece uma variedade de fontes integradas que se integram perfeitamente aos arquivos PDF. Para ver a lista de fontes com suporte, clique aqui. -
Incluir objetos de formulário que não estão associados ao modelo de dados: a configuração da propriedade inclui campos desassociados do Formulário adaptável baseado em esquema no Submission PDF.
-
Excluir campos ocultos do Documento de Registro: a definição da propriedade identifica os campos ocultos para exclusão do PDF de Envio.
-
Ocultar descrição de painéis: definir a propriedade exclui a descrição do painel/tabela do PDF de Envio. Aplicável para painel e tabela.
-
-
Propriedades do Campo de Formulário:
- Para os componentes da Caixa de Seleção e do Botão de Opção, mostrar apenas os valores selecionados: a configuração da propriedade exibe apenas os valores selecionados da caixa de seleção e do botão de opção em Documento de Registro.
- Separador para vários valores: você pode escolher qualquer separador como vírgula ou quebra de linha para exibir vários valores.
- Alinhamento de Opções: Você pode selecionar o alinhamento desejado (Horizontal, Vertical, Igual ao Formulário adaptável) para definir o alinhamento dos campos, como caixa de seleção ou botão de opção, a serem exibidos em Documento de Registro. Por padrão, o alinhamento vertical é definido para os campos em Documento de registro. Definir as propriedades das Propriedades do Campo de Formulário de DoR substitui as propriedades definidas no Alinhamento de Itens para os campos em um Formulário adaptável. Caso você selecione a opção Igual ao formulário adaptável, o alinhamento conforme configurado em uma instância de autor do formulário adaptável será usado para os campos Documento de registro.
- Número de opções de alinhamento horizontal:You pode definir o número de opções a serem exibidas no PDF de Envio para o alinhamento horizontal.
Exibir rótulos para a lista suspensa de várias seleções
Esse recurso está disponível por meio do programa de acesso antecipado. Para solicitar acesso, envie um email de seu endereço oficial para aem-forms-ea@adobe.com.
O PDF de envio agora exibe os rótulos de exibição selecionados para componentes suspensos de seleção múltipla em vez de valores armazenados internos. Por exemplo, se um usuário selecionar "Califórnia" e "Nova York" em uma lista suspensa, a PDF de envio mostrará os rótulos selecionados em vez dos valores internos, como
CAeNY. -
Propriedades da Página Mestra:
- Imagem de logotipo: você pode optar por usar a imagem de logotipo do Formulário adaptável, escolher uma do DAM ou carregar uma do seu computador.
- Título do Formulário: Título do DoR.
- Texto do Cabeçalho: texto que aparece na seção de cabeçalho do PDF de Envio.
- Rótulo do aviso: Rótulo do aviso.
- Aviso de Isenção de Responsabilidade: texto que especifica o escopo de direitos e obrigações no PDF de Envio.
- Texto do aviso: texto do aviso.
-
-
Para salvar as alterações de identidade visual, selecione Concluído.
- Aparece no cabeçalho do PDF gerado
- Aparece como o Título nas propriedades do documento do PDF
- Aparece como o Título da exibição inicial quando a PDF é aberta
Suporte a documento de registro no editor de formulário adaptável dor-support-in-adaptiveform
Você pode configurar o modelo Documento de registro diretamente do editor de modelo de Formulário adaptável ou do editor de modelo de Formulário adaptável.
Execute as seguintes etapas a partir da instância de autor do editor de Formulário adaptável:
-
Selecione o componente Container de Formulário Adaptável (raiz).
-
Clique no
para abrir as Propriedades do container do formulário adaptável. -
Abra a guia Documento do Modelo de Registro e selecione uma das seguintes opções:
- Nenhum: quando esta opção é selecionada em um modelo de Documento de Registro criado para o formulário adaptável.
- Associar Modelo de Formulário como Documento de Modelo de Registro:When essa opção está selecionada, o Formulário XFA é usado como modelo para PDF de Envio.
- Gerar documento de registro: quando esta opção é selecionada, o modelo documento de registro é gerado automaticamente para o formulário adaptável.
-
Selecione
para salvar as propriedades.
Layouts de tabela e coluna para painéis no PDF de envio table-and-column-layouts-for-panels-in-document-of-record
O formulário adaptável pode ser longo, com vários campos de formulário. Talvez você não queira salvar uma PDF de envio 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 do Formulário adaptável no PDF de envio.
Antes de gerar um PDF de envio, 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 PDF de envio.
Campos em um painel renderizado em um layout de tabela no PDF de envio
Campos em um painel renderizado em um layout de coluna no PDF de envio
Configurações do PDF de envio document-of-record-settings
As configurações de PDF de envio permitem escolher as opções que deseja incluir no PDF de envio. 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 do seguro social, a conta bancária e os detalhes da agência no Submission PDF.
A configuração do componente Documento de registro está disponível em suas propriedades. Para acessar as propriedades de um componente, selecione o componente e clique em
Configurações de nível de campo
-
Excluir do documento de registro: definir a propriedade true exclui o campo do PDF de envio. Esta é uma propriedade que pode ser gerada por script chamada
excludeFromDoR. Seu comportamento depende de Excluir campos do DoR se ocultos propriedade de nível de formulário. -
Exibir painel como tabela: Definir a propriedade exibe o painel como tabela no PDF de Envio se o painel tiver menos de 6 campos. Aplicável somente para o painel.
-
Excluir título do documento de registro: a configuração da propriedade exclui título do painel/tabela do PDF de envio. Aplicável somente para painel e tabela.
-
Excluir descrição do Documento de Registro: A configuração da propriedade exclui a descrição do painel/tabela do PDF de Envio. Aplicável somente para painel e tabela.
Configurações de nível de formulário
- Incluir campos desatados em DoR: A configuração da propriedade inclui campos desatados do Formulário adaptável baseado em esquema no Submission PDF. Por padrão, é verdadeiro.
- Excluir campos do DoR se ocultos: Defina a propriedade para excluir os campos ocultos do PDF de Envio no envio do formulário. Quando você habilita Revalidar no servidor, o servidor recalcula os campos ocultos antes de excluir esses campos da PDF de Envio.
Usar um arquivo XCI personalizado
Um arquivo XCI ajuda a definir várias propriedades de um documento. O Forms as a Cloud Service tem um arquivo XCI principal. Você pode usar um arquivo XCI personalizado para substituir uma ou mais propriedades padrão especificadas no arquivo XCI mestre. Por exemplo, você pode optar por incorporar uma fonte em um documento ou ativar a propriedade marcada para todos os documentos. A tabela a seguir especifica as opções de XCI:
Usar um arquivo XCI personalizado no ambiente as a Cloud Service do Forms
-
Adicione o arquivo XCI personalizado ao projeto de desenvolvimento.
-
Especifique a seguinte propriedade embutida:
code language-json { "xciFilePath": "[path of XCI file]" }Por exemplo,
code language-json { "xciFilePath": "/content/dam/formsanddocuments/customMinionProBoldAndTagged.xci" } -
Implante o projeto no seu ambiente do Cloud Service.
Usar um arquivo XCI personalizado no ambiente de desenvolvimento local do Forms as a Cloud Service
- Carregue o arquivo XCI no ambiente de desenvolvimento local.
- Abra o gerenciador de configurações do Cloud Service SDK. A URL padrão é: http://localhost:4502/system/console/configMgr.
- Localize e abra a configuração Forms adaptável e Canal da Web de comunicação interativa.
- Especifique o caminho do arquivo XCI e clique em Salvar.
Perguntas frequentes faq
P: as alterações não estão aparecendo no PDF de Envio.
Ans: Abra o formulário no editor do Adaptive Forms, faça uma pequena edição (por exemplo, ajuste um rótulo de campo ou reordene um campo) e salve o formulário. Isso gera novamente o modelo de PDF de envio e as alterações aparecem no próximo PDF gerado.
Consulte também see-also
- Criar um formulário adaptável do AEM
- Adicionar um formulário adaptável do AEM à página do AEM Sites
- Aplicar temas a um formulário adaptável do AEM
- Adicionar componentes a um Formulário adaptável do AEM
- Usar CAPTCHA em um formulário adaptável do AEM
- Gerar uma versão do PDF (DoR) de um formulário adaptável do AEM
- Traduzir um formulário adaptável do AEM
- Ativar o Adobe Analytics para um formulário adaptável para rastrear o uso do formulário
- Conectar o formulário adaptável ao Microsoft SharePoint
- Conectar o formulário adaptável ao Microsoft Power Automate
- Conectar o formulário adaptável ao Microsoft OneDrive
- Conectar o formulário adaptável ao armazenamento de blobs do Microsoft Azure
- Conectar o formulário adaptável ao Salesforce
- Usar o Adobe Sign em um formulário adaptável do AEM
- Adicionar uma nova localidade para um Formulário adaptável
- Enviar dados do Formulário adaptável a um banco de dados
- Enviar dados do formulário adaptável para um endpoint REST
- Enviar dados do formulário adaptável para o fluxo de trabalho do AEM
- Use o Forms Portal para listar o AEM Adaptive Forms em um site do AEM
- Adicionar versões, comentários e anotações a um Formulário adaptável
- Comparar Forms adaptável