Les identifiants stables sont des identifiants uniques, stables en externe, attribués à une . Elles permettent aux utilisateurs de données de rapprocher des objets dans un format de données commun. (CDF) avec d'autres dépôts de données. Dans le jargon des bases de données, les identifiants sont une forme de clé étrangère qui permet aux consommateurs de données d’associer d'un flux CDF vers d'autres bases de données.
Par exemple, si « Robert Brady » un consommateur de données n'est pas forcément susceptible associer immédiatement cette personne à "Bob Brady" dans sa base de données d'images. Toutefois, les données CDF et la base de données d'images pourraient indiquer que cette personne est législateur 01469 tel qu'identifié par la base de données THOMAS de la Bibliothèque du Congrès. Ensuite, l'utilisateur peut associer l'image au candidat.
Les conditions suivantes doivent être remplies pour tous les identifiants stables:
- Stabilité:identifiant stable d'une entité unique donnée, comme un
Person
ouParty
, ne doit pas changer d'une version à l'autre des données flux. En d'autres termes, l'identifiant stable ne doit pas changer au fil du temps pour une entité. - Unicité:ne réutilisez jamais un identifiant stable pour une autre entité, même si l'entité d'origine ne figure plus dans le flux.
- Cohérence:vous devez utiliser le même ensemble d'identifiants stables pour candidats, partis ou districts pour les deux simulations, si nécessaire, et pendant la période électorale.
Format de données
Indiquez les identifiants stables au format suivant:
<ExternalIdentifier>
<Type>other</Type>
<OtherType>stable</OtherType>
<Value>match the regex ^[a-zA-Z0-9_-]+$</Value>
</ExternalIdentifier>
Les identifiants uniques universels (UUID) sont quelques exemples d'ID stables. Les identifiants uniques globaux (GUID). Voici un exemple:
e55b7dd4-cc98-11ec-9d64-0242ac120002
Pour améliorer la lisibilité des données, il est préférable d'ajouter des préfixes et
les suffixes pour décomposer davantage les entités. Par exemple, ajoutez le préfixe per-
au
personnes ou off-
pour les bureaux, car les identifiants stables ne sont pas censés respecter les
standard.
Recommandé:per-e55b7dd4-cc98-11ec-9d64-0242ac120002
Recommandé:off-7849514a-e8bc-11ec-8fea-0242ac120002
Recommandé:per-123456789012345
Non recommandé:par jean-dupont
- Risque: une autre personne portant le même nom peut avoir la même pièce d'identité.
- Risque: toute modification apportée aux données peut affecter l'ID stable.
Approche déconseillée : "out-presidento-of-us"
Où utiliser des ID stables
Les identifiants stables sont obligatoires pour les éléments suivants:
BallotMeasureSelection
surBallotSelection
Candidate
Coalition
surParty
Contest
Election
Office
Party
Person
ReportingUnit