候選人

使用 Candidate 說明競賽中候選人的相關資訊。Candidate 可由 CandidateSelection 實體參照。

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

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

  • 在波蘭選舉第 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。用於將候選人與所屬政黨建立關聯。
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。

範例

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