#SingleRecordResource

Resource orientado a un único registro: los datos consisten en un objeto individual, permitiendo la obtención por clave primaria, creación/actualización (save) y eliminación. Es adecuado para escenarios de "registro único" como bloques de detalles y formularios. A diferencia de MultiRecordResource, el método getData() de SingleRecordResource devuelve un solo objeto. Usted especifica la clave primaria mediante setFilterByTk(id), y save() llamará automáticamente a create o update basándose en el estado de isNewRecord.

Herencia: FlowResource → APIResource → BaseRecordResource → SingleRecordResource.

Formas de creación: ctx.makeResource('SingleRecordResource') o ctx.initResource('SingleRecordResource'). Debe llamar a setResourceName('nombre_de_la_colección') antes de su uso. Al realizar operaciones por clave primaria, utilice setFilterByTk(id). En RunJS, ctx.api es inyectado por el entorno de ejecución.

#Escenarios de uso

#Formato de datos

• getData() devuelve un objeto de registro único, que corresponde al campo data de la respuesta de la API get.
• getMeta() devuelve metainformación (si está disponible).

#Nombre del recurso y clave primaria

#Estado

#Parámetros de solicitud (Filtros / Campos)

#CRUD

#Configuración y eventos

#Ejemplos

#Obtención y actualización básica

ctx.initResource('SingleRecordResource');
ctx.resource.setResourceName('users');
ctx.resource.setFilterByTk(1);
await ctx.resource.refresh();
const user = ctx.resource.getData();

// Actualizar
await ctx.resource.save({ name: 'Juan Pérez' });

#Crear un nuevo registro

const newRes = ctx.makeResource('SingleRecordResource');
newRes.setResourceName('users');
await newRes.save({ name: 'María García', email: 'mariagarcia@example.com' });

#Eliminar un registro

ctx.resource.setResourceName('users');
ctx.resource.setFilterByTk(1);
await ctx.resource.destroy();
// Después de destroy, getData() devuelve null

#Carga de asociaciones y campos

ctx.resource.setResourceName('users');
ctx.resource.setFilterByTk(1);
ctx.resource.setFields(['id', 'nickname', 'email']);
ctx.resource.setAppends(['profile', 'roles']);
await ctx.resource.refresh();
const user = ctx.resource.getData();

#Recursos de asociación (ej. users.profile)

const res = ctx.makeResource('SingleRecordResource');
res.setResourceName('users.profile');
res.setSourceId(ctx.record?.id); // Clave primaria del registro padre
res.setFilterByTk(profileId);    // filterByTk puede omitirse si profile es una relación hasOne
await res.refresh();
const profile = res.getData();

#Guardar sin actualización automática

await ctx.resource.save({ status: 'active' }, { refresh: false });
// getData() conserva el valor antiguo ya que no se activa refresh después de guardar

#Escuchar eventos refresh / saved

ctx.resource?.on?.('refresh', () => {
  const data = ctx.resource.getData();
  ctx.render(<div>Usuario: {data?.nickname}</div>);
});
ctx.resource?.on?.('saved', (savedData) => {
  ctx.message.success('Guardado exitosamente');
});
await ctx.resource?.refresh?.();

#Notas

• setResourceName es obligatorio: Debe llamar a setResourceName('nombre_de_la_colección') antes de su uso, de lo contrario no se podrá construir la URL de la solicitud.
• filterByTk e isNewRecord: Si no se llama a setFilterByTk, isNewRecord será true y refresh() no iniciará ninguna solicitud; save() ejecutará una acción create.
• Recursos de asociación: Cuando el nombre del recurso tiene el formato padre.hijo (ej. users.profile), debe llamar primero a setSourceId(clave_primaria_padre).
• getData devuelve un objeto: El campo data devuelto por las API de registro único es un objeto de registro; getData() devuelve este objeto directamente. Se convierte en null después de ejecutar destroy().

#Relacionado

• ctx.resource - La instancia del recurso en el contexto actual
• ctx.initResource() - Inicializa y vincula a ctx.resource
• ctx.makeResource() - Crea una nueva instancia de recurso sin vincularla
• APIResource - Recurso de API general solicitado por URL
• MultiRecordResource - Orientado a colecciones/listas, soporta CRUD y paginación