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