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.
Quando os formulários se tornam grandes e complexos, com centenas e milhares de campos, os usuários finais têm um longo tempo de resposta ao renderizar formulários no tempo de execução. Para minimizar o tempo de resposta, o Adaptive Forms permite dividir formulários em fragmentos lógicos e configurar para adiar a inicialização ou o carregamento de fragmentos até que o fragmento esteja visível. É chamado de carregamento lento. Além disso, os fragmentos configurados para carregamento lento são descarregados assim que o usuário navega para outras seções no formulário e os fragmentos não ficam mais visíveis.
Vamos primeiro entender os requisitos e etapas preparatórias antes de configurar o carregamento lento.
Preparando para configurar o carregamento lento
Antes de configurar o carregamento lento de fragmentos no Formulário adaptável, é importante definir estratégias para criar fragmentos, identificar valores usados em scripts ou referenciados em outros fragmentos e definir regras para controlar a visibilidade de campos em fragmentos carregados lentamente.
Identificar e criar fragmentos
Você pode configurar apenas fragmentos de formulário adaptáveis para carregamento lento. Um fragmento é um segmento autônomo que fica fora de um Formulário adaptável e pode ser reutilizado em formulários. Portanto, o primeiro passo para implementar o carregamento lento é identificar seções lógicas em um formulário e convertê-las em fragmentos. Você pode criar um fragmento do zero ou salvar um painel de formulário existente como fragmento.
Identificar e marcar valores globais
As transações baseadas em Forms envolvem elementos dinâmicos para capturar dados relevantes de usuários e processá-los para simplificar a experiência de preenchimento de formulário. Por exemplo, o formulário tem o campo A no fragmento X cujo valor determina a validade do campo B em outro fragmento. Nesse caso, se o fragmento X estiver marcado para carregamento lento, o valor do campo A deverá estar disponível para validar o campo B, mesmo quando o fragmento X não estiver carregado. Para isso, você pode marcar o campo A como global, o que garante que seu valor esteja disponível para validar o campo B quando o fragmento X não estiver carregado.
Escrever regras para controlar a visibilidade dos campos
O Forms inclui alguns campos e seções que não se aplicam a todos os usuários e em todas as condições. Os autores e desenvolvedores do Forms usam as regras de visibilidade ou mostrar-ocultar para controlar sua visibilidade com base nas entradas do usuário. Por exemplo, o campo Endereço Comercial não é exibido para os usuários que escolhem Desempregado no campo Status do Emprego em um formulário. Para obter mais informações sobre como escrever regras, consulte Uso do editor de regras.
Você pode usar regras de visibilidade nos fragmentos carregados lentamente para que os campos condicionais sejam exibidos somente quando forem necessários. Além disso, marque o campo condicional como global para fazer referência a ele na expressão de visibilidade do fragmento carregado lentamente.
Configuração de carregamento lento
Execute as seguintes etapas para habilitar o carregamento lento em um Fragmento de formulário adaptável:
Abra o Formulário adaptável no modo de criação que contém o fragmento que você deseja ativar para carregamento lento.
Selecione o fragmento de formulário adaptável e selecione .
Na barra lateral, ative Carregar fragmento preguiçosamente e selecione Concluído.
O fragmento agora está ativado para carregamento lento.
Você pode marcar os valores de objetos no fragmento carregado lentamente como globais para que eles fiquem disponíveis para uso em scripts quando o fragmento que o contém não for carregado. Faça o seguinte:
Abra o fragmento de formulário adaptável no modo de criação.
Selecione o campo cujo valor você deseja marcar como global e selecione .
Na barra lateral, ative Usar valor durante carregamento lento.
O valor agora é marcado como global e está disponível para uso em scripts mesmo quando o fragmento que o contém é descarregado.
Considerações e práticas recomendadas para configurar o carregamento lento
Algumas limitações, recomendações e pontos importantes a serem considerados ao trabalhar com carregamento lento são os seguintes:
A Adobe recomenda usar o Adaptive Forms baseado em esquema XSD em vez do Adaptive Forms baseado em XFA para configurar o carregamento lento em formulários grandes. O ganho de desempenho devido à implementação de carregamento lento no Adaptive Forms baseado em XFA é relativamente menor do que o ganho no Adaptive Forms baseado em XSD.
Não configurar o carregamento lento em fragmentos em um Formulário adaptável que usam Responsivo - tudo em uma página sem navegação para o painel raiz. Como resultado da configuração de Layout responsivo, todos os fragmentos são carregados simultaneamente em um Formulário adaptável. Isso também pode resultar em redução do desempenho.
É recomendável não configurar o carregamento lento em fragmentos no primeiro painel que é renderizado ao carregar o Formulário adaptável.
O carregamento lento é compatível com até dois níveis na hierarquia do fragmento.
Certifique-se de que os campos marcados como globais sejam exclusivos em um Formulário adaptável.
Considere escrever regras de visibilidade para fragmentos que devem ser exibidos ou ocultados com base em uma condição. Por exemplo, você pode exibir ou ocultar o fragmento Detalhes do cônjuge com base no estado civil especificado por um usuário.
Os componentes de Anexos de arquivo e Termos e condições não são compatíveis com fragmentos carregados lentamente.
Práticas recomendadas de script para configurar o carregamento lento
Os pontos importantes que você deve ter em mente ao desenvolver scripts para painéis de carregamento lentos são os seguintes:
Certifique-se de que os scripts de inicialização e cálculo usados nos campos de um fragmento carregado lento sejam de natureza idempotente. Scripts idempotentes são aqueles que têm o mesmo efeito mesmo após várias execuções.
Use a propriedade de campos disponível globalmente para disponibilizar o valor dos campos localizados em um painel de carregamento lento para todos os outros painéis de um formulário.
Não encaminhe o valor de referência de um campo dentro de um painel lento independentemente de o campo estar marcado globalmente entre fragmentos ou não.
Use o recurso de redefinição de painel para redefinir tudo o que está visível no painel usando a seguinte expressão de clique.
guideBridge.resolveNode(guideBridge.getFocus({"focusOption": "navigablePanel"})).resetData()
.
