ตัวระบุแบบคงที่คือตัวระบุที่ไม่ซ้ำและเสถียรสำหรับ ออบเจ็กต์ ทำให้ผู้บริโภคข้อมูลสามารถปรับยอดออบเจ็กต์ให้ตรงกันในรูปแบบข้อมูลทั่วไปได้ (CDF) ที่มีที่เก็บข้อมูลอื่นๆ ในฐานข้อมูล เป็นภายนอก ตัวระบุเป็นรูปแบบของคีย์นอกที่ทำให้ผู้บริโภคลิงก์ข้อมูลได้ ในฟีด CDF ไปยังฐานข้อมูลอื่น
ตัวอย่างเช่น ถ้า "Robert Brady" เป็นตัวเลือก ผู้บริโภคข้อมูลไม่สามารถ ลิงก์บุคคลนั้นกับ "บ็อบ แบรดี้" ทันที ในฐานข้อมูลรูปภาพ อย่างไรก็ตาม ข้อมูลจาก CDF และฐานข้อมูลรูปภาพอาจบ่งชี้ว่าบุคคลนี้เป็น สมาชิกสภานิติบัญญัติ 01469 ที่ระบุโดยฐานข้อมูล THOMAS ของหอสมุดรัฐสภาอเมริกัน จากนั้น ผู้บริโภคข้อมูลจะลิงก์รูปภาพกับผู้สมัครได้
ตัวระบุแบบคงที่ทั้งหมดต้องมีเงื่อนไขต่อไปนี้
- ความเสถียร: ตัวระบุแบบคงที่สำหรับเอนทิตีที่ไม่ซ้ำกันหนึ่งๆ เช่น
Person
หรือParty
ต้องไม่เปลี่ยนแปลงในข้อมูลเวอร์ชันต่างๆ ฟีด กล่าวคือ รหัสคงที่จะต้องไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไปสำหรับแท็ก เอนทิตี - ความไม่ซ้ำกัน: อย่าใช้ตัวระบุแบบคงที่กับเอนทิตีอื่นโดยเด็ดขาด แม้แต่ หากเอนทิตีเดิมไม่อยู่ในฟีดแล้ว
- ความสอดคล้อง: คุณต้องใช้ตัวระบุแบบคงที่ชุดเดียวกันสำหรับ ผู้สมัคร พรรคการเมือง หรือเขตการศึกษาสำหรับทั้ง 2 การจำลอง หากจำเป็น และ ในช่วงที่มีการเลือกตั้ง
การจัดรูปแบบข้อมูล
ระบุตัวระบุแบบคงที่ในรูปแบบต่อไปนี้
<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
ไม่แนะนำ: per-john-doe
- ความเสี่ยง: บุคคลอื่นที่ใช้ชื่อเดียวกันอาจมีรหัสเหมือนกัน
- ความเสี่ยง: การเปลี่ยนแปลงข้อมูลอาจส่งผลต่อรหัสแบบคงที่
ไม่แนะนำ: นอกสหรัฐฯ
ตำแหน่งที่จะใช้รหัสแบบคงที่
ตัวระบุแบบคงที่จำเป็นสำหรับองค์ประกอบต่อไปนี้
BallotMeasureSelection
จากBallotSelection
Candidate
Coalition
จากParty
Contest
Election
Office
Party
Person
ReportingUnit