Gunakan Candidate untuk mendeskripsikan informasi tentang kandidat dalam kontes. Candidate dapat direferensikan oleh entity 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. Dalam jenis kontes terkait ini, Person hanya boleh direferensikan oleh satu Candidate.
Perhatikan contoh berikut:
- Dalam kontes negara bagian yang menyusun kontes nasional, Orang 1 dirujuk oleh Kandidat 1.
- Namun, dalam kontes negara bagian lain yang menyusun kontes nasional yang sama, Orang 1 direferensikan oleh Kandidat 2.
Dalam hal ini, Kandidat 1 dan Kandidat 2 adalah duplikat. Kedua kontes harus merujuk ke Candidate yang sama. Umumnya, jangan sertakan kandidat dalam beberapa
kontes yang tidak terkait atau dalam kontes berikutnya.
Atribut
Tabel berikut menunjukkan 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 menunjukkan 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 kampanyenya apa slogan kampanye mereka. Lihat contoh-contoh berikut dari pemilu presiden Amerika Serikat tahun 2020:
|
ContactInformation |
0 atau lebih | ContactInformation |
Kaitkan 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 mendaftar 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 posisi teratas dalam 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. |
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
advanced-to-runoff. |
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 dari 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 pemilihan umum. |
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-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>