شناسههای پایدار، شناسههای منحصر به فرد و پایدار خارجی برای یک شیء معین هستند. آنها به مصرفکنندگان داده اجازه میدهند اشیاء موجود در یک فید فرمت داده مشترک (CDF) را با سایر مخازن داده تطبیق دهند. در اصطلاح پایگاه داده، شناسههای خارجی نوعی کلید خارجی هستند که به مصرفکنندگان داده اجازه میدهند اشیاء موجود در یک فید CDF را به سایر پایگاههای داده پیوند دهند.
به عنوان مثال، اگر «رابرت بردی» یک نامزد باشد، ممکن است مصرفکننده داده بلافاصله آن شخص را به «باب بردی» در پایگاه داده تصویر خود مرتبط نکند. با این حال، دادههای CDF و پایگاه داده تصویر میتوانند نشان دهند که این شخص، همانطور که توسط پایگاه داده کتابخانه کنگره 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
استفاده از نمادگذاری مجارستانی برای تجزیه بیشتر موجودیتها، بهترین روش برای بهبود خوانایی دادهها است، اما الزامی نیست. انتظار نمیرود محتوای شناسههای پایدار با هیچ استانداردی فراتر از منحصر به فرد بودن و پایداری که قبلاً توضیح داده شد، مطابقت داشته باشد.
نمونههایی از پیشوندها:
-
eElection -
cبرایContest -
canبرایCandidate - برای
perPerson -
parبرایParty -
offبرایOffice -
ohبرایOfficeHolderTenure -
gbبرایGovernmentBody -
ciبرایContactInformation -
ruبرایReportingUnit -
bmsبرایBallotMeasureSelection -
csبرایCandidateSelection -
psبرایPartySelection -
sbsبرایSpecialBallotSelection -
plبرایPartyLeadership -
dsبرایDataSource -
comبرایCommittee -
ecبرایElectoralCommission
توصیه شده: per-e55b7dd4-cc98-11ec-9d64-0242ac120002
توصیه شده: off-7849514a-e8bc-11ec-8fea-0242ac120002
توصیه شده: per-123456789012345
توصیه نمیشود: به ازای هر جان دو
- خطر: ممکن است شخص دیگری با همین نام، همان کارت شناسایی را داشته باشد.
- ریسک: تغییر در دادهها ممکن است بر شناسه پایدار تأثیر بگذارد.
توصیه نمیشود: خارج از رئیس جمهور ما
کجا از شناسههای پایدار استفاده کنیم؟
شناسههای پایدار برای عناصر زیر الزامی هستند:
- انتخاب یک
BallotMeasureSelectionبا استفاده ازBallotSelection -
Candidate -
CoalitionیکParty -
Contest -
Election -
Office -
Party -
Person -
ReportingUnit