ID stabil

ID stabil adalah ID unik yang stabil secara eksternal untuk . Keduanya memungkinkan konsumen data merekonsiliasi objek dalam Format Data Umum (CDF) dengan repositori data lain. Dalam bahasa {i>database<i}, eksternal ID adalah bentuk {i>foreign key<i} yang memungkinkan konsumen data menautkan objek dalam feed CDF ke database lain.

Misalnya, jika "Robert Brady" adalah kandidat, konsumen data mungkin segera menautkan orang itu ke "Bob Brady" dalam database gambar mereka. Namun, data CDF dan {i>database<i} gambar dapat menunjukkan bahwa orang ini legislator 01469 yang diidentifikasi oleh {i>database <i}Perpustakaan THOMAS. Selanjutnya konsumen data dapat menghubungkan gambar dengan kandidat.

Kondisi berikut harus berlaku untuk semua ID stabil:

  • Stabilitas: ID yang stabil untuk entitas unik tertentu, seperti Person atau Party, tidak boleh berubah di berbagai versi data feed Anda. Dengan kata lain, ID stabil tidak boleh berubah dari waktu ke waktu untuk entitas.
  • Keunikan: Jangan pernah menggunakan kembali ID yang stabil untuk entitas berbeda, bahkan jika entitas asli tidak lagi ada di feed.
  • Konsistensi: Anda harus menggunakan kumpulan ID stabil yang sama untuk kepada kandidat, partai, atau distrik untuk kedua simulasi tersebut, jika diperlukan, dan selama putaran pemilu.

Pemformatan data

Berikan ID stabil dalam format berikut:

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

Beberapa contoh yang baik dari ID Stabil adalah ID Unik Universal (UUID) dan ID Unik Global (GUID). Hal ini akan terlihat seperti:

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

Untuk meningkatkan keterbacaan data, sebaiknya tambahkan awalan dan akhiran untuk memecah entity lebih lanjut. Misalnya, tambahkan awalan per- ke orang atau off- untuk kantor sebagai tanda pengenal stabil tidak diharapkan mematuhi standar.

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

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

Direkomendasikan: per-123456789012345

Tidak direkomendasikan: per-john-doe

  • Risiko: Orang lain dengan nama yang sama mungkin memiliki ID yang sama.
  • Risiko: Perubahan data mungkin memengaruhi ID stabil.

Tidak direkomendasikan: di luar presiden kami

Tempat menggunakan ID stabil

ID stabil bersifat wajib untuk elemen berikut: