투표 선택

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

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

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

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

BallotSelection

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

  • CandidateSelection: 경선이 하나 이상의 후보자를 대상으로 하는 경우 BallotSelection의 이 type을 사용합니다. 투표 선택을 Candidate 요소에 연결합니다.
  • PartySelection: 콘테스트 유형이 Party인 경우(예: 정당 비례 콘테스트) 이 type의 BallotSelection을 사용합니다.
  • BallotMeasureSelection: 이 유형의 BallotSelection를 사용하여 BallotMeasureContest에서 가능한 선택사항을 나타냅니다.

속성

다음 표에서는 BallotSelection의 속성을 설명합니다.

속성 필수 여부 유형 설명
objectId 필수 ID 다른 요소가 이 요소를 참조하는 데 사용하는 고유 내부 식별자입니다.

요소

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

요소 다중성 유형 설명
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 항목의 고유 식별자입니다. 이는 정당이 투표용지에 동일한 후보자를 나열하는 경우를 나타냅니다.
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"
            }
          ]
        },
        "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"
            }
          ]
        }
      }
    ]