Prima di iniziare

• Client tecnico con bi.results nell'azienda prevista; bi.nominal e bi.freeText soltanto se autorizzati.
• Un consumer che gestisca checkpoint, cursori, sostituzione dei figli e cancellazioni logiche.

Passo dopo passo

1. Scegli i dataset normalizzati sotto /api/v1/bi/v1/ secondo il contratto versionato. Non usare un export CSV come sostituto implicito del feed.
2. Esegui il caricamento iniziale e segui nextCursor fino alla fine del batch. Il watermark è una sequenza intera, non un orario.
3. Memorizza il checkpoint soltanto quando nextCursor è nullo e tutte le pagine sono state applicate con successo.
4. Quando cambia un parent, sostituisci i relativi record figli secondo il contratto. Un tombstone rimuove parent e figli; evita doppi conteggi quando unisci risposte e opzioni multiple.
5. Se ricevi 410 per checkpoint scaduto dopo manutenzione, azzera esplicitamente il dataset e avvia full=true. Verifica poi conteggi e isolamento con il sistema BI destinazione.

Limiti e recupero

• Chiavi quiz non fanno parte delle proiezioni BI ordinarie.
• Versione Qlik, connessione cliente e refresh effettivo devono ancora essere collaudati nel sistema reale; test sintetici non bastano.

Before you start

• A technical client with bi.results in the intended company, plus bi.nominal and bi.freeText only when authorised.
• A consumer that handles checkpoints, cursors, child replacement and soft deletions.

Step by step

1. Choose the normalised datasets under /api/v1/bi/v1/ using their versioned contract. Do not implicitly substitute a CSV export for the feed.
2. Run the initial load and follow nextCursor to the end of the batch. The watermark is an integer sequence rather than a timestamp.
3. Persist the checkpoint only when nextCursor is null and every page has been successfully applied.
4. When a parent changes, replace its related child records according to the contract. A tombstone removes the parent and children; avoid double counting when joining answers to multiple options.
5. If maintenance causes a 410 expired-checkpoint response, explicitly reset the dataset and start full=true. Then verify counts and isolation in the destination BI system.

Limits and recovery

• Quiz keys are not included in ordinary BI projections.
• The actual Qlik version, customer connection and refresh still need qualification in the real system; synthetic tests are insufficient.