風船選択

BallotSelection を使用して、選挙候補者と政党をそれぞれの投票数にリンクする場合などに、投票用紙の選択肢を識別します。

このドキュメントでは、BallotSelection とそのサブエンティティについて説明します。

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

次のいずれかのフィードタイプを選択して、BallotSelection とその固有の要素を特定のタイプのフィードで使用する方法をご確認ください。

BallotSelection

BallotSelection は、コンテストのタイプに基づいて使用される 3 つのタイプを持つ抽象要素です。

  • CandidateSelection: コンテストが 1 人以上の候補者を対象としている場合は、BallotSelection のこの type を使用します。投票用紙の選択肢を Candidate 要素にリンクします。
  • PartySelection: コンテスト タイプが Party の場合（パーティー 比例コンテストなど）は、BallotSelection の type を使用します。
  • BallotMeasureSelection: このタイプの BallotSelection を使用して、BallotMeasureContest で可能な選択を表します。

属性

次の表に、BallotSelection の属性を示します。

属性 必須かどうか 種類 説明
objectId 必須 ID 他の要素がこの要素を参照するために使用する一意の内部識別子。

要素

次の表に、BallotSelection の要素を示します。

要素 重複 種類 説明
SequenceOrder 0 または 1 integer

表示のために投票選択のデフォルトの順序を指定します。

SequenceOrder がフィード内に存在しない場合、順序は考慮されません。
VoteCountsCollection 0 以上 なし VoteCounts 要素のコレクションのラッパー。詳しくは、コレクション エンティティをご覧ください。

CandidateSelection

CandidateSelection を使用して、受験者コンテストの投票対象を指定します（入力を含む）。

CandidateSelection は BallotSelection の属性と要素を継承します。必要に応じて、複数の Candidate 要素への参照を含めることができます。たとえば、複数の候補者のチケットの投票用です。

1 つのチケットで複数の候補が参照される場合、候補の順序を維持することが重要な場合があります。このような場合、生成元のアプリケーションは、適用されている順序指定スキームに従って CandidateIds 内の Candidate 要素への参照をリストすることが想定されます。たとえば、候補の順序は、CandidateContest 型の Contest の OfficeIds 内の Office 要素参照と同じ順序と一致する必要があります。

複数の Candidate オブジェクトが参照されている場合は、次の順序でユーザーに表示されます。

  • IsTopTicket が true に設定されているすべての候補は、IsTopTicket 値のないすべての候補より先に配置されます。これらの候補は、IsTopTicket が false に設定されたすべての候補より先に並べられます。理想的には、IsTopTicket 値のない 1 つの候補で選択を設定するか、候補のペアがあり、そのうちの 1 つが IsTopTicket を true に設定してください。これらの条件が満たされない場合、次のようになります。
    • IsTopTicket が true に設定されているすべての候補が未定義の順序で表示されます。
    • IsTopTicket が存在しないすべての候補は、未定義の順序で表示されます。
    • IsTopTicket が false に設定されているすべての候補が未定義の順序で表示されます。

CandidateSelection の XML 構文は <BallotSelection xsi:type="CandidateSelection"> です。

要素

次の表に、CandidateSelection の要素を示します。

要素 重複 種類 説明
CandidateIds 1 IDREFS 1 つ以上の Candidate 要素の一意の識別子。候補者を投票上の候補者のセレクションに関連付けるために使用します。また、大統領とバイス プレジデントを合わせて選出されるチケットなど、複数の候補者に投票する場合でも有用です。
EndorsementPartyIds 0 以上 IDREFS 2 つ以上の 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 1 つ以上の Party 要素の一意の識別子。1 人以上の当事者を選択した当事者に関連付けるために使用します。

例

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