Stabile Kennungen sind extern stabile, eindeutige Kennungen für eine bestimmte -Objekt enthält. Sie ermöglichen es Datennutzern, Objekte in einem gemeinsamen Datenformat abzugleichen (CDF) mit anderen Daten-Repositories. In Datenbankausdrücken Kennungen sind eine Form von Fremdschlüsseln, mit denen Verbraucher Daten verknüpfen können. -Objekten in einem CDF-Feed zu anderen Datenbanken.
Wenn z. B. „Robert Brady“ ein Kandidat ist, kann ein Datenverbraucher diese Person sofort mit "Bob Brady" in ihrer Bilddatenbank. Sie können jedoch Die CDF-Daten und die Bilddatenbank könnten darauf hinweisen, dass diese Person legislator 01469 gemäß der THOMAS-Datenbank der Library of Congress. Dann kann der Daten-Consumer das Image mit dem Kandidaten verknüpfen.
Für alle stabilen Kennungen gelten die folgenden Bedingungen:
- Stabilität:Die stabile Kennung für eine bestimmte eindeutige Entität, z. B. eine
Person
oderParty
dürfen in verschiedenen Versionen der Daten nicht geändert werden Feed. Mit anderen Worten: Die stabile ID darf sich im Laufe der Zeit für einen bestimmten Entität. - Eindeutigkeit:Verwenden Sie niemals eine stabile ID für eine andere Entität, auch Die ursprüngliche Entität ist nicht mehr im Feed vorhanden.
- Konsistenz:Sie müssen denselben Satz stabiler Kennungen für Kandidaten, Parteien oder Bezirke für beide Simulationen, falls erforderlich, und während des Wahlzyklus.
Datenformatierung
Geben Sie die stabilen IDs im folgenden Format an:
<ExternalIdentifier>
<Type>other</Type>
<OtherType>stable</OtherType>
<Value>match the regex ^[a-zA-Z0-9_-]+$</Value>
</ExternalIdentifier>
Gute Beispiele für stabile IDs sind UUIDs (Universal Unique Identifiers) und Global Unique Identifiers (GUIDs): Diese sehen in etwa so aus:
e55b7dd4-cc98-11ec-9d64-0242ac120002
Um die Lesbarkeit der Daten zu verbessern, ist es besser, zusätzliche Präfixe und
Suffixe, um Entitäten weiter aufzuschlüsseln. Fügen Sie beispielsweise das Präfix per-
Personen oder off-
für Büros als feste Ausweise müssen keine
Standard.
Empfohlen:per-e55b7dd4-cc98-11ec-9d64-0242ac120002
Empfohlen:off-7849514a-e8bc-11ec-8fea-0242ac120002
Empfohlen:pro-123456789012345
Nicht empfohlen:per-john-doe
- Risiko: Eine andere Person mit demselben Namen kann dieselbe ID besitzen.
- Risiko: Änderungen an den Daten können sich auf die stabile ID auswirken.
Nicht empfohlen:außerhalb des US-Präsidenten
Wo werden stabile IDs verwendet?
Stabile Kennzeichnungen sind für die folgenden Elemente obligatorisch:
BallotMeasureSelection
vonBallotSelection
Candidate
Coalition
vonParty
Contest
Election
Office
Party
Person
ReportingUnit