Sélection du scrutin

Utilisez BallotSelection pour identifier les sélections de bulletins de vote dans un concours, par exemple lorsque vous associez des candidats et des partis à leur nombre de votes.

Ce document traite de BallotSelection et de ses sous-entités:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

Sélectionnez l'un des types de flux suivants pour en savoir plus sur l'utilisation de BallotSelection et des éléments qui lui sont associés.

BallotSelection

BallotSelection est un élément abstrait avec trois types utilisés en fonction du type de concours:

  • CandidateSelection: utilisez ce type sur BallotSelection lorsque le concours est destiné à un ou plusieurs candidats. Il associe la sélection de bulletins de vote aux éléments Candidate.
  • PartySelection: utilisez ce type de BallotSelection lorsque le type de concours est pour un Party, par exemple pour un concours proportionnel de groupe.
  • BallotMeasureSelection: utilisez ce type de BallotSelection pour représenter les sélections possibles dans un BallotMeasureContest.

Attributs

Le tableau suivant décrit les attributs de BallotSelection:

Attribut Requis ? Type Description
objectId Obligatoire ID Identifiant interne unique utilisé par d'autres éléments pour référencer cet élément.

Éléments

Le tableau suivant décrit les éléments de BallotSelection:

Élément Multiplicité Type Description
SequenceOrder 0 ou 1 integer

Spécifie un ordre par défaut pour la sélection des bulletins de vote à des fins d'affichage.

Si SequenceOrder n'est pas présent dans le flux, aucune commande n'est supposée.
VoteCountsCollection 0 ou plus N/A Wrapper pour les collections d'éléments VoteCounts. Pour en savoir plus, consultez la section Entités de collection.

CandidateSelection

Utilisez CandidateSelection pour identifier les sélections de bulletins de vote dans un concours de candidat, y compris les écritures.

CandidateSelection hérite des attributs et des éléments de BallotSelection. Les références à plusieurs éléments Candidate peuvent être incluses si nécessaire, par exemple lorsque la sélection du bulletin de vote concerne une demande à plusieurs candidats.

Lorsque plusieurs candidats sont référencés pour un ticket, il est parfois important de conserver l'ordre des candidats. Dans ce cas, l'application qui génère la liste devrait répertorier les références aux éléments Candidate dans CandidateIds en fonction du schéma d'ordre en place. Par exemple, l'ordre des candidats doit correspondre au même ordre des références d'éléments Office dans OfficeIds dans le Contest de type CandidateContest.

Si plusieurs objets Candidate sont référencés, ils sont présentés à l'utilisateur dans l'ordre suivant:

  • Tous les candidats pour lesquels IsTopTicket est défini sur true sont placés avant tous les candidats sans valeur IsTopTicket. Elles sont ensuite placées avant tous les candidats avec un IsTopTicket défini sur false. Idéalement, la sélection est définie avec un candidat sans valeur IsTopTicket ou s'il existe une paire de candidats dont IsTopTicket a la valeur true. Si ces conditions ne sont pas remplies, voici ce qui se produit :
    • Tous les candidats pour lesquels IsTopTicket est défini sur true sont présentés dans un ordre indéterminé.
    • Tous les candidats dont le IsTopTicket n'est pas présent sont présentés dans un ordre indéterminé.
    • Tous les candidats pour lesquels IsTopTicket est défini sur false sont présentés dans un ordre indéterminé.

La syntaxe XML pour CandidateSelection est la suivante : <BallotSelection xsi:type="CandidateSelection">.

Éléments

Le tableau suivant décrit les éléments de CandidateSelection:

Élément Multiplicité Type Description
CandidateIds 1 IDREFS Identifiants uniques pour un ou plusieurs éléments Candidate. Permet d'associer un candidat à la sélection du candidat sur le bulletin de vote. Cela s'avère également utile lorsque le bulletin de vote est destiné à plusieurs candidats (par exemple, un billet pour lequel le président et le vice-président sont sélectionnés ensemble).
EndorsementPartyIds 0 ou plus IDREFS Identifiant unique d'au moins deux entités Party. Il s'agit d'un arrangement selon lequel les partis politiques présentent le même candidat à un bulletin de vote.
IsWriteIn 0 ou 1 boolean Indique si le candidat a une écriture écrite. La valeur par défaut est false.

Exemples

XML

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

JSON

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

PartySelection

Utilisez PartySelection pour identifier les sélections de bulletins de vote qui impliquent une partie, comme une sélection de liste de parti sur le bulletin de vote.

PartySelection hérite des attributs et des éléments de BallotSelection. La syntaxe XML pour PartySelection est la suivante : <BallotSelection xsi:type="PartySelection" ... />.

Éléments

Le tableau suivant décrit les éléments de PartySelection:

Élément Multiplicité Type Description
PartyIds 1 IDREFS Identifiant unique d'un ou de plusieurs éléments Party. Permet d'associer une ou plusieurs parties à la sélection du groupe.

Exemples

XML

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

JSON

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

BallotMeasureSelection

Utilisez BallotMeasureSelection pour identifier les sélections de bulletins de vote qui impliquent un référendum, par exemple des référendums.

BallotMeasureSelection hérite des attributs et des éléments de BallotSelection. La syntaxe XML pour BallotMeasureSelection est la suivante : <BallotSelection xsi:type="BallotMeasureSelection" ... />.

Éléments

Le tableau suivant décrit les éléments de BallotMeasureSelection:

Élément Multiplicité Type Description
ExternalIdentifiers 1 ExternalIdentifiers Associe un ID à la sélection de référendum. Un identifiant stable est requis.
Selection 1 InternationalizedText Fournit un choix possible pour le bulletin de vote, par exemple Yes ou No.

Exemples

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"
            }
          ]
        }
        "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"
            }
          ]
        }
        "Text": [
          {
            "value": "Yes",
            "language": "en"
          },
        ]
      }
    ]