候選人

使用 Candidate 描述競賽候選人的相關資訊。CandidateSelection 實體可參照 Candidate。

選取下列其中一種動態饋給類型，進一步瞭解如何搭配該類型的動態饋給使用 Candidate。

有些選舉是由多個小型競選活動組成，或涉及一系列後續競選活動。在這類相關競賽中，Person 只能由一個 Candidate 參照。請見以下範例：

  • 在組成全國選舉的州選舉中，候選人 1 參照了人物 1。
  • 不過，在組成同一場全國競選活動的另一場州競選活動中，候選人 2 提及了人物 1。

或：

  • 在波蘭選舉第 1 輪中，候選人 1 提及人物 1。
  • 不過，在第 2 輪中，候選人 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 或 advanced-to-runoff。
PreElectionStatus 0 或 1 CandidatePreElectionStatus 候選人的登記狀態，例如 filed 或 qualified。

ExternalIdentifiers 的其他類型

在 Candidate 的 ExternalIdentifiers 元素中，提供 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>