المعرّفات الثابتة

المعرّفات الثابتة هي معرّفات فريدة وثابتة خارجيًا لمعرّف معيّن . تسمح لمستهلكي البيانات بالتوفيق بين الكائنات في تنسيق بيانات مشترك (CDF) مع مستودعات البيانات الأخرى. في لغة قاعدة البيانات، المعرّفات هي شكل من أشكال المفاتيح الخارجية التي تتيح للمستهلكين ربط البيانات الكائنات في خلاصة CDF إلى قواعد بيانات أخرى.

على سبيل المثال، إذا كان "روبرت برادي" مرشحًا، وقد لا يكون مستهلك البيانات ربط هذا الشخص على الفور بـ "بوب برادي" في قاعدة بيانات الصور لديهم. ومع ذلك، يمكن أن تشير بيانات CDF وقاعدة بيانات الصور إلى أن هذا الشخص المشرِّع 01469 كما هو محدد في قاعدة بيانات مكتبة الكونغرس THOMAS. بَعْدَ ذَلِكْ يمكن لمستهلك البيانات ربط الصورة بالمرشح.

يجب أن تنطبق الشروط التالية على جميع المعرّفات الثابتة:

  • الثبات: هو المعرّف الثابت لكيان فريد معيّن، مثل Person أو Party، يجب ألا تتغير عبر نُسخ مختلفة من البيانات الخلاصة. بمعنى آخر، يجب ألا يتغير المعرّف الثابت بمرور الوقت لرقم تعريف .
  • التفرّد: يجب عدم إعادة استخدام معرّف ثابت لعنصر مختلف، حتى إذا لم يعُد الكيان الأصلي متوفّرًا في الخلاصة
  • الاتساق: يجب استخدام مجموعة المعرِّفات الثابتة نفسها المرشحين أو الأحزاب أو المناطق التعليمية لكل من عمليات المحاكاة، إذا لزم الأمر، خلال الدورة الانتخابية

تنسيق البيانات

قدِّم المعرّفات الثابتة بالتنسيق التالي:

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

من الأمثلة الجيدة على المعرّفات الثابتة المعرّفات الفريدة العامة (UUID) المعرّفات الفريدة العامة (GUID). ستظهر هذه المقاطع على النحو التالي:

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

لتحسين إمكانية قراءة البيانات، يُفضل إضافة المزيد من البادئات لاحقات لتقسيم الكيانات بشكل أكبر. على سبيل المثال، يمكنك إضافة البادئة per- إلى الأشخاص أو off- للمكاتب كمعرّفات مستقرة، من غير المتوقع أن تتوافق مع أي القياسية.

إجراء مقترَح: per-e55b7dd4-cc98-11ec-9d64-0242ac120002

صيغة محبَّذة: off-7849514a-e8bc-11ec-8fea-0242ac120002

مقترَح: لكل 123456789012345

صيغة غير محبَّذة: لكل مستخدم معيّن

  • الخطر: قد يكون شخص آخر يحمل الاسم نفسه رقم التعريف نفسه.
  • خطر: قد يؤثر التغيير في البيانات على المعرّف الثابت.

صيغة غير محبَّذة: خارج نطاق عملنا

أماكن استخدام المعرّفات الثابتة

المعرّفات الثابتة إلزامية للعناصر التالية: