Identificadores estables

Los identificadores estables son identificadores únicos y estables externamente para un . Permiten a los consumidores de datos conciliar objetos en un formato de datos común (CDF) con otros repositorios de datos. Según la jerga de bases de datos, los canales los identificadores son una forma de clave externa que permite a los consumidores en un feed de CDF a otras bases de datos.

Por ejemplo, si "Robert Brady" es un candidato, un consumidor de datos podría no vincular inmediatamente a esa persona con "Bob Brady" en su base de datos de imágenes. Sin embargo, los datos de CDF y la base de datos de imágenes podrían indicar que esta persona legislador 01469, según lo identificado por la base de datos THOMAS de la Biblioteca del Congreso. Después el consumidor de datos pueda vincular la imagen con el candidato.

Se deben cumplir las siguientes condiciones para todos los identificadores estables:

  • Estabilidad: El identificador estable de una entidad única determinada, como una Person o Party, no deben cambiar entre diferentes versiones de los datos feed. En otras palabras, el ID estable no debe cambiar con el tiempo para un ID .
  • Exclusividad: Nunca reutilices un identificador estable para una entidad diferente, ni siquiera si la entidad original ya no está en el feed.
  • Coherencia: debes usar el mismo conjunto de identificadores estables para candidatos, partidos o distritos para ambas simulaciones, si es necesario, y durante el ciclo electoral.

Formato de datos

Proporciona los identificadores estables en el siguiente formato:

<ExternalIdentifier>
  <Type>other</Type>
  <OtherType>stable</OtherType>
  <Value>match the regex ^[a-zA-Z0-9_-]+$</Value>
</ExternalIdentifier>

Algunos buenos ejemplos de IDs estables son los identificadores únicos universales (UUID) y Identificadores únicos globales (GUID) Se verían de la siguiente manera:

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

Para mejorar la legibilidad de los datos, es mejor agregar prefijos adicionales y sufijos para desglosar aún más las entidades. Por ejemplo, agrega el prefijo per- a personas o off- de oficinas, ya que no se espera que las ID estables cumplan con ninguna estándar.

Recomendado: per-e55b7dd4-cc98-11ec-9d64-0242ac120002

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

Recomendado: por 123456789012345

No se recomienda: por juan-perez

  • Riesgo: Es posible que otra persona con el mismo nombre tenga el mismo ID.
  • Riesgo: Los cambios en los datos pueden afectar el ID estable.

No recomendado: fuera de presidentes de EE.UU.

Dónde usar IDs estables

Los identificadores estables son obligatorios para los siguientes elementos: