Utilisez BallotSelection pour identifier les choix 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 :
BallotSelectionCandidateSelectionPartySelectionBallotMeasureSelection
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 cettetypedeBallotSelectionlorsque le concours s'adresse à un ou plusieurs candidats. Il associe la sélection du bulletin de vote aux élémentsCandidate.PartySelection: utilisez cetypedeBallotSelectionlorsque le type de scrutin estParty, par exemple pour un scrutin proportionnel par liste.BallotMeasureSelection: utilisez ce type deBallotSelectionpour représenter les sélections possibles dans unBallotMeasureContest.
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 |
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 un ticket, 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 des é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 la valeur
IsTopTicketest définie surtruesont classés avant tous les candidats sans valeurIsTopTicket. Ils sont ensuite classés avant tous les candidats dontIsTopTicketest défini surfalse. Idéalement, la sélection est définie avec un candidat sans valeurIsTopTicket, ou avec une paire de candidats dont l'un a la valeurtruepourIsTopTicket. Si ces conditions ne sont pas remplies, voici ce qui se passe :- Tous les candidats dont le paramètre
IsTopTicketest défini surtruesont présentés dans un ordre indéfini. - Tous les candidats pour lesquels
IsTopTicketn'est pas présent sont présentés dans un ordre indéfini. - Tous les candidats dont le paramètre
IsTopTicketest défini surfalsesont présentés dans un ordre indéfini.
- Tous les candidats dont le paramètre
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. |
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 |
|---|---|---|---|
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 |
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" } ] } } ]