#SingleRecordResource

Resource yang berorientasi pada single record: data adalah single object, mendukung get berdasarkan primary key, create/update (save), dan delete. Cocok untuk skenario "single record" seperti detail, form, dll. Berbeda dengan MultiRecordResource, getData() SingleRecordResource mengembalikan single object, primary key ditentukan melalui setFilterByTk(id), save() akan otomatis memanggil create atau update berdasarkan isNewRecord.

Hubungan Inheritance: FlowResource → APIResource → BaseRecordResource → SingleRecordResource.

Cara Pembuatan: ctx.makeResource('SingleRecordResource') atau ctx.initResource('SingleRecordResource'). Sebelum digunakan perlu setResourceName('nama-data-table'); saat operasi berdasarkan primary key perlu setFilterByTk(id); di RunJS ctx.api disuntikkan oleh runtime environment.

#Skenario Penggunaan

#Format Data

• getData() mengembalikan objek record tunggal, yaitu field data dari API get
• getMeta() mengembalikan informasi meta (jika ada)

#Nama Resource dan Primary Key

#Status

#Parameter Request (Filter / Field)

#CRUD

#Konfigurasi dan Event

#Contoh

#Get dan Update Dasar

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

// Update
await ctx.resource.save({ name: 'Budi' });

#Membuat Record Baru

const newRes = ctx.makeResource('SingleRecordResource');
newRes.setResourceName('users');
await newRes.save({ name: 'Citra', email: 'citra@example.com' });

#Menghapus Record

ctx.resource.setResourceName('users');
ctx.resource.setFilterByTk(1);
await ctx.resource.destroy();
// getData() adalah null setelah destroy

#Expand Relasi dan Field

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

#Resource Relasi (seperti users.profile)

const res = ctx.makeResource('SingleRecordResource');
res.setResourceName('users.profile');
res.setSourceId(ctx.record?.id); // Primary key record parent
res.setFilterByTk(profileId);    // Jika profile adalah hasOne dapat menghilangkan filterByTk
await res.refresh();
const profile = res.getData();

#save Tidak Otomatis Refresh

await ctx.resource.save({ status: 'active' }, { refresh: false });
// Setelah save tidak memicu refresh, getData() mempertahankan nilai lama

#Memantau Event refresh / saved

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

#Hal yang Perlu Diperhatikan

• setResourceName wajib: sebelum digunakan harus memanggil setResourceName('nama-data-table'), jika tidak tidak dapat membangun URL request.
• filterByTk dan isNewRecord: saat setFilterByTk belum disetel isNewRecord adalah true, refresh() tidak akan melakukan request; save() akan menjalankan create.
• Resource relasi: saat nama resource adalah parent.child (seperti users.profile), perlu setSourceId(primary key record parent) terlebih dahulu.
• getData adalah objek: data yang dikembalikan API single adalah objek record, getData() langsung mengembalikan objek tersebut; setelah destroy() adalah null.

#Terkait

• ctx.resource - Instance resource dalam konteks saat ini
• ctx.initResource() - Inisialisasi dan mengikat ke ctx.resource
• ctx.makeResource() - Membuat instance resource baru, tidak mengikat
• APIResource - API resource umum, request berdasarkan URL
• MultiRecordResource - Berorientasi data table/list, mendukung CRUD, pagination