Sélection du scrutin

Utilisez BallotSelection pour identifier les sélections sur le bulletin de vote lors d'une élection, par exemple lorsque vous associez des candidats et des partis à leur nombre de voix.

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

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection
    • SpecialBallotSelection

Sélectionnez l'un des types de flux suivants pour en savoir plus sur l'utilisation de BallotSelection et de ses éléments inhérents avec ce type de flux.

BallotSelection

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

  • CandidateSelection : utilisez cette type de BallotSelection lorsque le concours concerne un ou plusieurs candidats. Il associe la sélection du bulletin de vote aux éléments Candidate.
  • PartySelection : utilisez ce type de BallotSelection lorsque le type de concours est Party, par exemple pour un concours proportionnel à un parti.
  • BallotMeasureSelection : utilisez ce type de BallotSelection pour représenter les sélections possibles dans un BallotMeasureContest.
  • SpecialBallotSelection : ce type de BallotSelection est utilisé pour les agrégations de nombre de votes (par exemple, l'agrégation de plusieurs candidats dans "Autres") et différents types de non-votes (c'est-à-dire les bulletins blancs, nuls ou non valides, et les votes "aucun des candidats").

Attributs

Le tableau suivant décrit les attributs de BallotSelection :

Attribut Obligatoire ? Type Description
objectId Obligatoire ID Identifiant interne unique utilisé par d'autres éléments pour faire référence à 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, aucun ordre n'est supposé.

CandidateSelection

Utilisez CandidateSelection pour identifier les sélections sur le bulletin de vote dans un scrutin, y compris les candidats inscrits.

CandidateSelection hérite des attributs et des éléments de BallotSelection. Si nécessaire, vous pouvez inclure des références à plusieurs éléments Candidate, par exemple lorsque la sélection du bulletin de vote concerne une liste de plusieurs candidats.

Lorsque plusieurs candidats sont référencés pour une demande, il est parfois important de conserver l'ordre des candidats. Dans ce cas, nous attendons de l'application génératrice qu'elle liste les références aux éléments Candidate dans CandidateIds selon le schéma de classement en place. Par exemple, l'ordre des candidats doit correspondre à l'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 dont le champ IsTopTicket est défini sur true sont classés avant tous les candidats sans valeur IsTopTicket. Ils sont ensuite classés avant tous les candidats dont IsTopTicket est défini sur false. Idéalement, la sélection est définie avec un candidat sans valeur IsTopTicket, ou avec une paire de candidats dont l'un a la valeur true pour IsTopTicket. Si ces conditions ne sont pas remplies, voici ce qui se passe :
    • Tous les candidats pour lesquels IsTopTicket est défini sur true sont présentés dans un ordre indéfini.
    • Tous les candidats pour lesquels IsTopTicket n'est pas présent sont présentés dans un ordre indéfini.
    • Tous les candidats pour lesquels IsTopTicket est défini sur false sont présentés dans un ordre indéfini.

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 de candidats sur le bulletin de vote. Cette option est également utile lorsque la sélection du bulletin de vote concerne plusieurs candidats, par exemple un ticket avec le président et le vice-président sélectionnés ensemble.
EndorsementPartyIds 0 ou plus IDREFS Identifiant unique pour deux entités Party ou plus. Il s'agit d'un accord dans lequel les partis politiques listent le même candidat sur un bulletin de vote.
IncludedInAggregation 0 ou 1 boolean Indique si le nombre de votes de la sélection est inclus dans AggregateBallotSelection pour le concours. false est supposé si non spécifié.
IsWriteIn 0 ou 1 boolean Indique si le candidat est un candidat par écrit. 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 sur le bulletin de vote qui impliquent un parti, comme la sélection d'une liste de partis 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
IncludedInAggregation 0 ou 1 boolean Indique si le nombre de votes de la sélection est inclus dans AggregateBallotSelection pour le concours. false est supposé si non spécifié.
PartyIds 1 IDREFS Identifiant unique pour un ou plusieurs éléments Party. Utilisez cette option pour associer une ou plusieurs parties à la sélection de parties.

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 une mesure électorale, comme les 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 0 ou 1 ExternalIdentifiers Associe un ID à la sélection du scrutin. Un identifiant stable est requis.
Selection 1 InternationalizedText Fournit un choix disponible pour le bulletin de vote, tel que 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"
            }
          ]
        },
        "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

Ce type de BallotSelection est utilisé pour les agrégations du nombre de votes (par exemple, l'agrégation de plusieurs candidats dans "Autres") et pour différents types de non-votes (c'est-à-dire les bulletins de vote vierges, nuls ou annulés, et les votes "aucun des candidats").

SpecialBallotSelection ne doit pas être utilisé dans le sous-élément BallotSelection général de Contest. Il possède plutôt ses propres champs distincts sur Contest, à savoir AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection et NullBallotSelection. Pour en savoir plus, consultez la section Éléments Contest.

Éléments

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

Élément Multiplicité Type Description
CountedInTotal 0 ou 1 boolean Indique si les votes de la sélection d'entités sont comptabilisés dans le nombre total de votes considérés comme notables. true est utilisé par défaut si aucune valeur n'est spécifiée.
ExternalIdentifiers 0 ou 1 ExternalIdentifiers Associe un ID à la sélection du scrutin. Un identifiant stable est requis.
Selection 1 InternationalizedText Fournit un nom pour cette sélection de bulletin de vote, tel que "Autres" ou "Aucune des réponses ci-dessus".

Exemples

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