使用 Candidate 描述競賽中候選人的相關資訊。Candidate 可由 CandidateSelection 實體參照。
選取下列其中一種動態饋給類型，進一步瞭解如何搭配使用 Candidate 與該類型的動態饋給。
部分選舉由多個較小的競賽組成。在這些相關競賽中，Person 只能由一個 Candidate 參照。請參考以下範例：
- 在組成全國性選舉的州選舉中，候選人 1 參照了人員 1。
- 不過，在另一個州級競賽中，如果與全國競賽相同， 候選人 2 則會參考候選人 1。
在本例中，候選人 1 和候選人 2 是重複項目。兩個競賽都必須參照相同的 Candidate。一般來說，請勿讓候選人在多個不相關的比賽或後續比賽中出現。
屬性
下表顯示 Candidate 的屬性：
| 屬性 | 是否必要？ | 類型 | 說明 |
|---|---|---|---|
objectId |
必填 | ID |
其他元素用來參照這個元素的專屬內部 ID。 |
元素
下表顯示 Candidate 的元素：
| 元素 | 多重性 | 類型 | 說明 |
|---|---|---|---|
BallotName |
1 | InternationalizedText |
提供選票上列出的候選人姓名。 |
CampaignSlogan |
0 或 1 |
InternationalizedText |
詢問候選人或其競選團隊競選口號時，對方給出的答案。請參閱 2020 年美國總統大選的例子：
|
ContactInformation |
0 以上 | ContactInformation |
將競選總部地址、電話號碼等資訊與候選人資訊建立關聯。 |
ExternalIdentifiers |
1 | ExternalIdentifiers |
將 ID 與候選人建立關聯。必須提供穩定 ID。 |
FileDate |
0 或 1 | PartialDate |
候選人正式登記參賽的日期。 |
IsIncumbent |
0 或 1 | boolean |
如果值為 true，表示候選人是與該競選相關聯的現任官員。如果沒有這個元素，預設值為 false。 |
IsNotable |
0 或 1 | boolean |
實體是否被視為值得注意。如未指定，系統會假設為 false。
|
IsTopTicket |
0 或 1 | boolean |
指出候選人是否為包含多位候選人的選票頂端。只有在 CandidateSelection 物件中有多個 Candidate 時，才加入這個元素。如果沒有使用這個元素，預設值會是 false。 |
PartyId |
須為 1 以上 | IDREF |
Party 元素的專屬 ID。用於將候選人與所屬政黨建立關聯。 |
PartyLabel |
0 或 1 | InternationalizedText |
可顯示在選票上候選人姓名旁的文字，代表候選人所屬政黨，但該政黨不符合選票資格 (適用於允許此類文字的地區)。 |
PersonId |
1 | IDREF |
Person 元素的專屬 ID。用於關聯候選人的詳細資訊。 |
PostElectionStatus |
0 或 1 | CandidatePostElectionStatus |
候選人的最終狀態，例如 winner 或 withdrawn。 |
PreElectionStatus |
0 或 1 | CandidatePreElectionStatus |
候選人的註冊狀態，例如 filed 或 qualified。 |
ExternalIdentifiers 的其他類型
在 ExternalIdentifiers 的 Candidate 元素中，提供 Type 為 other 的額外資料，以及 OtherType 和 Value 的值。下表列出這些元素的可能值：
| OtherType | 範例值 | 說明 |
|---|---|---|
electoral-commission |
H2NY22097 |
選用 選舉委員會 ID。 |
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-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>