Skip to content

Operaciones de Datos Remotos

Esta funcionalidad permite a los usuarios iterar sobre datos usando los componentes Card, Column Layout, Absolute Layout y Row Layout mientras aprovecha el componente Paginator para configurar y ejecutar solicitudes que obtienen solo una página específica de los datos.

Beneficios Clave

  • Rendimiento mejorado: Obtiene solo el subconjunto requerido (página) de datos del servidor, evitando cargas grandes.
  • Escalable: Maneja grandes conjuntos de datos cargando datos en fragmentos más pequeños.
  • Interfaz flexible: Permite al usuario colocar elementos repetidos, como Cards, en un diseño personalizado mientras se beneficia de las características de paginación.

Cómo funciona Remote Data desde el enfoque Component-first

Cuando un usuario repite un componente sobre datos (por ejemplo, un Card iterando sobre un array JSON) y selecciona un endpoint (tabla) de una fuente de datos, puede configurar la paginación remota si la API proporciona ese endpoint.

Cuando la Paginación está habilitada, un componente Paginator se agrega automáticamente. Después de eso, el usuario puede abrir el Configurador de Paginación Remota seleccionando el Paginator recién creado para configurar todo lo demás.

Durante la configuración, se crean variables internas como pageIndex y pageSize. Cambiar de página desencadena nuevas solicitudes al servidor para recuperar solo la página de datos correspondiente.

Flujo del usuario:

Flujo del usuario de enfoque component-first

Configuración de Datos Remotos

1. Repetir un componente sobre datos

  • Desde el Toolbox, arrastre un Card, Column Layout, Absolute Layout, Grid Layout o Row Layout (por ahora, estos soportan paginación).
  • Seleccione el componente y abra su panel de Properties, que aparecerá en el lado derecho.

2. Seleccionar Datos

  • En Repeat, seleccione Data.
  • Elija un endpoint REST o una definición de Swagger que proporcione la respuesta JSON.
  • Si se necesita paginación, asegúrese de que su API soporta parámetros como pageIndex y pageSize para que pueda paginar efectivamente.

3. Habilitar Paginación

  • Active Paging.
  • App Builder envolverá su componente en un Row Layout para asegurar que el Paginator se coloca correctamente con su componente host (Card/Layout).
  • Se agrega un Paginator, por lo que necesitará configurarlo haciendo clic en él y abriendo su propio panel de propiedades. Consulte cómo configurarlo aquí: Grid Remote Paging

4. Vista previa de la Configuración

  • Una vez que haya completado la configuración y sus variables locales y acciones se hayan generado, ¡felicitaciones! Ha configurado correctamente la paginación remota para su componente.
  • Haga clic en Preview para cargar la primera página de datos.
  • Cambiar de página o tamaño de página desencadena nuevas solicitudes, obteniendo solo esa porción de datos.

Resultado esperado:

  • El componente (Card/Column Layout/Row Layout/Grid Layout/Absolute Layout) pagina como un Grid, obteniendo dinámicamente solo los datos de la página actual.

Limitaciones Conocidas

1. Imposición de Row Layout

  • Para asegurar la alineación correcta del Paginator junto con el componente repetido, App Builder los envolverá dentro de un Row Layout con las reglas Wrap, Grow y “Shrink” habilitadas.

2. Enfoque Variable-first No Soportado Aún

  • Actualmente, el usuario debe comenzar repitiendo un componente sobre datos para habilitar la Paginación. La próxima versión podría exponer el Paginator como un componente independiente, que configura solicitudes de datos por su cuenta, permitiendo que cualquier componente se enlace a los datos correspondientes.

Recursos Adicionales