Selezione elettorale

Utilizza BallotSelection per identificare le selezioni di voto in una competizione elettorale, ad esempio quando colleghi candidati e partiti ai relativi conteggi dei voti.

Questo documento illustra 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 questo tipo di feed.

BallotSelection

BallotSelection è un elemento astratto con tre tipi che vengono utilizzati in base al tipo di competizione elettorale:

  • CandidateSelection: utilizza questo type di BallotSelection quando la competizione elettorale riguarda uno o più candidati. Collega la selezione di voto agli Candidate elementi.
  • PartySelection: utilizza questo type di BallotSelection quando il tipo di competizione elettorale riguarda un Party, ad esempio una competizione elettorale proporzionale di partito.
  • BallotMeasureSelection: utilizza questo tipo di BallotSelection per rappresentare le possibili selezioni in una BallotMeasureContest.
  • SpecialBallotSelection: questo tipo di BallotSelection viene utilizzato per le aggregazioni dei conteggi 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").

Attributi

La tabella seguente descrive gli attributi di BallotSelection:

Attributo Obbligatorio? Tipo Descrizione
objectId Obbligatorio ID Identificatore interno univoco utilizzato da altri elementi per fare riferimento questo elemento.

Elementi

La tabella seguente descrive gli elementi di BallotSelection:

Elemento Molteplicità Tipo Descrizione
SequenceOrder 0 o 1 integer

Specifica un ordine predefinito per la selezione di voto a scopo di visualizzazione purposes.

Se SequenceOrder non è presente nel feed, non viene presupposto alcun ordine.

CandidateSelection

Utilizza CandidateSelection per identificare le selezioni di voto in una competizione elettorale di candidati, inclusi i candidati non presenti sulla scheda.

CandidateSelection eredita gli attributi e gli elementi di BallotSelection. Se necessario, è possibile includere riferimenti a più Candidate elementi, ad esempio quando la selezione di voto riguarda un ticket di più candidati.

Quando si fa riferimento a più candidati per un ticket, a volte è importante preservare l'ordine dei candidati. In questi casi, ci aspettiamo che l' applicazione di generazione elenchi i riferimenti agli elementi Candidate all'interno di CandidateIds in base allo schema di ordinamento in vigore. Ad esempio, l'ordine dei candidati deve corrispondere allo stesso ordine dei Office riferimenti agli elementi all'interno di OfficeIds nella Contest di tipo CandidateContest.

Se viene fatto riferimento a più oggetti 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 solo candidato senza un valore IsTopTicket oppure con una coppia di candidati, uno dei quali ha IsTopTicket impostato su true. Se queste condizioni non vengono 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 non definito.
    • 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 di CandidateSelection:

Elemento Molteplicità Tipo Descrizione
CandidateIds 1 IDREFS Identificatori univoci per uno o più Candidate elementi. Utilizza questo elemento per associare un candidato alla selezione di voto sulla scheda. È utile anche quando la selezione di voto riguarda più candidati, ad esempio un ticket con il Presidente e il Vicepresidente selezionati insieme.
EndorsementPartyIds 0 o più IDREFS Identificatore univoco per due o più Party entità. Rappresenta un accordo in base al quale i partiti politici elencano lo stesso candidato su una scheda.
IncludedInAggregation 0 o 1 boolean Indica se i conteggi dei voti della selezione sono inclusi in the AggregateBallotSelection per la competizione elettorale. Se non specificato, viene utilizzato il valore false
IsWriteIn 0 o 1 boolean Indica se il candidato è un candidato non presente sulla scheda. Il valore predefinito è false.
PostElectionStatus 0 o 1 CandidatePostElectionStatus Stato finale del candidato, ad esempio winner o advanced-to-runoff.
PreElectionStatus 0 o 1 CandidatePreElectionStatus Stato di registrazione del candidato, ad esempio filed o qualified.

Esempi

XML

    <BallotSelection objectId="cs-10861" xsi:type="CandidateSelection">
      <CandidateIds>can-10861a can-10861b</CandidateIds>
    </BallotSelection>

PartySelection

Utilizza PartySelection per identificare le selezioni di voto che riguardano un partito, ad esempio una selezione di lista di partito sulla scheda.

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 di PartySelection:

Elemento Molteplicità Tipo Descrizione
IncludedInAggregation 0 o 1 boolean Indica se i conteggi dei voti della selezione sono inclusi in the AggregateBallotSelection per la competizione elettorale. Se non specificato, viene utilizzato il valore false
PartyIds 1 IDREFS Identificatore univoco per uno o più Party elementi. Utilizza questo elemento per associare uno o più partiti alla selezione di partito.

Esempi

XML

    <BallotSelection objectId="ps-150" xsi:type="PartySelection">
      <PartyIds>par-100</PartyIds>
    </BallotSelection>

BallotMeasureSelection

Utilizza BallotMeasureSelection per identificare le selezioni di voto che riguardano una misura di voto, ad esempio 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 di BallotMeasureSelection:

Elemento Molteplicità Tipo Descrizione
ExternalIdentifiers 0 o 1 ExternalIdentifiers Associa un ID alla selezione della misura di voto. È necessario un identificatore stabile.
Selection 1 InternationalizedText Fornisce una scelta disponibile per la scheda, ad esempio Yes o No.

Esempi

XML

    <BallotSelection objectId="bms-00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bms-00-yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

XML

    <BallotSelection objectId="bms-00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bms-00-yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

SpecialBallotSelection

Questo tipo di BallotSelection viene utilizzato per le aggregazioni dei conteggi 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 nel BallotSelection sottoelemento generale di Contest, ma ha campi distinti in Contest, ovvero AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection e NullBallotSelection. Per maggiori dettagli, consulta gli elementi Contest for more.

Elementi

La tabella seguente descrive gli elementi di SpecialBallotSelection:

Elemento Molteplicità Tipo Descrizione
CountedInTotal 0 o 1 boolean Indica se i conteggi dei voti della selezione dell'entità vengono conteggiati nel totale voti espressi considerati degni di nota. Se non specificato, viene utilizzato il valore true.
ExternalIdentifiers 0 o 1 ExternalIdentifiers Associa un ID alla selezione della misura di voto. È necessario un identificatore stabile.
Selection 1 InternationalizedText Fornisce un nome per questa selezione di voto, ad esempio "Altri" o "Nessuno dei precedenti".

Esempi

XML

    <AggregateBallotSelection objectId="sbs-3">
      <Selection>
        <Text language="en">Other Candidates</Text>
      </Selection>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>sbs-3</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </AggregateBallotSelection>
    <!-- Counts of ballots left blank -->
    <BlankBallotSelection objectId="sbs-4">
      <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>sbs-4</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </BlankBallotSelection>
    <!-- Votes for "None of the above" option on the ballot -->
    <NoneOfTheAboveBallotSelection objectId="sbs-5">
      <!--
        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>sbs-5</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="sbs-6">
      <!--
        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>sbs-6</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </NullBallotSelection>