DocumentaçãoAEM as a Cloud ServiceGuia do usuário

Melhorar o desempenho de formulários grandes com carregamento lento improve-performance-of-large-forms-with-lazy-loading

Last update: Tue Jan 28 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Intermediário
  • Usuário
  • Desenvolvedor
NOTE
A Adobe recomenda o uso de Componentes principais de captura de dados moderna e extensível para criar um novo Forms Adaptável ou adicionar o Adaptive Forms à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.
Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

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, 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 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 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.

    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:

  1. Abra o Formulário adaptável no modo de criação que contém o fragmento que você deseja ativar para carregamento lento.

  2. Selecione o Fragmento de formulário adaptável e selecione configurar .

  3. Na barra lateral, habilite Carregar fragmento lentamente e selecione Concluído.

    Habilitar carregamento lento para o Fragmento de Formulário Adaptável

    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:

  1. Abra o fragmento de formulário adaptável no modo de criação.

  2. Selecione o campo cujo valor você deseja marcar como global e selecione configurar .

  3. Na barra lateral, habilite Usar valor durante carregamento lento.

    Campo de carregamento lento na barra lateral

    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 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:

  • 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 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 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 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()

Consulte também see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab