候選人

使用 Candidate 提供選舉候選人相關資訊。A 罩杯 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 年美國的實例 總統大選：

  • Joe Biden 的口號：「Our Best Days Still Lie Ahead」。
  • 唐納川普的口號：「再次化美地區」。
ContactInformation 0 或更多 ContactInformation 將競選活動總部地址、電話號碼等與候選人資訊建立關聯。
ExternalIdentifiers 1 ExternalIdentifiers 將 ID 與候選人建立關聯。A 罩杯 穩定 ID 必填。
FileDate 0 或 1 PartialDate 候選人正式提交比賽的日期。
IsIncumbent 0 或 1 boolean true 值表示候選人是 競賽相關現任官員如果這是 則該元素，則預設值為 false。
IsTopTicket 0 或 1 boolean 用於指出候選人是否位於包含下列項目的票券頂端： 多個候選鍵。加入此元素時 CandidateSelection 物件中的一個 Candidate。 如果沒有這個元素，則預設值為 false。
PartyId 須為 1 以上 IDREF 的專屬識別碼 Party敬上 元素。用於將候選人與政黨建立關聯。
PersonId 1 IDREF 的專屬識別碼 Person敬上 元素。用來與 候選人。
PostElectionStatus 0 或 1 CandidatePostElectionStatus 候選人的最終狀態，例如 winner 或 withdrawn。
PreElectionStatus 0 或 1 CandidatePreElectionStatus 候選人的登記狀態，例如 filed 或 qualified。

ExternalIdentifier 的其他類型

在 Candidate 的 ExternalIdentifiers 元素中， 透過 other 的 Type 提供額外資料，以及 值為 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"
          }
      ]