Passa al contenuto principale

Versioning dei record

Il versioning dei record mantiene uno storico append-only di ogni modifica ai record di un oggetto. Abilitalo quando ti serve una traccia di audit (chi ha cambiato cosa, quando e come) senza costruire un logging custom.

Scenari tipici:

  • compliance o audit interno su ticket, contratti o anagrafiche;
  • revisioni del tipo “com’era questo record la settimana scorsa?” su una pagina di dettaglio;
  • indagine su modifiche accidentali senza ripristinare uno Snapshot intero.

Come funziona​

Su un oggetto normale (non globale), apri il menu dell'oggetto e scegli Enable versioning…. Bobuild:

  1. Crea un oggetto sibling di history gestito (nome predefinito <oggetto>_history).
  2. Aggiunge campi di provenienza fissi sull'oggetto history.
  3. Specchia i campi del primary sull'oggetto history (con le eccezioni sotto).
  4. Installa trigger di database che aggiungono una riga history a ogni create, update e delete.

Il primary resta la copia di lavoro live. Le righe history sono append-only: puoi elencarle e filtrarle in griglie o nella SQL Console, ma non puoi inserirle, aggiornarle o eliminarle a mano (la SQL Console rifiuta quelle scritture).

Non creare o rimodellare l'oggetto history a mano. Abilita o disabilita il versioning solo dall'oggetto primary (o tramite le ops MCP object.enable_versioning / object.disable_versioning).

Campi di provenienza​

Ogni riga history include campi di sistema come:

CampoSignificato
record / record_idA quale riga primary appartiene questa versione
versioned_atQuando è stata registrata la modifica
operationCreate, update o delete
sourceDa dove arriva la scrittura (form, task, API, import, …)
logged_in_object / logged_in_object_idChi era autenticato al momento della modifica (quando disponibile)

Metti i campi “chi / perché” specifici dell'app sul primary (ad esempio una Choice “motivo della modifica”) così vengono specchiati automaticamente in ogni versione.

Cosa viene specchiato​

La maggior parte dei tipi di campo viene copiata sul sibling history. File, Multiple Files e Image non vengono specchiati — i binary non sono snapshot, quindi lo history conterrebbe solo link rotti.

I campi Reference e Reference Array vengono specchiati per i Widget, e Bobuild aggiunge anche una colonna ID companion durevole (ad esempio customer_id o tags_ids) così gli ID grezzi sopravvivono se il target collegato viene eliminato in seguito.

Non puoi abilitare il versioning se il primary ha già campi con nomi come i campi di sistema history (record, record_id, versioned_at, operation, source, logged_in_object, logged_in_object_id). Rinominali prima. Gli oggetti globali (singleton) non possono essere versionati.

Mostrare lo history nell'app​

Collega una griglia (o un detail) all'oggetto history, filtrata sul record primary corrente (ad esempio record è la riga corrente della pagina). Posizionala sulla pagina di dettaglio o modifica del primary così gli operatori possono sfogliare le versioni passate nel contesto.

Disabilitare il versioning​

Disable versioning… sul primary elimina il sibling history gestito (e le sue righe versione) quando nient'altro lo referenzia. Questo distrugge i dati di history e non può essere annullato — fai prima uno Snapshot se potresti aver bisogno della traccia in seguito.

Correlati​

  • Tipi di campo — cosa può vivere sul primary
  • Oggetti globali — i singleton non possono essere versionati
  • SQL Console — SELECT sullo history va bene; le mutazioni sono bloccate
  • Snapshot — backup intero dell'app vs history per record