#MultiRecordResource

Un recurso (Resource) orientado a colecciones: las solicitudes devuelven un arreglo y soportan paginación, filtrado, ordenamiento y operaciones CRUD. Es adecuado para escenarios de "múltiples registros" como tablas y listas. A diferencia de APIResource, MultiRecordResource especifica el nombre del recurso a través de setResourceName(), construye automáticamente URLs como users:list y users:create, e incluye capacidades integradas para paginación, filtrado y selección de filas.

Herencia: FlowResource → APIResource → BaseRecordResource → MultiRecordResource.

Formas de creación: ctx.makeResource('MultiRecordResource') o ctx.initResource('MultiRecordResource'). Antes de usarlo, debe llamar a setResourceName('nombreDeLaColección') (por ejemplo, 'users'); en RunJS, ctx.api es inyectado por el entorno de ejecución.

#Casos de uso

#Formato de datos

• getData() devuelve un arreglo de registros, que corresponde al campo data de la respuesta de la API de lista.
• getMeta() devuelve metadatos de paginación y otros: page, pageSize, count, totalPage, etc.

#Nombre del recurso y fuente de datos

#Parámetros de solicitud (Filtrado / Campos / Ordenamiento)

#Paginación

#Filas seleccionadas (escenarios de tabla)

#CRUD y operaciones de lista

#Configuración y eventos

#Ejemplos

#Lista básica

ctx.initResource('MultiRecordResource');
ctx.resource.setResourceName('users');
ctx.resource.setPageSize(20);
await ctx.resource.refresh();
const rows = ctx.resource.getData();
const total = ctx.resource.getCount();

#Filtrado y ordenamiento

ctx.resource.setResourceName('users');
ctx.resource.setFilter({ status: 'active' });
ctx.resource.setSort(['-createdAt']);
ctx.resource.setFields(['id', 'nickname', 'email']);
await ctx.resource.refresh();

#Carga de asociaciones

ctx.resource.setResourceName('orders');
ctx.resource.setAppends(['user', 'items']);
await ctx.resource.refresh();
const orders = ctx.resource.getData();

#Creación y paginación

await ctx.resource.create({ name: 'Juan Pérez', email: 'juan.perez@example.com' });

await ctx.resource.next();
await ctx.resource.previous();
await ctx.resource.goto(3);

#Eliminación masiva de filas seleccionadas

const rows = ctx.resource?.getSelectedRows?.() || [];
if (rows.length === 0) {
  ctx.message.warning('Por favor, seleccione datos primero');
  return;
}
await ctx.resource.destroySelectedRows();
ctx.message.success(ctx.t('Eliminado'));

#Escuchar el evento refresh

ctx.resource?.on?.('refresh', () => {
  const data = ctx.resource.getData();
  ctx.render(<ul>{data?.map((r) => <li key={r.id}>{r.name}</li>)}</ul>);
});
await ctx.resource?.refresh?.();

#Recurso de asociación (subtabla)

const res = ctx.makeResource('MultiRecordResource');
res.setResourceName('users.roles');
res.setSourceId(ctx.record?.id);
await res.refresh();
const roles = res.getData();

#Notas importantes

• setResourceName es obligatorio: Debe llamar a setResourceName('nombreDeLaColección') antes de su uso, de lo contrario, no se podrá construir la URL de la solicitud.
• Recursos de asociación: Cuando el nombre del recurso tiene el formato padre.hijo (por ejemplo, users.tags), debe llamar primero a setSourceId(clavePrimariaPadre).
• Anti-rebote (Debouncing) de refresh: Múltiples llamadas a refresh() dentro del mismo ciclo de eventos solo ejecutarán la última para evitar solicitudes redundantes.
• getData devuelve un arreglo: Los datos devueltos por la API de lista son un arreglo de registros, y getData() devuelve este arreglo directamente.

#Relacionado

• ctx.resource - La instancia de recurso en el contexto actual
• ctx.initResource() - Inicializar y vincular a ctx.resource
• ctx.makeResource() - Crear una nueva instancia de recurso sin vincular
• APIResource - Recurso de API general solicitado por URL
• SingleRecordResource - Orientado a un solo registro