Operações de Dados Remotos
Esta funcionalidade permite que os usuários iterem sobre dados usando os componentes Card, Column Layout, Absolute Layout e Row Layout enquanto aproveitam o componente Paginator para configurar e executar solicitações que buscam apenas uma página específica dos dados.
Benefícios Principais
- Desempenho melhorado: Busque apenas o subconjunto necessário (página) de dados do servidor, evitando grandes carregamentos.
- Escalável: Manipula grandes conjuntos de dados carregando dados em chunks menores.
- IU Flexível: Permite que o usuário coloque itens repetidos, como Cards, em um layout personalizado enquanto se beneficia dos recursos de paginação.
Como o Component-first Remote Data Funciona
Quando um usuário repete um componente sobre dados (por exemplo, um Card iterando sobre uma matriz JSON) e seleciona um endpoint (tabela) de uma fonte de dados, ele pode configurar paginação remota se a API fornecer tal endpoint.
Quando Paging está habilitado, um componente Paginator é adicionado automaticamente. Depois disso, o usuário pode abrir o Remote Paging Configurator selecionando o Paginator recém-criado para configurar todo o restante.
Durante a configuração, variáveis internas como pageIndex e pageSize são criadas. Mudar de página dispara novas solicitações ao servidor para recuperar apenas a página correspondente de dados.
Fluxo do usuário:
Fluxo do usuário component-first
Configurando Dados Remotos
1. Repita um componente sobre dados
- Na Toolbox, arraste um Card, Column Layout, Absolute Layout, Grid Layout ou Row Layout (esses suportam paginação até agora).
- Selecione o componente e abra seu painel Properties, que aparecerá no lado direito.
2. Selecione Dados
- Em Repeat, selecione Data.
- Escolha um endpoint REST ou uma definição Swagger que forneça a resposta JSON.
- Se a paginação for necessária, certifique-se de que sua API suporte parâmetros como
pageIndexepageSizepara que você possa paginar efetivamente.
3. Habilite Paginação
- Alterne Paging para ativado.
- O App Builder envolverá seu componente em um Row Layout para garantir que o Paginator seja colocado corretamente com seu componente host juntos (Card/Layout).
- Um Paginator é adicionado, portanto você precisará configurá-lo clicando nele e abrindo seu próprio painel de propriedades. Confira como configurá-lo aqui: Grid Remote Paging
4. Visualize a Configuração
- Uma vez que você tenha concluído a configuração e suas variáveis locais e ações tenham sido geradas, parabéns—você configurou com sucesso a paginação remota para seu componente!
- Clique em Preview para carregar a primeira página de dados.
- Mudar de página ou tamanhos de página dispara novas solicitações, buscando apenas essa porção de dados.
Resultado Esperado:
- O componente (Card/Column Layout/Row Layout/Grid Layout/Absolute Layout) pagina como um Grid, buscando dinamicamente apenas os dados da página atual.
Limitações Conhecidas
1. Imposição de Row Layout
- Para garantir o alinhamento adequado do Paginator junto com o componente repetido, o App Builder os envolverá em um Row Layout com Wrap, Grow e regras “Shrink” habilitadas.
2. Abordagem Variable-first Não Suportada Ainda
- Atualmente, o usuário deve começar repetindo um componente sobre dados para habilitar Paging. A próxima versão pode expor o Paginator como um componente independente, que configura solicitações de dados por conta própria, permitindo que qualquer componente seja vinculado aos dados correspondentes.
