Utilizza BallotSelection per identificare le selezioni di voto in una competizione elettorale, ad esempio
quando colleghi i candidati e i partiti ai loro conteggi dei voti.
Questo documento descrive BallotSelection e le relative sottoentità:
BallotSelectionCandidateSelectionPartySelectionBallotMeasureSelectionSpecialBallotSelection
Seleziona uno dei seguenti tipi di feed per scoprire di più su come utilizzare
BallotSelection e i relativi elementi intrinseci con quel tipo di feed.
BallotSelection
BallotSelection è un elemento astratto con tre tipi che vengono utilizzati in base al tipo di concorso:
CandidateSelection: utilizza questotypediBallotSelectionquando la competizione è per uno o più candidati. Collega la selezione della scheda elettorale agli elementiCandidate.PartySelection: utilizza questotypediBallotSelectionquando il tipo di competizione è per unParty, ad esempio per una competizione proporzionale tra partiti.BallotMeasureSelection: utilizza questo tipo diBallotSelectionper rappresentare le possibili selezioni in unBallotMeasureContest.SpecialBallotSelection: questo tipo diBallotSelectionviene utilizzato per i conteggi dei voti aggregati (ad es. l'aggregazione di più candidati in "Altri") e per diversi tipi di non voti (ad es. schede bianche, schede nulle o annullate e voti "nessuno dei candidati").
Attributi
La tabella seguente descrive gli attributi per BallotSelection:
| Attributo | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
objectId
|
Obbligatorio | ID |
Identificatore interno univoco utilizzato da altri elementi per fare riferimento a questo elemento. |
Elementi
La tabella seguente descrive gli elementi per BallotSelection:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
SequenceOrder |
0 o 1 | integer |
Specifica un ordine predefinito per la selezione delle schede a scopo di visualizzazione. Se |
CandidateSelection
Utilizza CandidateSelection per identificare le selezioni di voto in una competizione
tra candidati, inclusi i candidati non ufficiali.
CandidateSelection eredita gli attributi
e gli elementi di BallotSelection. Se necessario, è possibile includere riferimenti a più elementi
Candidate, ad esempio quando la selezione della scheda elettorale riguarda una lista di più
candidati.
Quando vengono citati più candidati per un ticket, a volte è importante
preservare l'ordine dei candidati. In questi casi, ci aspettiamo che l'applicazione
che genera l'elenco dei riferimenti agli elementi
Candidate all'interno di
CandidateIds rispetti lo schema di ordinamento in vigore. Ad esempio,
l'ordine dei candidati deve corrispondere allo stesso ordine dei riferimenti
all'elemento Office all'interno di
OfficeIds in Contest di tipo
CandidateContest.
Se viene fatto riferimento a più di un oggetto Candidate, questi vengono presentati all'utente
nel seguente ordine:
- Tutti i candidati con
IsTopTicketimpostato sutruevengono ordinati prima di tutti i candidati senza un valoreIsTopTicket. A loro volta, vengono ordinati prima di tutti i candidati conIsTopTicketimpostato sufalse. Idealmente, la selezione viene impostata con un candidato senza un valoreIsTopTicketoppure con una coppia di candidati, uno dei quali haIsTopTicketimpostato sutrue. Se queste condizioni non sono soddisfatte, si verifica quanto segue:- Tutti i candidati con
IsTopTicketimpostato sutruevengono presentati in un ordine non definito. - Tutti i candidati con
IsTopTicketnon presente vengono presentati in un ordine indefinito. - Tutti i candidati con
IsTopTicketimpostato sufalsevengono presentati in un ordine non definito.
- Tutti i candidati con
La sintassi XML per CandidateSelection è la seguente:
<BallotSelection xsi:type="CandidateSelection">.
Elementi
La tabella seguente descrive gli elementi per CandidateSelection:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
CandidateIds |
1 | IDREFS |
Identificatori univoci per uno o più
elementi Candidate. Utilizzato per associare un candidato alla selezione dei candidati sulla scheda elettorale. Utile anche quando la selezione della scheda elettorale riguarda più
candidati, ad esempio una lista con il presidente e il vicepresidente
selezionati insieme. |
EndorsementPartyIds |
0 o più | IDREFS |
Identificatore univoco per due o più
entità Party.
Si tratta di un accordo in cui i partiti politici elencano lo stesso
candidato in una scheda elettorale. |
IncludedInAggregation |
0 o 1 | boolean |
Indica se i conteggi dei voti della selezione sono inclusi nel
AggregateBallotSelection per la competizione. Valore predefinito
false se non specificato.
|
IsWriteIn |
0 o 1 | boolean |
Indica se il candidato è un candidato write-in. Il valore predefinito è
false. |
Esempi
XML
<BallotSelection objectId="cs10861" xsi:type="CandidateSelection"> <CandidateIds>can10861a can10861b</CandidateIds> </BallotSelection>
JSON
"BallotSelection": [ { "@type": "CandidateSelection", "objectId": "cs10861", "CandidateIds": [ "can10861a", "can10861b" ] } ]
PartySelection
Utilizza PartySelection per identificare le selezioni di voto che coinvolgono un partito, ad esempio
la selezione di un elenco di partito sulla scheda elettorale.
PartySelection eredita gli attributi e gli elementi di BallotSelection. La sintassi XML per PartySelection è la seguente:
<BallotSelection xsi:type="PartySelection" ... />.
Elementi
La tabella seguente descrive gli elementi per PartySelection:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
IncludedInAggregation |
0 o 1 | boolean |
Indica se i conteggi dei voti della selezione sono inclusi nel
AggregateBallotSelection per la competizione. Valore predefinito
false se non specificato.
|
PartyIds |
1 | IDREFS |
Identificatore univoco per uno o più
elementi
Party. Utilizzalo per associare una o più parti alla selezione
delle parti. |
Esempi
XML
<BallotSelection objectId="ps150" xsi:type="PartySelection"> <PartyIds>par100</PartyIds> </BallotSelection>
JSON
"BallotSelection": [ { "@type": "PartySelection", "objectId": "ps150", "PartyIds": [ "par100" ] } ]
BallotMeasureSelection
Utilizza BallotMeasureSelection per identificare le selezioni di voto che riguardano una
misura elettorale, come i referendum.
BallotMeasureSelection eredita gli attributi e gli elementi di
BallotSelection. La sintassi XML per BallotMeasureSelection è la seguente:
<BallotSelection xsi:type="BallotMeasureSelection" ... />.
Elementi
La tabella seguente descrive gli elementi per BallotMeasureSelection:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
ExternalIdentifiers |
0 o 1 | ExternalIdentifiers |
Associa un ID alla selezione della proposta di legge. È necessario un identificatore stabile. |
Selection |
1 | InternationalizedText |
Fornisce una scelta disponibile per la scheda elettorale, ad esempio Yes
o No. |
Esempi
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
Questo tipo di BallotSelection viene utilizzato per i conteggi aggregati dei voti (ad es.
l'aggregazione di più candidati in "Altri") e per diversi tipi di non voti
(ad es. schede bianche, schede nulle o annullate e voti "nessuno dei precedenti").
SpecialBallotSelection non deve essere utilizzato nell'elemento secondario generale BallotSelection di Contest e ha invece i propri campi distinti in Contest, ovvero AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection e NullBallotSelection. Per ulteriori dettagli, consulta gli
elementi Contest.
Elementi
La tabella seguente descrive gli elementi per SpecialBallotSelection:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
CountedInTotal |
0 o 1 | boolean |
Indica se i conteggi dei voti della selezione dell'entità vengono conteggiati nel totale
dei voti espressi considerati degni di nota. true presunto se
non specificato.
|
ExternalIdentifiers |
0 o 1 | ExternalIdentifiers |
Associa un ID alla selezione della proposta di legge. È necessario un identificatore stabile. |
Selection |
1 | InternationalizedText |
Fornisce un nome per questa selezione di schede, ad esempio "Altri" o "Nessuna delle precedenti". |
Esempi
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" } } }