#MultiRecordResource

Eine auf Datentabellen ausgerichtete Resource: Anfragen geben ein Array zurück und unterstützen Paginierung, Filterung, Sortierung sowie CRUD-Operationen. Sie eignet sich für Szenarien mit „mehreren Datensätzen“ wie Tabellen oder Listen. Im Gegensatz zur APIResource spezifiziert die MultiRecordResource den Ressourcennamen über setResourceName(), erstellt automatisch URLs wie users:list oder users:create und verfügt über integrierte Funktionen für Paginierung, Filterung und Zeilenauswahl.

Vererbungshierarchie: FlowResource → APIResource → BaseRecordResource → MultiRecordResource.

Erstellung: ctx.makeResource('MultiRecordResource') oder ctx.initResource('MultiRecordResource'). Vor der Verwendung müssen Sie setResourceName('SammlungsName') (z. B. 'users') aufrufen; in RunJS wird ctx.api durch die Laufzeitumgebung bereitgestellt.

#Anwendungsfälle

#Datenformat

• getData() gibt ein Array von Datensätzen zurück, was dem Feld data der List-API-Antwort entspricht.
• getMeta() gibt Metadaten zur Paginierung und andere Informationen zurück: page, pageSize, count, totalPage usw.

#Ressourcenname und Datenquelle

#Anfrageparameter (Filter / Felder / Sortierung)

#Paginierung

#Ausgewählte Zeilen (Tabellen-Szenarien)

#CRUD- und Listen-Operationen

#Konfiguration und Ereignisse

#Beispiele

#Einfache Liste

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

#Filterung und Sortierung

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

#Laden von Assoziationen

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

#Erstellen und Paginierung

await ctx.resource.create({ name: 'Max Mustermann', email: 'max.mustermann@example.com' });

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

#Ausgewählte Zeilen massenhaft löschen

const rows = ctx.resource?.getSelectedRows?.() || [];
if (rows.length === 0) {
  ctx.message.warning('Bitte wählen Sie zuerst Daten aus');
  return;
}
await ctx.resource.destroySelectedRows();
ctx.message.success(ctx.t('Gelöscht'));

#Auf das refresh-Ereignis hören

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?.();

#Assoziations-Ressource (Untertabellen)

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

#Hinweise

• setResourceName ist erforderlich: Sie müssen setResourceName('SammlungsName') vor der Verwendung aufrufen, da sonst die Anfrage-URL nicht erstellt werden kann.
• Assoziations-Ressourcen: Wenn der Ressourcenname im Format parent.child vorliegt (z. B. users.tags), müssen Sie zuerst setSourceId(parentPrimaryKey) aufrufen.
• Refresh-Debouncing: Mehrere Aufrufe von refresh() innerhalb desselben Ereigniszyklus (Event Loop) führen nur die letzte Anfrage aus, um redundante Anfragen zu vermeiden.
• getData gibt ein Array zurück: Die von der Listen-API zurückgegebenen data sind ein Array von Datensätzen, und getData() gibt dieses Array direkt zurück.

#Verwandte Themen

• ctx.resource - Die Ressourcen-Instanz im aktuellen Kontext
• ctx.initResource() - Initialisieren und an ctx.resource binden
• ctx.makeResource() - Eine neue Ressourcen-Instanz erstellen, ohne sie zu binden
• APIResource - Allgemeine API-Ressource, die per URL angefragt wird
• SingleRecordResource - Ausgerichtet auf einen einzelnen Datensatz