Sincronização do Adaptive Forms com modelos de formulário XFA synchronizing-adaptive-forms-with-xfa-form-templates

Introdução introduction

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, Criar um formulário adaptável com base em um modelo.

Você pode reutilizar campos do arquivo XDP em seu 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. Também é possível optar por substituir o valor de algumas dessas propriedades.

O AEM Forms fornece uma maneira de ajudar você a manter os campos dos formulários adaptáveis sincronizados com qualquer alteração feita posteriormente nos campos correspondentes no arquivo XDP. Este artigo explica como você pode habilitar 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 prerequisites

Para usar as informações neste artigo, recomenda-se uma familiaridade com as seguintes áreas:

Para usar os ativos, forneça o exemplo no artigo, baixe o pacote de amostra conforme explicado na próxima seção, Pacote de exemplo.

Pacote de exemplo sample-package

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 do 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 pacotes: https://<server>:<port>/crx/packmgr/index.jsp

O pacote contém os seguintes ativos:

Adicionar conteúdo ao formulário adaptável add-content-to-adaptive-form-br

Detecção de alterações no arquivo XDP detecting-changes-in-xdp-file

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.

Como exemplo, atualizemos o sample-form.xdp arquivo usando as seguintes etapas:

Se um arquivo XDP for atualizado, você verá um ícone no editor, ao editar os formulários adaptáveis com base no arquivo XDP. Esse ícone indica que o formulário adaptável está fora de sincronia com o arquivo XDP. Na imagem a seguir, veja o ícone ao lado da barra lateral.

Sincronização de formulários adaptáveis com o arquivo XDP mais recente synchronizing-adaptive-forms-with-the-latest-xdp-file

Quando um formulário adaptável fora de sincronia com o arquivo XDP for aberto para criação na próxima vez, a seguinte mensagem será exibida:
O esquema/modelo de formulário para o formulário adaptável foi atualizado. Click Here para recalcular com a 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 updating-the-properties

Todas as propriedades que foram copiadas do arquivo XDP para o formulário adaptável são atualizadas, exceto pelas propriedades que foram explicitamente substituídas no formulário adaptável (na caixa de diálogo Componente) pelo Autor. A lista de propriedades que foram atualizadas está disponível nos logs do servidor.

Para atualizar as propriedades no formulário adaptável de exemplo, clique no link (rotulado como "Click Here") na mensagem. O título do TextField1 muda de Campo de texto para Meu campo de texto.

Adicionar novos campos do arquivo XDP ao formulário adaptável   adding-new-fields-from-xdp-file-to-adaptive-form-nbsp

Todos os campos adicionados posteriormente ao arquivo XDP original serão exibidos na guia Hierarquia de formulário e você poderá arrastar esses novos campos para o formulário adaptável.

Não é necessário clicar no link da mensagem de erro para atualizar os campos na guia Hierarquia de formulário.

Campos excluídos no arquivo XDP deleted-fields-in-xdp-file

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 declarando que o campo não existe no arquivo XDP. Nesses casos, exclua manualmente o campo do formulário adaptável ou limpe o bindRef na caixa de diálogo do componente.

As etapas a seguir ilustram esse fluxo de uso para os ativos no exemplo usado neste artigo:

O campo que foi excluído também é marcado com um ícone para indicar um erro no campo.

Downloads downloads

Pacote de conteúdo para o exemplo deste artigo

Obter arquivo