Records

Owned by Nicolas Rueff
Last updated: Dec 01, 2023
2 min read

Cette section détaille le concept et l'utilisation des Records.

Un enregistrement représente le choix fait à un moment donné par un sujet sur un modèle d'élément (traitement, préférence ou condition) qui peut être accompagné d'un modèle d'information et marqué comme concernant un objet spécifique.

Fiabilité​

Sa fiabilité est assurée par

  • un indicateur d'intégrité ;

  • l'identifiant de la Transaction par laquelle l'enregistrement a été créé ;

  • les numéros de série de la version du modèle d'élément et de l'éventuelle version du modèle d'information, qui peuvent être utilisés pour recréer la forme exacte qui a été montrée au sujet ;

  • un état de la base de données : pending (attente de confirmation), committed (prêt à l'emploi), deleted ou cancelled (annulé) ;

  • un statut qui est déterminé à chaque fois que l'enregistrement est interrogé, en fonction des nouveaux enregistrements éventuels, des changements de modèles ou de l'expiration ;

  • une origine qui indique si la valeur a été soumise directement par le sujet (et par quel moyen), ou par une action d'un opérateur ou d'un pair ;

  • un champ "auteur" et un champ "commentaire" qui peuvent être utilisés par les opérateurs ou les pairs pour expliquer pourquoi ils ont soumis de nouvelles valeurs pour le sujet.

Statut​s possibles

Les statuts possibles des enregistrements sont les suivants :

  • valid : l'enregistrement reflète le choix actuel du sujet et peut être utilisé comme preuve ;

  • obsolete : l'enregistrement reflète un choix que le sujet a fait antérieurement, mais qui n'est plus correct parce qu'il existe un enregistrement plus récent ;

  • expired : l'enregistrement reflète un choix que le sujet a fait antérieurement, mais depuis trop longtemps pour être encore considéré comme correct (ce qui signifie que le choix du sujet devrait être collecté à nouveau) ;

  • irrelevant : l'enregistrement ne peut pas être utilisé comme preuve parce qu'il fait référence à une série de modèles inactive (ce qui signifie que le choix du sujet doit être collecté à nouveau) ou n'a pas été engagé (par exemple, un processus de validation en deux étapes a été lancé mais n'a jamais été achevé) ;

  • unknown : l'enregistrement ne peut pas être utilisé comme preuve pour d'autres raisons ; ce statut est principalement utilisé en interne et ne devrait pas apparaître dans le backoffice.

Records et Reçus​

Les records sont des objets atomiques stockés dans la base de données ; ils peuvent être interrogés par l'intermédiaire de l'API et rendus pour les opérateurs dans le backoffice, mais fonctionnent également comme des briques constitutives pour les reçus.

Ces derniers sont des fichiers destinés à être lus par un humain ou à être traités programmatiquement et représentent les choix soumis par un sujet dans un contexte donné, à un moment donné ; ils regroupent donc généralement plusieurs enregistrements - un par élément de contexte.