Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

투표 선택

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 요소에 대한 참조를 나열해야 합니다. 예를 들어, 후보자의 순서는 Office 내 OfficeIds에 있는 Contest 유형의 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`	하나 이상의 `Candidate` 요소의 고유 식별자입니다. 를 사용하여 후보자를 투표용지의 후보자 선택 항목과 연결합니다. 투표 선택 항목이 여러 후보자를 위한 경우에도 유용합니다(예: 대통령과 부통령이 함께 선택된 티켓).
`EndorsementPartyIds`	0개 이상	`IDREFS`	둘 이상의 `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`	하나 이상의 `Party` 요소의 고유 식별자입니다. 를 사용하여 하나 이상의 정당을 정당 선택 항목과 연결합니다.

예

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은 일반 BallotSelection Contest의 하위 요소에서 사용해서는 안 되며 대신 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

투표 선택