Stabilne identyfikatory to stabilne zewnętrznie, unikatowe identyfikatory dla danego obiektu. Umożliwiają konsumentom danych uzgadnianie obiektów we wspólnym formacie danych (CDF) z innymi repozytoriami danych. W żargonie bazy danych słowo „zewnętrzne” identyfikatory to forma klucza obcego, który pozwala konsumentom danych łączyć obiektów w kanale CDF do innych baz danych.
Na przykład, jeśli „Robert Brady” jest kandydatem, konsument danych może nie natychmiast połączyć tę osobę z „Robertem Brady” w bazie danych zdjęć. Pamiętaj jednak: dane CDF i bazy danych zdjęć mogą wskazywać, że dana osoba ustawodawca 01469 zgodnie z informacjami w bazie danych THOMAS Biblioteki Kongresu. Potem konsument danych może połączyć obraz z kandydatem.
W przypadku wszystkich stałych identyfikatorów muszą być spełnione te warunki:
- Stabilność: stały identyfikator danego niepowtarzalnego elementu, np.
Te wartości nie mogą się zmieniać w zależności od wersji danych, np.
Person
lubParty
kanału. Innymi słowy, stały identyfikator nie może zmieniać się w czasie podmiotu zabezpieczeń. - Unikalność: nigdy nie używaj stabilnego identyfikatora dla innego podmiotu, nawet jeśli pierwotnego elementu nie ma już w kanale.
- Spójność: musisz używać tego samego zestawu stałych identyfikatorów dla w razie potrzeby kandydatów, partie lub okręgi wyborcze; w trakcie cyklu wyborczego.
Formatowanie danych
Podaj stabilne identyfikatory w tym formacie:
<ExternalIdentifier>
<Type>other</Type>
<OtherType>stable</OtherType>
<Value>match the regex ^[a-zA-Z0-9_-]+$</Value>
</ExternalIdentifier>
Dobrymi przykładami stabilnych identyfikatorów są uniwersalne unikalne identyfikatory (UUID) i Globalne unikalne identyfikatory (GUID). Mogą one wyglądać tak:
e55b7dd4-cc98-11ec-9d64-0242ac120002
Aby poprawić czytelność danych, lepiej dodać kolejne prefiksy i
sufiksy umożliwiające dalszy podział encji. Na przykład dodaj prefiks per-
do
osób lub off-
w przypadku biur, ponieważ stabilne dokumenty tożsamości nie powinny spełniać
standardowy.
Zalecane: per-e55b7dd4-cc98-11ec-9d64-0242ac120002
Zalecane: off-7849514a-e8bc-11ec-8fea-0242ac120002
Zalecane: per-123456789012345
Niezalecane: per-jan-kowalski
- Zagrożenie: inna osoba o tej samej nazwie może mieć ten sam identyfikator.
- Ryzyko: zmiana danych może mieć wpływ na stabilny identyfikator.
Niezalecane: poza prezydentem USA
Gdzie można używać stałych identyfikatorów
Stabilne identyfikatory są wymagane w przypadku tych elementów:
BallotMeasureSelection
zBallotSelection
Candidate
Coalition
zParty
Contest
Election
Office
Party
Person
ReportingUnit