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

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.

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 indefinito.
    • 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 indefinito.

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. Utilizza 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.
IsWriteIn 0 o 1 boolean Indica se il candidato è un 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
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 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"
            }
          ]
        }
      }
    ]