Melhorar o desempenho de formulários grandes com carregamento lento improve-performance-of-large-forms-with-lazy-loading
O Adobe recomenda o uso de Componentes principaisde captura de dados moderna e extensível para criar um novo Forms Adaptávelou adicionar o 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.
Introdução ao carregamento lento introduction-to-lazy-loading
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, os formulários adaptáveis permitem dividir os formulários em fragmentos lógicos e configurar para adiar a inicialização ou o carregamento dos fragmentos até que o fragmento precise estar 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 preparing-to-configure-lazy-loading
Antes de configurar o carregamento lento de fragmentos no formulário adaptável, é importante definir estratégias para criar fragmentos, identificar valores que são 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 independente 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.Para obter mais informações sobre como criar fragmentos, consulte Fragmentos de formulário adaptável.
-
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.Para obter informações sobre como tornar global um valor de campo, consulte Configurando carregamento lento.
-
Gravar 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 gravar regras, consulte Usando o 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 configuring-lazy-loading
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, habilite Carregar fragmento lentamente 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, habilite Usar valor durante carregamento lento.
Agora o valor é marcado como global e estará disponível para uso em scripts mesmo quando o fragmento que o contém for descarregado.
Considerações e práticas recomendadas para configurar o carregamento lento considerations-and-best-practices-for-configuring-lazy-loading
Algumas limitações, recomendações e pontos importantes a serem considerados ao trabalhar com carregamento lento são os seguintes:
- Use formulários adaptáveis baseados em esquema XSD em vez de formulários adaptáveis baseados em XFA para configurar o carregamento lento em formulários grandes. O ganho de desempenho devido à implementação de carregamento lento em formulários adaptáveis baseados em XFA é relativamente menor do que o ganho em formulários adaptáveis baseados em XSD.
- Não configure o carregamento lento em fragmentos em um formulário adaptável que use o layout 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 no primeiro fragmento em um formulário adaptável.
- É 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 scripting-best-practices-for-configuring-lazy-loading
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 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()