Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

風船選択

BallotSelection を使用して、候補者や政党を投票数にリンクする場合など、選挙の投票選択肢を特定します。

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

BallotSelection
- CandidateSelection
- PartySelection
- BallotMeasureSelection
- SpecialBallotSelection

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

BallotSelection

BallotSelection は抽象要素で、コンテストのタイプに応じて使用される 3 つのタイプがあります。

CandidateSelection: コンテストが 1 人以上の候補者を対象とする場合は、BallotSelection のこの type を使用します。投票の選択を Candidate 要素にリンクします。
PartySelection: 比例代表制など、選挙の種類が Party の場合は、この BallotSelection の type を使用します。
BallotMeasureSelection: このタイプの BallotSelection を使用して、 BallotMeasureContest で選択可能な項目を表します。
SpecialBallotSelection: このタイプの BallotSelection は、投票数の集計（複数の候補者を「その他」に集計するなど）や、さまざまな種類の無効票（白票、無効票、破損票、「上記のいずれでもない」票など）に使用されます。

属性

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

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

要素

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

要素重複タイプ説明

要素	重複	タイプ	説明
`SequenceOrder`	0 または 1	`integer`	表示目的で、投票用紙の選択項目のデフォルトの順序を指定します。 `SequenceOrder` がフィードに存在しない場合、順序は想定されません。

SequenceOrder

0 または 1

integer

表示目的で、投票用紙の選択項目のデフォルトの順序を指定します。

SequenceOrder がフィードに存在しない場合、順序は想定されません。

CandidateSelection

CandidateSelection を使用して、候補者コンテストの投票用紙の選択肢（手書きを含む）を特定します。

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

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

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

IsTopTicket が true に設定されているすべての候補は、IsTopTicket 値のないすべての候補よりも前に並べられます。これらは、IsTopTicket が false に設定されているすべての候補よりも前に並べ替えられます。理想的には、IsTopTicket 値のない 1 つの候補、または 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` エンティティの固有識別子。これは、政党が投票用紙に同じ候補者を記載する取り決めを表します。
`IncludedInAggregation`	0 または 1	`boolean`	選択肢の得票数が、選挙の `AggregateBallotSelection` に含まれているかどうか。指定しない場合は `false` とみなされます。注: `IncludedInAggregation` とマークされたすべての投票選択肢に投じられた票の合計は、`AggregateBallotSelection` の総得票数以下である必要があります。
`IsWriteIn`	0 または 1	`boolean`	候補者が被記入者であるかどうかを示します。デフォルト値は `false` です。 `IsWriteIn` は非推奨になりました。代わりに `PreElectionStatus` 要素を使用してください。
`PostElectionStatus`	0 または 1	`CandidatePostElectionStatus`	候補者の最終ステータス（`winner`、`advanced-to-runoff` など）。
`PreElectionStatus`	0 または 1	`CandidatePreElectionStatus`	候補者の登録ステータス（`filed`、`qualified` など）。

例

XML

    <BallotSelection objectId="cs-10861" xsi:type="CandidateSelection">
      <CandidateIds>can-10861a can-10861b</CandidateIds>
    </BallotSelection>

PartySelection

PartySelection を使用して、政党を含む投票用紙の選択肢（投票用紙の政党リストの選択など）を識別します。

PartySelection は BallotSelection の属性と要素を継承します。PartySelection の XML 構文は <BallotSelection xsi:type="PartySelection" ... /> です。

要素

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

要素	重複	タイプ	説明
`IncludedInAggregation`	0 または 1	`boolean`	選択の投票数が選挙の `AggregateBallotSelection` に含まれるかどうか。指定しない場合は `false` と見なされます。注: `IncludedInAggregation` とマークされたすべての投票選択肢に投じられた票の合計は、`AggregateBallotSelection` の総得票数以下である必要があります。
`PartyIds`	1	`IDREFS`	1 つ以上の `Party` 要素の固有識別子。1 つ以上の当事者を当事者選択に関連付けるために使用します。

例

XML

    <BallotSelection objectId="ps-150" xsi:type="PartySelection">
      <PartyIds>par-100</PartyIds>
    </BallotSelection>

BallotMeasureSelection

BallotMeasureSelection を使用して、国民投票などの投票案を含む投票の選択肢を特定します。

BallotMeasureSelection は、BallotSelection の属性と要素を継承します。BallotMeasureSelection の XML 構文は次のとおりです。 <BallotSelection xsi:type="BallotMeasureSelection" ... />

要素

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

要素	重複	タイプ	説明
`ExternalIdentifiers`	0 または 1	`ExternalIdentifiers`	ID を投票法案の選択に関連付けます。安定した識別子が必要です。
`Selection`	1	`InternationalizedText`	投票用紙で使用可能な選択肢（`Yes`、`No` など）を指定します。

例

XML

    <BallotSelection objectId="bms-00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bms-00-yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

XML

    <BallotSelection objectId="bms-00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bms-00-yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

SpecialBallotSelection

このタイプの BallotSelection は、投票数の集計（複数の候補者を「その他」に集計するなど）や、さまざまな種類の無効票（白票、無効票、破損票、「上記のいずれでもない」票など）に使用されます。

SpecialBallotSelection は、Contest の一般的な BallotSelection サブ要素で使用しないでください。代わりに、Contest に独自のフィールド（AggregateBallotSelection、BlankBallotSelection、NoneOfTheAboveBallotSelection、NullBallotSelection）があります。詳しくは、Contest 要素をご覧ください。

要素

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

要素	重複	タイプ	説明
`CountedInTotal`	0 または 1	`boolean`	エンティティの選択の投票数が、注目に値すると見なされる合計投票数にカウントされるかどうか。指定しない場合は `true` と見なされます。注: これは、合計に常にカウントされる標準の投票選択の投票の集計である `AggregateBallotSelection` に設定しないでください。
`ExternalIdentifiers`	0 または 1	`ExternalIdentifiers`	投票法案の選択に ID を関連付けます。安定した識別子が必要です。
`Selection`	1	`InternationalizedText`	この投票選択肢の名前（「その他」、「上記のいずれでもない」など）を指定します。

例

XML

    <AggregateBallotSelection objectId="sbs-3">
      <Selection>
        <Text language="en">Other Candidates</Text>
      </Selection>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>sbs-3</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </AggregateBallotSelection>
    <!-- Counts of ballots left blank -->
    <BlankBallotSelection objectId="sbs-4">
      <Selection>
        <Text language="en">Blank ballots</Text>
      </Selection>
      <!-- These ballots count in the total and can affect majorities -->
      <CountedInTotal>true</CountedInTotal>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>sbs-4</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </BlankBallotSelection>
    <!-- Votes for "None of the above" option on the ballot -->
    <NoneOfTheAboveBallotSelection objectId="sbs-5">
      <!--
        The NOTA selection optiona as it appears on the ballot, often
        "None of the above", "None", or "Uncommitted"
      -->
      <Selection>
        <Text language="en">None</Text>
      </Selection>
      <!-- These ballots count in the total and can affect majorities -->
      <CountedInTotal>true</CountedInTotal>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>sbs-5</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </NoneOfTheAboveBallotSelection>
    <!--
      Counts of null or spoiled ballots, i.e. ballots that have been marked in
      a way that the vote cannot be counted
    -->
    <NullBallotSelection objectId="sbs-6">
      <!--
        How these ballots are often called in a given country, often
        "null" or "spoiled"
      -->
      <Selection>
        <Text language="en">Spoiled ballots</Text>
      </Selection>
      <!--
        These ballots do count in the total and are treated as the same as
        if this vote did not happen at all
      -->
      <CountedInTotal>false</CountedInTotal>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>sbs-6</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </NullBallotSelection>

風船選択 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

BallotSelection

属性

要素

CandidateSelection

要素

例

XML

PartySelection

要素

例

XML

BallotMeasureSelection

要素

例

XML

XML

SpecialBallotSelection

要素

例

XML

風船選択