選擇球

使用 BallotSelection 識別比賽的投票選項，例如 連結候選人與各方的票數。

本文件討論 BallotSelection 及其子實體：

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

請選取下列其中一種動態饋給類型，進一步瞭解如何使用 BallotSelection 及其具有該類動態饋給的固有元素。

BallotSelection

BallotSelection 是抽像元素，其中包含三種類型 比賽類型：

屬性

下表說明 BallotSelection 的屬性：

屬性 必填與否 類型 說明
objectId 必填 ID 其他元素所使用的不重複內部 ID 這個元素

元素

下表將說明 BallotSelection 的元素：

元素 多重性 類型 說明
SequenceOrder 0 或 1 integer

指定投票選項的預設顯示順序 用途。

如果「SequenceOrder」沒有出現在動態饋給中，表示沒有訂單 假設

CandidateSelection

使用 CandidateSelection 來識別候選人的選票選項 比賽，包括寫作功能。

CandidateSelection 會沿用這些屬性 以及 BallotSelection 的元素參照多個項目 可納入 Candidate 元素，前提是 可能必須填寫，例如從投票選擇項目為多票票時。 候選檔案。

一張票券參照多位候選人時，有時候很重要 以保留候選項目的排序。在這種情況下，請預期 產生應用程式，列出 內含 Candidate 元素 CandidateIds。例如： 候選人的順序必須與 其中 Office 元素參照 類別 Contest 中的 OfficeIds CandidateContest。

如果參照多個 Candidate 物件，系統會向使用者顯示這些物件 順序：

  • 系統會將 IsTopTicket 設為 true 的所有候選項目排在先後順序 沒有 IsTopTicket 值的候選項目。因此他們排在第一位 所有工作的 IsTopTicket 設為 false。在理想情況下 設有一個缺少 IsTopTicket 值的候選項目，或者 是一組候選，而其中一個將 IsTopTicket 設定為 true。 如果不符合這些條件，會發生下列情況：
    • 所有 IsTopTicket 設為 true 的候選項目都會顯示在
    • 所有符合 IsTopTicket 的候選項目都顯示在
    • 所有 IsTopTicket 設為 false 的候選項目都會顯示在

CandidateSelection 的 XML 語法如下： <BallotSelection xsi:type="CandidateSelection">。

元素

下表將說明 CandidateSelection 的元素：

元素 多重性 類型 說明
CandidateIds 1 IDREFS 一或多組專屬 ID Candidate敬上 元素。用於將候選人與所選候選項目建立關聯 投票。如果選票選項為多個選項，這個功能也相當實用 候選人，例如總統和副總裁 全部選取。
EndorsementPartyIds 0 或更多 IDREFS 兩個以上的專屬 ID Party 實體。 這代表政黨出現相同的政黨 選票上的候選人。
IsWriteIn 0 或 1 boolean 指出候選者是否為書面。預設值為 false。

範例

XML

    <BallotSelection objectId="cs10861" xsi:type="CandidateSelection">
      <CandidateIds>can10861a can10861b</CandidateIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "CandidateSelection",
        "objectId": "cs10861",
        "CandidateIds": [
          "can10861a",
          "can10861b"
        ]
      }
    ]

PartySelection

使用 PartySelection 找出涉及一方的投票選項，例如 選票上的派對清單

PartySelection 繼承 BallotSelection 的屬性和元素。 PartySelection 的 XML 語法如下： <BallotSelection xsi:type="PartySelection" ... />。

元素

下表將說明 PartySelection 的元素：

元素 多重性 類型 說明
PartyIds 1 IDREFS 一或多個項目的專屬 ID Party敬上 元素。用於將一或多個方與一方建立關聯 。

範例

XML

    <BallotSelection objectId="ps150" xsi:type="PartySelection">
      <PartyIds>par100</PartyIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "PartySelection",
        "objectId": "ps150",
        "PartyIds": [
          "par100"
        ]
      }
    ]

BallotMeasureSelection

使用 BallotMeasureSelection 找出涉及投票的選票選擇 投票議案，例如公投

BallotMeasureSelection 會沿用 BallotSelection。BallotMeasureSelection 的 XML 語法如下： <BallotSelection xsi:type="BallotMeasureSelection" ... />。

元素

下表將說明 BallotMeasureSelection 的元素：

元素 多重性 類型 說明
ExternalIdentifiers 1 ExternalIdentifiers 將 ID 與選票議案選項建立關聯。A 罩杯 穩定 ID 必填。
Selection 1 InternationalizedText 提供可選擇的投票選項，例如 Yes 或 No。

範例

XML

    <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bmc0_yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "BallotMeasureSelection",
        "objectId": "bms00",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0_yes"
            }
          ]
        }
        "Text": [
          {
            "value": "Yes",
            "language": "en"
          },
        ]
      }
    ]

XML

    <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bmc0_yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "BallotMeasureSelection",
        "objectId": "bms00",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0_yes"
            }
          ]
        }
        "Text": [
          {
            "value": "Yes",
            "language": "en"
          },
        ]
      }
    ]