Show Menu
TÓPICOS×

Sincronização de formulários adaptáveis com modelos de formulário XFA

Introdução

Você pode criar um formulário adaptável com base em um modelo de formulário XFA ( *.XDP arquivo). Essa reutilização permite preservar seu investimento em formulários XFA existentes. Para obter informações sobre como usar um modelo de formulário XFA para criar um formulário adaptável, Crie um formulário adaptável com base em um modelo .
É possível reutilizar campos do arquivo XDP no formulário adaptável. Esses campos são chamados de campos vinculados. As propriedades dos campos vinculados (como scripts, rótulos e formato de exibição) são copiadas do arquivo XDP. Você também pode optar por substituir o valor de algumas dessas propriedades.
O AEM Forms fornece uma maneira de ajudar a manter os campos dos formulários adaptáveis sincronizados com quaisquer alterações feitas posteriormente nos campos correspondentes no arquivo XDP. Este artigo explica como ativar essa sincronização.
No ambiente de criação do AEM Forms, é possível arrastar campos de um formulário XFA (à esquerda) para um formulário adaptável (à direita)

Pré-requisitos

Para usar as informações neste artigo, recomenda-se uma familiaridade com as seguintes áreas:
Para usar os ativos fornecem o exemplo no artigo, baixe o pacote de amostra como explicado na próxima seção, Pacote de amostra.

Pacote de amostra

O artigo usa um exemplo para demonstrar como sincronizar o formulário adaptável com um modelo de formulário XFA atualizado. Os ativos usados no exemplo estão disponíveis em um pacote, que pode ser baixado da seção Downloads neste artigo.
Após carregar o pacote, você pode exibir esses ativos na interface do usuário do AEM Forms.
Instale o pacote usando o gerenciador de pacote: https://<server>:<port>/crx/packmgr/index.jsp
O pacote contém os seguintes ativos:
  1. sample-form.xdp : O modelo de formulário XFA usado como exemplo
  2. sample-xfa-af : O formulário adaptável com base no arquivo sample-form.xdp. Entretanto, esse formulário adaptável não inclui nenhum campo. Na próxima etapa, adicionaremos conteúdo a este formulário adaptável.

Adicionar conteúdo ao formulário adaptável

  1. Navegue até https://<servidor>:<porta>/aem/forms.html. Digite suas credenciais, se solicitado.
  2. Abra o exemplo-af-xfa para edição no modo de autor.
  3. Na barra lateral do navegador de conteúdo, escolha a guia Objetos do modelo de dados. Arraste NumericField1 e TextField1 para o Formulário adaptável.
  4. Altere o Título de NumericField1 de Numeric Field para AF Numeric Field.
Nas etapas anteriores, substituímos uma propriedade de um campo no arquivo XDP. Portanto, essa propriedade não será sincronizada se a propriedade correspondente no arquivo XDP for modificada posteriormente.

Detecção de alterações no arquivo XDP

Sempre que houver qualquer alteração em um arquivo XDP ou em um fragmento, a interface do usuário do AEM Forms sinaliza todos os formulários adaptáveis que são baseados no arquivo XDP ou no fragmento.
Após atualizar um arquivo XDP, é necessário carregá-lo novamente na interface do usuário do AEM Forms para que as alterações sejam sinalizadas.
Por exemplo, atualizemos o sample-form.xdp arquivo usando as seguintes etapas:
  1. Navegue até https://<server>:<port>/projects.html. Insira suas credenciais, se solicitado.
  2. Clique na guia Formulários à esquerda.
  3. Baixe o sample-form.xdp arquivo em sua máquina local. O arquivo XDP é baixado como um .zip arquivo, que pode ser extraído usando qualquer utilitário de descompactação de arquivo.
  4. Abra o sample-form.xdp arquivo e altere o título do campo TextField1 de Campo de texto para Meu campo de texto.
  5. Faça upload do sample-form.xdp arquivo de volta para a interface do usuário do AEM Forms.
Se um arquivo XDP for atualizado, você verá um ícone no editor, ao editar os formulários adaptáveis com base no arquivo XDP. Este ícone indica que o formulário adaptável está dessincronizado com o arquivo XDP. Na imagem a seguir, consulte o ícone ao lado na barra lateral.

Sincronizar formulários adaptáveis com o arquivo XDP mais recente

Quando um formulário adaptável que não esteja sincronizado com o arquivo XDP for aberto para criação na próxima vez, a seguinte mensagem será exibida: O modelo de esquema/formulário para o formulário adaptável foi atualizado. Click Here para rebaseá-lo na nova versão.
Clicar na mensagem sincroniza os campos no formulário adaptável com os campos correspondentes no arquivo XDP.
Para o exemplo usado neste artigo, abra sample-xfa-af no modo de criação. A mensagem é exibida na parte inferior do formulário adaptável.

Atualização das propriedades

Todas as propriedades que foram copiadas do arquivo XDP para o formulário adaptativo são atualizadas, exceto as propriedades que foram explicitamente substituídas no formulário adaptável (da caixa de diálogo Componente) pelo Autor. A lista de propriedades que foram atualizadas está disponível nos registros do servidor.
Para atualizar as propriedades no formulário adaptável de exemplo, clique no link (rotulado "Click Here" ) na mensagem. O título de TextField1 muda de Campo de texto para Meu campo de texto.
O rótulo Campo numérico AF não foi alterado porque você substituiu essa propriedade da caixa de diálogo de propriedades do componente, conforme descrito em Adicionar conteúdo a formulários adaptáveis.

Adicionar novos campos do arquivo XDP ao formulário adaptável

Todos os campos adicionados posteriormente ao arquivo XDP original aparecem na guia Hierarquia de formulário e você pode arrastar esses novos campos para o formulário adaptável.
Não é necessário clicar no link na mensagem de erro para atualizar os campos na guia Hierarquia de formulário.

Campos excluídos no arquivo XDP

Se um campo que foi copiado anteriormente para um formulário adaptável for excluído de um arquivo XDP, uma mensagem de erro será exibida no modo de criação informando que o campo não existe no arquivo XDP. Nesses casos, exclua manualmente o campo do formulário adaptável ou limpe a bindRef propriedade na caixa de diálogo do componente.
As etapas a seguir ilustram esse fluxo de uso para os ativos no exemplo usado neste artigo:
  1. Atualize o sample-form.xdp arquivo e exclua NumericField1.
  2. Carregar o sample-form.xdp arquivo na interface do usuário do AEM Forms
  3. Abra o formulário sample-xfa-af adaptável para criação. A seguinte mensagem de erro é exibida: O esquema/modelo de formulário para o formulário adaptável foi atualizado. Click Here para rebaseá-lo na nova versão.
  4. Clique no link (rotulado como " Click Here ") na mensagem. Uma mensagem de erro é exibida, observando que o campo não existe mais no arquivo XDP.
O campo que foi excluído também é marcado com um ícone para indicar um erro no campo.
Os campos no formulário adaptável que têm um vínculo incorreto (um bindRef valor inválido na caixa de diálogo de edição) também são considerados campos excluídos. Se o autor não corrigir esses erros e publicar o formulário adaptável, o campo será tratado como um campo de formulário adaptável normal não vinculado e será incluído na seção não vinculada do arquivo XML de saída.

Downloads

Pacote de conteúdo para o exemplo neste artigo