#MultiRecordResource

Une ressource orientée vers les tables de données (collections) : les requêtes renvoient un tableau et prennent en charge la pagination, le filtrage, le tri ainsi que les opérations CRUD (création, lecture, mise à jour, suppression). Elle est adaptée aux scénarios impliquant "plusieurs enregistrements" tels que les tableaux et les listes. Contrairement à APIResource, MultiRecordResource spécifie le nom de la ressource via setResourceName(), construit automatiquement des URL telles que users:list ou users:create, et intègre des capacités natives pour la pagination, le filtrage et la sélection de lignes.

Héritage : FlowResource → APIResource → BaseRecordResource → MultiRecordResource.

Mode de création : ctx.makeResource('MultiRecordResource') ou ctx.initResource('MultiRecordResource'). Avant toute utilisation, vous devez appeler setResourceName('nom_de_la_collection') (par exemple 'users') ; dans RunJS, ctx.api est injecté par l'environnement d'exécution.

#Scénarios d'utilisation

#Format des données

• getData() renvoie un tableau d'enregistrements, correspondant au champ data de la réponse de l'API de liste.
• getMeta() renvoie les métadonnées de pagination et autres : page, pageSize, count, totalPage, etc.

#Nom de la ressource et source de données

#Paramètres de requête (Filtre / Champs / Tri)

#Pagination

#Lignes sélectionnées (Scénarios de tableau)

#CRUD et opérations de liste

#Configuration et événements

#Exemples

#Liste de base

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

#Filtrage et tri

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

#Chargement des associations

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

#Création et pagination

await ctx.resource.create({ name: 'Jean Dupont', email: 'jean.dupont@example.com' });

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

#Suppression groupée des lignes sélectionnées

const rows = ctx.resource?.getSelectedRows?.() || [];
if (rows.length === 0) {
  ctx.message.warning('Veuillez d’abord sélectionner des données');
  return;
}
await ctx.resource.destroySelectedRows();
ctx.message.success(ctx.t('Supprimé'));

#Écouter l'événement 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?.();

#Ressource associée (Sous-table)

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

#Remarques

• setResourceName est obligatoire : Vous devez appeler setResourceName('nom_de_la_collection') avant toute utilisation, sinon l'URL de la requête ne pourra pas être construite.
• Ressources associées : Lorsque le nom de la ressource est au format parent.enfant (ex: users.tags), vous devez d'abord appeler setSourceId(clé_primaire_parent).
• Anti-rebond (Debouncing) du refresh : Plusieurs appels à refresh() au sein de la même boucle d'événements n'exécuteront que le dernier appel pour éviter les requêtes redondantes.
• getData renvoie un tableau : Les données renvoyées par l'API de liste sont un tableau d'enregistrements, et getData() renvoie directement ce tableau.

#Liens associés

• ctx.resource - L'instance de ressource dans le contexte actuel
• ctx.initResource() - Initialiser et lier à ctx.resource
• ctx.makeResource() - Créer une nouvelle instance de ressource sans liaison
• APIResource - Ressource API générale appelée par URL
• SingleRecordResource - Orientée vers un enregistrement unique