ใช้ Candidate เพื่ออธิบายข้อมูลเกี่ยวกับผู้เข้าแข่งขัน Candidate สามารถอ้างอิงได้โดยเอนทิตี
CandidateSelection
เลือกประเภทฟีดต่อไปนี้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้
Candidate กับฟีดประเภทนั้น
การเลือกตั้งบางครั้งประกอบด้วยการแข่งขันย่อยๆ หลายรายการ หรือเกี่ยวข้องกับการแข่งขันที่ต่อเนื่องกันหลายครั้ง
ในการแข่งขันที่เกี่ยวข้องประเภทนี้ Person ต้องอ้างอิงโดย Candidate เพียงรายการเดียว ลองดูตัวอย่างต่อไปนี้
- ในการเลือกตั้งรอบที่ 1 ในโปแลนด์ ผู้สมัครรับเลือกตั้ง 1 อ้างอิงถึงบุคคล 1
- แต่ในรอบที่ 2 ผู้สมัคร 2 อ้างอิงถึงผู้สมัคร 1
ในกรณีนี้ ผู้สมัคร 1 และผู้สมัคร 2 เป็นข้อมูลที่ซ้ำกัน การแข่งขันทั้ง 2 รายการต้อง
อ้างอิงถึง Candidate เดียวกัน โดยทั่วไปแล้ว อย่าใส่ผู้สมัครรับเลือกตั้งใน
การแข่งขันที่ไม่เกี่ยวข้องหลายรายการ
Attributes
ตารางต่อไปนี้แสดงแอตทริบิวต์สำหรับ Candidate
| แอตทริบิวต์ | จำเป็นหรือไม่ | ประเภท | คำอธิบาย |
|---|---|---|---|
objectId |
ต้องระบุ | ID |
ตัวระบุภายในที่ไม่ซ้ำกันซึ่งองค์ประกอบอื่นๆ ใช้เพื่ออ้างอิงถึง องค์ประกอบนี้ |
องค์ประกอบ
ตารางต่อไปนี้แสดงองค์ประกอบสำหรับ Candidate
| องค์ประกอบ | ความหลากหลาย | ประเภท | คำอธิบาย |
|---|---|---|---|
BallotName |
1 | InternationalizedText |
ระบุชื่อผู้สมัครตามที่ระบุไว้ในบัตรเลือกตั้ง |
CampaignSlogan |
0 หรือ 1 |
InternationalizedText |
สโลแกนที่คุณได้รับเมื่อถามผู้สมัครหรือแคมเปญของผู้สมัคร ว่าสโลแกนของแคมเปญคืออะไร ดูตัวอย่างเหล่านี้จากการเลือกตั้ง ประธานาธิบดีสหรัฐอเมริกาปี 2020
|
ContactInformation |
0 ขึ้นไป | ContactInformation |
เชื่อมโยงที่อยู่สำนักงานใหญ่ของแคมเปญ หมายเลขโทรศัพท์ ฯลฯ กับข้อมูลผู้สมัครรับเลือกตั้ง |
ExternalIdentifiers |
1 | ExternalIdentifiers |
เชื่อมโยงรหัสกับผู้สมัคร ต้องมี ตัวระบุที่เสถียร |
FileDate |
0 หรือ 1 | PartialDate |
วันที่ผู้สมัครลงทะเบียนเข้าร่วมการแข่งขันอย่างเป็นทางการ |
IsIncumbent |
0 หรือ 1 | boolean |
ค่า true บ่งชี้ว่าผู้สมัครเป็นผู้ดำรงตำแหน่งปัจจุบันของสำนักงานที่เกี่ยวข้องกับการแข่งขัน หากไม่มีองค์ประกอบนี้ ค่าเริ่มต้นจะเป็น false
|
IsNotable |
0 หรือ 1 | boolean |
พิจารณาว่าเอนทิตีนั้นน่าสนใจหรือไม่ ระบบจะถือว่าเป็น false
หากไม่ได้ระบุ
|
IsTopTicket |
0 หรือ 1 | boolean |
ระบุว่าผู้สมัครเป็นผู้สมัครที่อยู่ด้านบนสุดของคำขอที่มีผู้สมัครหลายรายหรือไม่
ระบุองค์ประกอบนี้เฉพาะเมื่อมี Candidate มากกว่า 1 รายการในออบเจ็กต์ CandidateSelection
หากไม่มีองค์ประกอบนี้ ค่าเริ่มต้นจะเป็น false |
PartyId |
1 รายการขึ้นไป | IDREF |
ตัวระบุที่ไม่ซ้ำกันสำหรับองค์ประกอบ
Party
ใช้เพื่อเชื่อมโยงผู้สมัครรับเลือกตั้งกับพรรคการเมือง |
PersonId |
1 | IDREF |
ตัวระบุที่ไม่ซ้ำกันสำหรับองค์ประกอบ
Person
ใช้เพื่อเชื่อมโยงข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับ
ผู้สมัคร |
PostElectionStatus |
0 หรือ 1 | CandidatePostElectionStatus |
สถานะสุดท้ายของผู้สมัคร เช่น winner หรือ
withdrawn |
PreElectionStatus |
0 หรือ 1 | CandidatePreElectionStatus |
สถานะการจดทะเบียนของผู้สมัคร เช่น filed หรือ
qualified |
ประเภทเพิ่มเติมสำหรับ ExternalIdentifiers
ในองค์ประกอบ ExternalIdentifiers ของ Candidate
ให้ระบุข้อมูลเพิ่มเติมด้วย Type ที่มีค่าเป็น other พร้อมกับค่าสำหรับ OtherType และ Value ตารางต่อไปนี้แสดงค่าที่เป็นไปได้สำหรับองค์ประกอบเหล่านี้
| OtherType | ค่าตัวอย่าง | คำอธิบาย |
|---|---|---|
electoral-commission |
H2NY22097 |
ไม่บังคับ รหัสคณะกรรมการการเลือกตั้ง |
ตัวอย่าง
XML
<Candidate objectId="can-1001-kenyatta"> <BallotName> <Text language="en">Uhuru Kenyatta</Text> <Text language="sw">Uhuru Kenyatta</Text> </BallotName> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>can-per-100</Value> </ExternalIdentifier> <ExternalIdentifier> <Type>other</Type> <OtherType>electoral-commission</OtherType> <Value>H2NY22097</Value> </ExternalIdentifier> </ExternalIdentifiers> <IsIncumbent>1</IsIncumbent> <IsTopTicket>1</IsTopTicket> <PartyId>par-jubilee</PartyId> <PartyId>par-0002</PartyId> <PersonId>per-001-kenyatta</PersonId> <PostElectionStatus>projected-winner</PostElectionStatus> <PreElectionStatus>qualified</PreElectionStatus> </Candidate>
JSON
"Candidate": [ { "objectId": "can-1001-kenyatta", "BallotName": { "Text": [ { "value": "Uhuru Kenyatta", "language": "en" }, { "value": "Uhuru Kenyatta", "language": "sw" } ] }, "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "can-per-100" }, { "Type": "other", "OtherType": "electoral-commission", "Value": "H2NY22097" }, ] } "IsIncumbent": 1, "IsTopTicket": 1, "PartyId": ["par-jubilee","par-0002"] "PersonId": "per-001-kenyatta", "PostElectionStatus": "projected-winner", "PreElectionStatus": "qualified" } ]