Show Menu
TÓPICOS×

Serviço do Forms

Visão geral

O serviço Forms permite criar aplicativos clientes de captura de dados interativos que validam, processam, transformam e entregam formulários normalmente criados no Designer. O serviço Forms renderiza como documentos PDF qualquer design de formulário desenvolvido.
O serviço de formulários também permite que as organizações estendam seus processos de captura de dados inteligente ao implantar formulários eletrônicos como Adobe PDFs. Também é possível usar o serviço para importar e exportar dados de e para formulários PDF existentes, respectivamente.
Use o serviço Formulários para fazer o seguinte:
  • Renderize formulários PDF com base no modelo e nos dados XML.
  • Permitir que a integração de dados de formulário importe dados para formulários PDF e extraia dados deles.
  • Renderize formulários com base em fragmentos.

Criação de formulários PDF

Use o serviço de Formulário para criar formulários PDF para captura de dados. Normalmente, você começa com um modelo do AEM Forms Designer. Use a operação renderPDFForm (link para Javadoc) do serviço de Formulários para converter esse modelo em um formulário PDF.
O primeiro parâmetro da renderPDFForm operação é o nome do arquivo de modelo (por exemplo, ExpenseClaim.xdp ). Você pode armazenar o arquivo de modelo em um sistema de arquivos local, repositório CRX ou em um local HTTP ou FTP. Você pode especificar o local do arquivo de modelo definindo a raiz do conteúdo no PDFFormRenderOptions parâmetro da renderPDFForm operação. Consulte Javadoc para obter detalhes sobre outras opções que podem ser especificadas para o PDFFormRenderOptions parâmetro.
A renderPDFForm operação também pode aceitar dados XML. Os dados XML são unidos ao modelo ao criar um formulário PDF para que o formulário PDF gerado contenha os dados especificados. O segundo parâmetro para a renderPDFForm operação pode aceitar um objeto Document (Javadoc) que contenha dados XML.

Extrair dados de formulários PDF

Use a operação exportData (Javadoc) do serviço de Formulários para extrair dados XML de um formulário PDF. Esta operação aceita um documento como seu primeiro parâmetro. É possível exportar os dados como um documento XDP ou um arquivo XML. Se você exportar os dados como um arquivo XML, os dados exportados removerão o envelope XDP e retornarão um arquivo XML simples. Você pode especificar essa disposição usando o segundo parâmetro.

Importação de dados para formulários PDF

O serviço de formulários também permite mesclar um formulário PDF criado usando o AEM Forms Designer ou a renderPDFForm operação com dados XML. A operação importData (Javadoc) do serviço Forms aceita o formulário PDF e os dados XML e retorna um formulário PDF com XML de dados.

Como renderizar formulários com base em fragmentos

O serviço de formulários pode renderizar formulários com base em fragmentos criados por você usando o AEM Forms Designer. Um fragmento é uma parte reutilizável de um formulário. Ele é salvo como um arquivo XDP separado que pode ser inserido em vários designs de formulário. Por exemplo, um fragmento pode incluir um bloco de endereço ou texto legal.
O uso de fragmentos simplifica e acelera a criação e a manutenção de um grande número de formulários. Ao criar um formulário, insira uma referência ao fragmento necessário para que o fragmento apareça no formulário. A referência do fragmento contém um subformulário que aponta para o arquivo XDP físico.
Estas são as vantagens do uso de fragmentos:
  • Reutilização de conteúdo: É possível reutilizar o conteúdo em vários designs de formulário. Para reutilizar rapidamente partes do mesmo conteúdo em vários formulários, crie um fragmento. A cópia ou recriação do conteúdo leva mais tempo. O uso de fragmentos também garante que as partes de um design de formulário usadas frequentemente possuam conteúdo e aparência consistentes em todos os formulários de referência.
  • Atualizações globais: É possível fazer alterações globais em vários formulários apenas uma vez em um arquivo. É possível alterar o conteúdo, objetos de script, vínculos de dados, layout ou estilos em um fragmento. Todos os formulários XDP que fazem referência ao fragmento refletem as alterações.
  • Criação de formulários compartilhados: É possível compartilhar a criação de formulários entre vários recursos. Os desenvolvedores de formulários com experiência em scripts ou outros recursos avançados do AEM Forms Designer podem desenvolver e compartilhar fragmentos que usam propriedades dinâmicas e de scripts. Os designers de formulário podem usar os fragmentos para criar formulários. Além disso, eles podem usar os fragmentos para garantir que todas as partes de um formulário tenham uma aparência e funcionalidade consistentes em vários formulários.