Wybór loterii

Używaj symbolu BallotSelection, aby oznaczać wybory na karcie do głosowania w wyborach, np. gdy łączysz kandydatów i partie z liczbą głosów, które na nich oddano.

W tym dokumencie omawiamy BallotSelection i jego podmioty podrzędne:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

Wybierz jeden z tych typów plików danych, aby dowiedzieć się więcej o tym, jak używać elementu BallotSelection i jego elementów składowych w przypadku danego typu pliku danych.

BallotSelection

BallotSelection to element abstrakcyjny z 3 typami, które są używane w zależności od rodzaju konkursu:

Atrybuty

W tabeli poniżej opisano atrybuty BallotSelection:

Atrybut Wymagany? Typ Opis
objectId Wymagane ID Unikalny identyfikator wewnętrzny używany przez inne elementy do odwoływania się do tego elementu.

Elementy

W tabeli poniżej opisano elementy BallotSelection:

Element Mnogość Typ Opis
SequenceOrder 0 lub 1 integer

Określa domyślną kolejność wyboru karty do głosowania do celów wyświetlania.

Jeśli w pliku danych nie ma atrybutu SequenceOrder, nie zakłada się żadnego zamówienia.

CandidateSelection

Użyj symbolu CandidateSelection, aby zidentyfikować wybory na karcie do głosowania w przypadku kandydatów, w tym dopisanych.

CandidateSelection dziedziczy atrybuty i elementy BallotSelection. W razie potrzeby można uwzględnić odniesienia do wielu elementów Candidate, np. gdy wybór na karcie do głosowania dotyczy listy wielu kandydatów.

Jeśli w przypadku zgłoszenia jest wymienionych kilku kandydatów, czasami ważne jest zachowanie kolejności kandydatów. W takich przypadkach oczekujemy, że aplikacja generująca będzie zawierać listę odwołań do elementów Candidate w ramach elementu CandidateIds zgodnie z obowiązującym schematem kolejności. Na przykład kolejność kandydatów musi być zgodna z kolejnością odwołań do elementów Office w OfficeIds w Contest typu CandidateContest.

Jeśli istnieje więcej niż 1 obiekt Candidate, są one prezentowane użytkownikowi w tej kolejności:

  • Wszyscy kandydaci, w przypadku których wartość IsTopTicket jest ustawiona na true, są umieszczani przed wszystkimi kandydatami bez wartości IsTopTicket. Z kolei są one uporządkowane przed wszystkimi kandydatami, w przypadku których wartość IsTopTicket jest ustawiona na false. Najlepiej, jeśli wybór jest ustawiony na 1 kandydata bez wartości IsTopTicket lub na parę kandydatów, z których jeden ma wartość IsTopTicket ustawioną na true. Jeśli te warunki nie zostaną spełnione, nastąpi:
    • Wszyscy kandydaci, w przypadku których wartość IsTopTicket jest ustawiona na true, są prezentowani w nieokreślonej kolejności.
    • Wszyscy kandydaci, którzy nie mają IsTopTicket, są prezentowani w nieokreślonej kolejności.
    • Wszyscy kandydaci, w przypadku których wartość IsTopTicket jest ustawiona na false, są prezentowani w nieokreślonej kolejności.

Składnia XML dla elementu CandidateSelection jest następująca:<BallotSelection xsi:type="CandidateSelection">.

Elementy

W tabeli poniżej opisano elementy CandidateSelection:

Element Mnogość Typ Opis
CandidateIds 1 IDREFS Unikalne identyfikatory co najmniej jednego elementu.Candidate Użyj, aby powiązać kandydata z wyborem kandydata na karcie do głosowania. Przydatne również wtedy, gdy na karcie do głosowania wybieranych jest kilku kandydatów, np. kandydat na prezydenta i wiceprezydenta.
EndorsementPartyIds 0 lub więcej IDREFS Unikalny identyfikator co najmniej 2 Party podmiotów. Oznacza to sytuację, w której partie polityczne umieszczają na karcie do głosowania tego samego kandydata.
IsWriteIn 0 lub 1 boolean Wskazuje, czy kandydat został dopisany do listy. Wartością domyślną jest false.

Przykłady

XML

    <BallotSelection objectId="cs10861" xsi:type="CandidateSelection">
      <CandidateIds>can10861a can10861b</CandidateIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "CandidateSelection",
        "objectId": "cs10861",
        "CandidateIds": [
          "can10861a",
          "can10861b"
        ]
      }
    ]

PartySelection

Użyj symbolu PartySelection, aby oznaczyć wybory na karcie do głosowania, które dotyczą partii, np. wybór listy partyjnej.

PartySelection dziedziczy atrybuty i elementy BallotSelection. Składnia XML dla elementu PartySelection jest następująca:<BallotSelection xsi:type="PartySelection" ... />.

Elementy

W tabeli poniżej opisano elementy PartySelection:

Element Mnogość Typ Opis
PartyIds 1 IDREFS Unikalny identyfikator co najmniej jednego elementu.Party Służy do powiązania co najmniej 1 strony z wyborem strony.

Przykłady

XML

    <BallotSelection objectId="ps150" xsi:type="PartySelection">
      <PartyIds>par100</PartyIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "PartySelection",
        "objectId": "ps150",
        "PartyIds": [
          "par100"
        ]
      }
    ]

BallotMeasureSelection

Używaj symbolu BallotMeasureSelection, aby oznaczać wybory, które dotyczą głosowania nad środkami, np. referendów.

BallotMeasureSelection dziedziczy atrybuty i elementy elementu BallotSelection. Składnia XML dla elementu BallotMeasureSelection jest następująca:<BallotSelection xsi:type="BallotMeasureSelection" ... />.

Elementy

W tabeli poniżej opisano elementy BallotMeasureSelection:

Element Mnogość Typ Opis
ExternalIdentifiers 1 ExternalIdentifiers Powiązanie identyfikatora z wybranym referendum. Wymagany jest stabilny identyfikator.
Selection 1 InternationalizedText Zawiera dostępną opcję na karcie do głosowania, np. Yes lub No.

Przykłady

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