ผู้สมัคร

ใช้ 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 ใช้เพื่อเชื่อมโยงผู้สมัครรับเลือกตั้งกับพรรคการเมือง
PartyLabel	0 หรือ 1	InternationalizedText	ข้อความที่แสดงข้างชื่อผู้สมัครในบัตรลงคะแนนเป็น พรรคของผู้สมัคร แต่ไม่ใช่พรรคที่มีสิทธิ์ลงคะแนน (สำหรับสถานที่ที่อนุญาต)
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	ไม่บังคับ รหัสคณะกรรมการการเลือกตั้ง
tse-candidate-number	12345	ไม่บังคับ ในการเลือกตั้งของบราซิล หมายเลขผู้สมัครรับเลือกตั้งที่ออกโดยศาลเลือกตั้งระดับสูง (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-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"
          }
      ]