투표 선택

BallotSelection를 사용하여 후보자와 정당을 득표수에 연결하는 경우와 같이 선거의 투표 선택사항을 식별합니다.

이 문서에서는 BallotSelection 및 하위 항목에 대해 설명합니다.

BallotSelection
- CandidateSelection
- PartySelection
- BallotMeasureSelection
- SpecialBallotSelection

다음 피드 유형 중 하나를 선택하여 해당 유형의 피드와 함께 BallotSelection 및 내재된 요소를 사용하는 방법을 자세히 알아보세요.

BallotSelection

BallotSelection는 콘테스트 유형에 따라 사용되는 세 가지 유형이 있는 추상 요소입니다.

CandidateSelection: 경연이 하나 이상의 후보자를 위한 경우 BallotSelection의 이 type을 사용합니다. 투표 선택을 Candidate 요소에 연결합니다.
PartySelection: 선거 유형이 Party인 경우(예: 정당 비례 선거) 이 type의 BallotSelection을 사용합니다.
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 값이 없는 후보자 하나로 선택이 설정되거나 후보자 쌍이 있고 그중 하나에 IsTopTicket이 true으로 설정되어 있습니다. 이러한 조건이 충족되지 않으면 다음이 발생합니다.
- IsTopTicket이 true로 설정된 모든 후보자는 정의되지 않은 순서로 표시됩니다.
- IsTopTicket이 없는 모든 후보는 정의되지 않은 순서로 표시됩니다.
- IsTopTicket이 false로 설정된 모든 후보자는 정의되지 않은 순서로 표시됩니다.

CandidateSelection의 XML 구문은 <BallotSelection xsi:type="CandidateSelection">입니다.

요소

다음 표에서는 CandidateSelection의 요소를 설명합니다.

요소	다중성	유형	설명
`CandidateIds`	1	`IDREFS`	하나 이상의 `Candidate` 요소의 고유 식별자입니다. 후보자를 투표용지의 후보자 선택과 연결하는 데 사용됩니다. 대통령과 부통령이 함께 선택된 티켓과 같이 투표 선택이 여러 후보자를 위한 경우에도 유용합니다.
`EndorsementPartyIds`	0개 이상	`IDREFS`	두 개 이상의 `Party` 항목의 고유 식별자입니다. 이는 정당이 투표용지에 동일한 후보자를 나열하는 경우를 나타냅니다.
`IncludedInAggregation`	0 또는 1	`boolean`	선택의 득표수가 대회 `AggregateBallotSelection`에 포함되는지 여부입니다. 지정되지 않은 경우 `false`로 간주됩니다. 참고: `IncludedInAggregation`로 표시된 모든 투표 선택사항의 투표 합계는 `AggregateBallotSelection`의 총 투표 수보다 작거나 같아야 합니다.
`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의 요소를 설명합니다.

요소	다중성	유형	설명
`IncludedInAggregation`	0 또는 1	`boolean`	선택의 득표수가 대회 `AggregateBallotSelection`에 포함되는지 여부입니다. 지정되지 않은 경우 `false`로 간주됩니다. 참고: `IncludedInAggregation`로 표시된 모든 투표 선택사항의 투표 합계는 `AggregateBallotSelection`의 총 투표 수보다 작거나 같아야 합니다.
`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`	0 또는 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"
            }
          ]
        },
        "Selection": {
          "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"
            }
          ]
        },
        "Selection": {
          "Text": [
            {
              "value": "Yes",
              "language": "en"
            }
          ]
        }
      }
    ]

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="selection3">
      <Selection>
        <Text language="en">Other Candidates</Text>
      </Selection>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>selection3</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </AggregateBallotSelection>
    <!-- Counts of ballots left blank -->
    <BlankBallotSelection objectId="selection4">
      <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>selection4</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </BlankBallotSelection>
    <!-- Votes for "None of the above" option on the ballot -->
    <NoneOfTheAboveBallotSelection objectId="selection5">
      <!--
        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>selection5</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="selection5">
      <!--
        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>selection5</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </NullBallotSelection>

JSON

    "AggregateBallotSelection": {
      "objectId": "selection3",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "Other Candidates"
        }
      },
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection3"
        }
      },
    },
    "BlankBallotSelection": {
      "objectId": "selection4",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "Blank Ballots"
        }
      },
      "CountedInTotal": true,
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection4"
        }
      }
    },
    "NoneOfTheAboveBallotSelection": {
      "objectId": "selection5",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "None"
        }
      },
      "CountedInTotal": true,
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection5"
        }
      }
    },
    "NullBallotSelection": {
      "objectId": "selection5",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "Spoiled ballots"
        }
      },
      "CountedInTotal": false,
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection5"
        }
      }
    }

투표 선택 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

BallotSelection

속성

요소

CandidateSelection

요소

예

XML

JSON

PartySelection

요소

예

XML

JSON

BallotMeasureSelection

요소

예

XML

JSON

XML

JSON

SpecialBallotSelection

요소

예

XML

JSON

투표 선택