ใช้ Candidate เพื่ออธิบายข้อมูลเกี่ยวกับผู้สมัครในการแข่งขัน A
Candidate สามารถอ้างอิงโดยเอนทิตี
CandidateSelection
ได้
เลือกฟีดประเภทใดประเภทหนึ่งต่อไปนี้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ Candidate กับฟีดประเภทนั้น
การเลือกตั้งบางรายการประกอบด้วยการแข่งขันย่อยๆ หลายรายการ ในการแข่งขันที่เกี่ยวข้องประเภทนี้ Person ต้องอ้างอิงโดย Candidate เพียงคนเดียว
ลองดูตัวอย่างต่อไปนี้
- ในการแข่งขันระดับรัฐซึ่งประกอบด้วยการแข่งขันระดับประเทศ บุคคลที่ 1 อ้างอิงโดยผู้สมัครที่ 1
- อย่างไรก็ตาม ในการแข่งขันระดับรัฐอีกรายการหนึ่งซึ่งประกอบด้วยการแข่งขันระดับประเทศเดียวกัน บุคคลที่ 1 อ้างอิงโดยผู้สมัครที่ 2
ในกรณีนี้ ผู้สมัครที่ 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 ในออบเจ็กต์ CandidateSelection
หากไม่มีองค์ประกอบนี้ ค่าเริ่มต้นจะเป็น false |
PartyId |
1 รายการขึ้นไป | IDREF |
ตัวระบุที่ไม่ซ้ำกันสำหรับ
Party
องค์ประกอบ ใช้เพื่อเชื่อมโยงผู้สมัครกับพรรคการเมือง |
PartyLabel |
0 หรือ 1 | InternationalizedText |
ข้อความที่อาจปรากฏข้างชื่อผู้สมัครในบัตรลงคะแนนเป็นพรรคของผู้สมัคร แต่ไม่ใช่พรรคที่มีสิทธิ์ลงคะแนน (สำหรับสถานที่ที่อนุญาต) |
PersonId |
1 | IDREF |
ตัวระบุที่ไม่ซ้ำกันสำหรับa
Person
องค์ประกอบ ใช้เพื่อเชื่อมโยงข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับผู้สมัคร
|
PostElectionStatus |
0 หรือ 1 | CandidatePostElectionStatus |
สถานะสุดท้ายของผู้สมัคร เช่น winner หรือ
advanced-to-runoff |
PreElectionStatus |
0 หรือ 1 | CandidatePreElectionStatus |
สถานะการลงทะเบียนของผู้สมัคร เช่น filed หรือ
qualified |
ประเภทเพิ่มเติมสำหรับ ExternalIdentifiers
ในองค์ประกอบ ExternalIdentifiers ของ Candidate ให้ระบุข้อมูลเพิ่มเติมที่มี Type เป็น other พร้อมกับค่าสำหรับ OtherType และ Value ตารางต่อไปนี้แสดงค่าที่เป็นไปได้สำหรับองค์ประกอบเหล่านี้
| OtherType | ค่าตัวอย่าง | คำอธิบาย |
|---|---|---|
electoral-commission |
H2NY22097 |
ไม่บังคับ รหัสคณะกรรมการการเลือกตั้ง |
tse-candidate-number |
12345 |
ไม่บังคับ ในการเลือกตั้งของบราซิล หมายเลขผู้สมัครที่ออกโดยศาลเลือกตั้งระดับสูง Electoral Court (Tribunal Superior Eleitoral – TSE) |
ตัวอย่าง
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-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>