Kandidat

Gunakan Candidate untuk mendeskripsikan informasi tentang kandidat dalam kontes. Candidate dapat dirujuk oleh entitas CandidateSelection.


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 dirujuk oleh satu Candidate. Perhatikan contoh berikut:

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

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

Atribut

Tabel berikut menunjukkan atribut untuk Candidate:

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

Elemen

Tabel berikut menampilkan elemen untuk Candidate:

Elemen Keanekaragaman Jenis Deskripsi
BallotName 1 InternationalizedText Memberikan nama kandidat sebagaimana tercantum dalam surat suara.
CampaignSlogan 0 atau 1 InternationalizedText

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

  • Slogan Joe Biden: “Hari Terbaik Kita Masih di Depan”.
  • Slogan Donald Trump: “Make America Great Again (Jadikan Amerika Hebat Lagi)“.
ContactInformation 0 atau lebih ContactInformation Mengaitkan alamat kantor pusat kampanye, nomor telepon, dll. dengan informasi kandidat.
ExternalIdentifiers 1 ExternalIdentifiers Mengaitkan ID dengan kandidat. A ID stabil wajib diisi.
FileDate 0 atau 1 PartialDate Tanggal saat kandidat secara resmi mengajukan diri 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, defaultnya adalah false.
IsNotable 0 atau 1 boolean Apakah entitas dianggap penting. Diasumsikan false jika tidak ditentukan.
IsTopTicket 0 atau 1 boolean Menunjukkan apakah kandidat berada di bagian atas tiket yang mencakup beberapa kandidat. Sertakan elemen ini hanya jika ada lebih dari satu Candidate dalam objek CandidateSelection. Jika elemen ini tidak ada, defaultnya adalah false.
PartyId 1 atau lebih IDREF ID unik untuk elemen Party. Digunakan untuk mengaitkan kandidat dengan partai politiknya.
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

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

OtherType Contoh nilai Deskripsi
electoral-commission H2NY22097

Opsional

ID komisi pemilu.

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