Identificadores estables

Los identificadores estables son un identificador único y estable externamente para un objeto determinado. Permiten que los consumidores de datos concilien objetos en un feed de formato de datos común (CDF) con otros repositorios de datos. En términos de base de datos, los identificadores externos son una forma de clave externa que permite a los consumidores de datos vincular objetos en un feed de CDF con otras bases de datos.

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

Las siguientes condiciones deben ser válidas para todos los identificadores estables:

  • Estabilidad: El identificador estable de una entidad única determinada, como Person o Party, no debe cambiar entre diferentes versiones del feed de datos. En otras palabras, el ID estable no debe cambiar con el tiempo para una entidad específica.
  • Unicidad: Nunca vuelvas a usar un identificador estable para una entidad diferente, incluso si la entidad original ya no está en el feed.
  • Coherencia: Debes usar el mismo conjunto de identificadores estables para los candidatos, los partidos o los distritos en 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 los 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 y sufijos adicionales para desglosar aún más las entidades. Por ejemplo, agrega el prefijo per- a personas o off- para oficinas, ya que no se espera que los IDs estables cumplan con ningún estándar.

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

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

Se recomienda: per-123456789012345

No recomendado: 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 se recomienda: Fuera de casa

Dónde usar IDs estables

Los identificadores estables son obligatorios para los siguientes elementos: