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:
- Crea un oggetto sibling di history gestito (nome predefinito
<oggetto>_history). - Aggiunge campi di provenienza fissi sull'oggetto history.
- Specchia i campi del primary sull'oggetto history (con le eccezioni sotto).
- 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:
| Campo | Significato |
|---|---|
| record / record_id | A quale riga primary appartiene questa versione |
| versioned_at | Quando è stata registrata la modifica |
| operation | Create, update o delete |
| source | Da dove arriva la scrittura (form, task, API, import, …) |
| logged_in_object / logged_in_object_id | Chi 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 —
SELECTsullo history va bene; le mutazioni sono bloccate - Snapshot — backup intero dell'app vs history per record