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
oParty
, 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:
BallotMeasureSelection
de unBallotSelection
Candidate
Coalition
deParty
Contest
Election
Office
Party
Person
ReportingUnit