选票

使用 BallotSelection 标识比赛中的选票选项，例如 将候选人和政党与其票数关联起来。

本文档讨论了 BallotSelection 及其子实体：

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

请选择以下 Feed 类型之一，以详细了解如何使用 BallotSelection 及其固有元素与该类型的 Feed 相关联。

<ph type="x-smartling-placeholder"></ph>

BallotSelection

BallotSelection 是一个抽象元素，有三种类型， 竞赛类型：

属性

下表介绍了 BallotSelection 的属性：

属性 是否必需？ 类型 说明
objectId 必填 ID 供其他元素引用的唯一内部标识符 该元素。

元素

下表介绍了 BallotSelection 的元素：

元素 多样性 类型 说明
SequenceOrder 0 或 1 integer

指定选票显示的默认顺序 目的。

如果 Feed 中不存在 SequenceOrder，则表示没有订单 。

CandidateSelection

使用 CandidateSelection 标识候选人的选票选项 竞赛，包括写作。

CandidateSelection 会继承属性 和 BallotSelection 的元素。引用多个 在以下情况下可包含 Candidate 元素： 例如，当选票涉及的是一张多张票券时 候选人。

当工单引用多个候选人时，有时很重要 以保持候选项的顺序。在这两种情况下，我们预计 生成应用来列出 Candidate 元素 CandidateIds。例如： 候选字词的顺序必须与 Office 元素引用 Contest 中的 OfficeIds CandidateContest。

如果引用了多个 Candidate 对象，系统会将这些对象呈现给用户 依次为：

  • 所有 IsTopTicket 设置为 true 的候选定位设置都排在所有人的前面 没有 IsTopTicket 值的候选对象。反过来，它们会提前 的所有候选项，IsTopTicket 设置为 false。理想情况下， 使用一个候选定位设置（没有 IsTopTicket 值），或者 是一对候选项，其中一个的 IsTopTicket 设置为 true。 如果不满足这些条件，则会发生以下情况： <ph type="x-smartling-placeholder">
      </ph>
    • 所有将 IsTopTicket 设置为 true 的候选项均显示在 顺序。
    • 所有没有IsTopTicket的候选词都会显示在 顺序。
    • 所有将 IsTopTicket 设置为 false 的候选项均显示在 顺序。

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

元素

下表介绍了 CandidateSelection 的元素：

元素 多样性 类型 说明
CandidateIds 1 IDREFS 一个或多个资源的唯一标识符 Candidate 元素。用于将候选人与 的候选人选择相关联 投票。当选票涉及多个 （例如一张总统和副总裁的门票） 。
EndorsementPartyIds 0 或更多 IDREFS 两个或多个应用的唯一标识符 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 一个或多个资源的唯一标识符 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 与选票议案选项相关联。答 稳定标识符 为必填字段。
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"
          },
        ]
      }
    ]