候選人

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

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

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

  • 在波蘭選舉第 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 或 withdrawn。
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-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"
          }
      ]