Selezione elettorale

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à:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection
    • SpecialBallotSelection

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 questo type di BallotSelection quando la competizione è per uno o più candidati. Collega la selezione della scheda elettorale agli elementi Candidate.
  • PartySelection: utilizza questo type di BallotSelection quando il tipo di competizione è per un Party, ad esempio per una competizione proporzionale tra partiti.
  • BallotMeasureSelection: utilizza questo tipo di BallotSelection per rappresentare le possibili selezioni in un BallotMeasureContest.
  • SpecialBallotSelection: questo tipo di BallotSelection viene 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 SequenceOrder non è presente nel feed, non viene presupposto alcun ordine.

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 IsTopTicket impostato su true vengono ordinati prima di tutti i candidati senza un valore IsTopTicket. A loro volta, vengono ordinati prima di tutti i candidati con IsTopTicket impostato su false. Idealmente, la selezione viene impostata con un candidato senza un valore IsTopTicket oppure con una coppia di candidati, uno dei quali ha IsTopTicket impostato su true. Se queste condizioni non sono soddisfatte, si verifica quanto segue:
    • Tutti i candidati con IsTopTicket impostato su true vengono presentati in un ordine non definito.
    • Tutti i candidati con IsTopTicket non presente vengono presentati in un ordine indefinito.
    • Tutti i candidati con IsTopTicket impostato su false vengono presentati in un ordine non definito.

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