Génération d’énoncés

Les énoncés doivent être considérés comme immuables : une fois un énoncé publié, il ne doit pas être republié avec le même identifiant (statementId) et des valeurs de propriété différentes. Consultez la section Mises à jour des informations pour en savoir plus.

Chaque énoncé doit avoir un identifiant unique. Il ne doit exister aucune possibilité de conflit entre les identifiants des différents énoncés.

Cela signifie que :

  • deux énoncés différents ne doivent jamais avoir le même identifiant ;

  • une fois un identifiant attribué à un énoncé, il ne doit jamais être modifié.

Le schéma applique aux énoncés un identifiant de 32 caractères au minimum et de 64 caractères au maximum.

En règle générale, les identifiants des énoncés sont destinés à être utilisés dans les applications. Dans la plupart des cas, ils n’ont pas besoin d’être visibles pour les utilisateurs et les utilisatrices, contrairement aux identifiants d’entité ou de personne, qu’il est utile d’afficher.

Stratégies de création des identifiants d’énoncé

Les éditeurs peuvent recourir à l’une des stratégies suivantes pour créer des identifiants d’énoncé.

  • Générez un identifiant universel unique pour le premier énoncé concernant un enregistrement. Stockez-le dans le système de gestion des données. Actualisez-le à chaque fois que l’enregistrement concerné est mis à jour.

  • Générez un identifiant universel unique en tant que préfixe lié à un éditeur. Ajoutez-y le champ recordId pertinent et l’identifiant d’une version.

  • Utilisez une fonction de hachage conçue de manière appropriée qui génère des identifiants à partir d’une représentation JSON normalisée de l’énoncé (excepté le champ statementId) avec une faible probabilité de conflit.

  • Utilisez un identifiant interne associé à un préfixe unique pour éviter les conflits entre les identifiants des différents éditeurs.

Précédent
Suivant