Identifiants stables

Les identifiants stables sont des identifiants uniques et stables pour un objet donné. Ils permettent aux utilisateurs de données de rapprocher des objets d'un flux Common Data Format (CDF) avec d'autres dépôts de données. Dans le langage des bases de données, les identifiants externes sont une forme de clé étrangère permettant aux utilisateurs de données d'associer les objets d'un flux CDF à d'autres bases de données.

Par exemple, si "Robert Brady" est candidat, un consommateur de données peut ne pas associer immédiatement cette personne à "Bob Brady" dans sa base de données d'images. Toutefois, les données de la CDF et la base de données d'images pourraient indiquer que cette personne est le législateur 01469, tel qu'identifié par la base de données THOMAS de la Bibliothèque du Congrès. Le consommateur des données peut ensuite associer l'image au candidat.

Les conditions suivantes doivent être respectées pour tous les identifiants stables:

  • Stabilité:l'identifiant stable d'une entité unique donnée, comme Person ou Party, ne doit pas changer entre les différentes versions du flux de données. En d'autres termes, l'ID stable d'une entité spécifique ne doit pas changer au fil du temps.
  • 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 les candidats, les partis ou les circonscriptions pour les simulations, si nécessaire, et pendant le cycle électoral.

Mise en forme des données

Fournissez 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) et les identifiants uniques globaux (GUID) sont deux exemples d'ID stables. Cela se présente comme suit:

e55b7dd4-cc98-11ec-9d64-0242ac120002

Pour améliorer la lisibilité des données, il est préférable d'ajouter des préfixes et suffixes supplémentaires pour répartir davantage les entités. Par exemple, ajoutez le préfixe per- aux personnes ou à off- pour les bureaux, car les ID stables ne sont censés être conformes à aucune norme.

Recommandé:per-e55b7dd4-cc98-11ec-9d64-0242ac120002

Recommandé:off-7849514a-e8bc-11ec-8fea-0242ac120002

Recommandé:per-123456789012345

Non recommandé:par-john-doe

  • Risque: une autre personne portant le même nom peut posséder la même pièce d'identité.
  • Risque: la modification des données peut affecter l'ID stable.

Non recommandé:en dehors des États-Unis

Où utiliser des ID stables ?

Les identifiants stables sont obligatoires pour les éléments suivants: