Kandidat

Gunakan Candidate untuk mendeskripsikan informasi tentang kandidat dalam kontes. A Candidate dapat direferensikan oleh the CandidateSelection entity.

Pilih salah satu jenis feed berikut untuk mempelajari lebih lanjut cara menggunakan Candidate dengan jenis feed tersebut.

Beberapa pemilu terdiri dari beberapa kontes yang lebih kecil atau melibatkan serangkaian kontes berikutnya. Dalam jenis kontes terkait ini, Person hanya boleh direferensikan oleh satu Candidate. Perhatikan contoh berikut:

  • Pada Putaran 1 pemilu di Polandia, Orang 1 direferensikan oleh Kandidat 1.
  • Namun, pada Putaran 2, Orang 1 direferensikan oleh Kandidat 2.

Dalam hal ini, Kandidat 1 dan Kandidat 2 adalah duplikat. Kedua kontes harus mereferensikan Candidate yang sama. Umumnya, jangan sertakan kandidat dalam beberapa kontes yang tidak terkait.

Atribut

Tabel berikut menampilkan atribut untuk Candidate:

Atribut Wajib? Jenis Deskripsi
objectId Wajib ID ID internal unik yang digunakan oleh elemen lain untuk mereferensikan elemen ini.

Elemen

Tabel berikut menampilkan elemen untuk Candidate:

Elemen Keanekaragaman Jenis Deskripsi
BallotName 1 InternationalizedText Memberikan nama kandidat seperti yang tercantum di surat suara.
CampaignSlogan 0 atau 1 InternationalizedText

Slogan yang Anda dapatkan saat bertanya kepada kandidat atau kampanyenya tentang slogan kampanye mereka. Lihat contoh berikut dari pemilu presiden AS 2020:

  • Slogan Joe Biden: “Our Best Days Still Lie Ahead.”
  • Slogan Donald Trump: “Make America Great Again.“
ContactInformation 0 atau lebih ContactInformation Mengaitkan alamat kantor pusat kampanye, nomor telepon, dll. dengan informasi kandidat.
ExternalIdentifiers 1 ExternalIdentifiers Mengaitkan ID dengan kandidat. ID stabil diperlukan.
FileDate 0 atau 1 PartialDate Tanggal saat kandidat secara resmi mengajukan permohonan untuk kontes.
IsIncumbent 0 atau 1 boolean Nilai true menunjukkan bahwa kandidat adalah pemegang jabatan saat ini yang terkait dengan kontes. Jika elemen ini tidak ada, nilai defaultnya adalah false.
IsNotable 0 atau 1 boolean Apakah entity dianggap penting. Diasumsikan false jika tidak ditentukan.
IsTopTicket 0 atau 1 boolean Menunjukkan apakah kandidat berada di posisi teratas dalam surat suara yang menyertakan beberapa kandidat. Hanya sertakan elemen ini jika ada lebih dari satu Candidate dalam objek CandidateSelection. Jika elemen ini tidak ada, nilai defaultnya adalah false.
PartyId 1 atau lebih IDREF ID unik untuk elemen Party. Digunakan untuk mengaitkan kandidat dengan partai politiknya.
PartyLabel 0 atau 1 InternationalizedText Teks yang dapat muncul di samping nama kandidat di surat suara sebagai partainya tetapi bukan partai yang memenuhi syarat surat suara (untuk tempat yang mengizinkan hal ini).
PersonId 1 IDREF ID unik untuk elemen.Person Digunakan untuk mengaitkan informasi yang lebih mendetail tentang kandidat.
PostElectionStatus 0 atau 1 CandidatePostElectionStatus Status akhir kandidat seperti winner atau withdrawn.
PreElectionStatus 0 atau 1 CandidatePreElectionStatus Status pendaftaran kandidat seperti filed atau qualified.

Jenis tambahan untuk ExternalIdentifiers

Di elemen ExternalIdentifiers dari Candidate, berikan data tambahan dengan Type other, beserta nilai untuk OtherType dan Value. Tabel berikut menampilkan kemungkinan nilai untuk elemen ini:

OtherType Contoh nilai Deskripsi
electoral-commission H2NY22097

Opsional

ID komisi pemilu.
tse-candidate-number 12345

Opsional

Dalam pemilu Brasil, nomor kandidat yang dikeluarkan oleh Superior Electoral Court (Tribunal Superior Eleitoral – TSE).

Contoh

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"
          }
      ]