Seleção de balão

Use BallotSelection para identificar as seleções de votação em uma disputa, como quando você vincula candidatos e partidos às contagens de votos.

Este documento discute BallotSelection e as subentidades dele:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection
    • SpecialBallotSelection

Selecione um dos seguintes tipos de feed para saber mais sobre como usar BallotSelection e os elementos inerentes a esse tipo de feed.

BallotSelection

BallotSelection é um elemento abstrato com três tipos usados com base no tipo de disputa:

  • CandidateSelection: use esse type de BallotSelection quando a disputa for para um ou mais candidatos. Ele vincula a seleção de votação aos Candidate elementos.
  • PartySelection: use este type de BallotSelection quando o tipo de disputa for para um Party, como uma disputa proporcional de partidos.
  • BallotMeasureSelection: use esse tipo de BallotSelection para representar as seleções possíveis em um BallotMeasureContest.
  • SpecialBallotSelection: esse tipo de BallotSelection é usado para agregações de contagem de votos (por exemplo, agregar vários candidatos em "Outros") e diferentes tipos de não votos (ou seja, votos em branco, nulos ou inválidos e votos "nenhum dos acima").

Atributos

A tabela a seguir descreve os atributos de BallotSelection:

Atributo Obrigatório? Tipo Descrição
objectId Obrigatório ID Identificador interno exclusivo usado por outros elementos para fazer referência a esse elemento.

Elementos

A tabela a seguir descreve os elementos de BallotSelection:

Elemento Multiplicidade Tipo Descrição
SequenceOrder 0 ou 1 integer

Especifica uma ordem padrão para a seleção de votação para fins de exibição

Se SequenceOrder não estiver presente no feed, nenhuma ordem será presumida.

CandidateSelection

Use CandidateSelection para identificar as seleções de votação em uma disputa de candidatos, incluindo votos por escrito.

CandidateSelection herda os atributos e elementos de BallotSelection. As referências a vários Candidate elementos podem ser incluídas, se necessário, por exemplo, quando a seleção de votação for para uma chapa de vários candidatos.

Quando vários candidatos são referenciados para uma chapa, às vezes é importante preservar a ordem deles. Nesses casos, esperamos que o aplicativo gerador liste as referências aos Candidate elementos em CandidateIds de acordo com o esquema de ordenação em vigor. Por exemplo, a ordem dos candidatos precisa corresponder à mesma ordem das referências de Office elementos em OfficeIds na Contest do tipo CandidateContest.

Se mais de um objeto Candidate for referenciado, eles serão apresentados ao usuário na seguinte ordem:

  • Todos os candidatos com IsTopTicket definido como true são ordenados antes de todos os candidatos sem um valor IsTopTicket. Eles, por sua vez, são ordenados antes de todos os candidatos com IsTopTicket definido como false. O ideal é que a seleção seja definida com um candidato sem um valor IsTopTicket ou que haja um par de candidatos, e um deles tenha IsTopTicket definido como true. Se essas condições não forem atendidas, o seguinte ocorrerá:
    • Todos os candidatos com IsTopTicket definido como true são apresentados em uma ordem indefinida.
    • Todos os candidatos com IsTopTicket não presente são apresentados em uma ordem indefinida.
    • Todos os candidatos com IsTopTicket definido como false são apresentados em uma ordem indefinida.

A sintaxe XML para CandidateSelection é a seguinte: <BallotSelection xsi:type="CandidateSelection">.

Elementos

A tabela a seguir descreve os elementos de CandidateSelection:

Elemento Multiplicidade Tipo Descrição
CandidateIds 1 IDREFS Identificadores exclusivos para um ou mais Candidate elementos. Use para associar um candidato à seleção de candidatos na votação. Também é útil quando a seleção de votação é para vários candidatos, como uma chapa com presidente e vice-presidente selecionados juntos.
EndorsementPartyIds 0 ou mais IDREFS Identificador exclusivo para duas ou mais Party entidades. Isso representa um acordo em que os partidos políticos listam o mesmo candidato em uma votação.
IncludedInAggregation 0 ou 1 boolean Indica se as contagens de votos da seleção estão incluídas na AggregateBallotSelection da disputa. Presumido false se não especificado.
IsWriteIn 0 ou 1 boolean Indica se o candidato é um voto por escrito. O valor padrão é false.

Exemplos

XML

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

PartySelection

Use PartySelection para identificar seleções de votação que envolvem um partido, como uma seleção de lista de partidos na votação.

PartySelection herda os atributos e elementos de BallotSelection. A sintaxe XML para PartySelection é a seguinte: <BallotSelection xsi:type="PartySelection" ... />.

Elementos

A tabela a seguir descreve os elementos de PartySelection:

Elemento Multiplicidade Tipo Descrição
IncludedInAggregation 0 ou 1 boolean Indica se as contagens de votos da seleção estão incluídas na AggregateBallotSelection da disputa. Presumido false se não especificado.
PartyIds 1 IDREFS Identificador exclusivo para um ou mais Party elementos. Use para associar um ou mais partidos à seleção de partidos.

Exemplos

XML

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

BallotMeasureSelection

Use BallotMeasureSelection para identificar seleções de votação que envolvem uma medida de votação, como referendos.

BallotMeasureSelection herda os atributos e elementos de BallotSelection. A sintaxe XML para BallotMeasureSelection é a seguinte: <BallotSelection xsi:type="BallotMeasureSelection" ... />.

Elementos

A tabela a seguir descreve os elementos de BallotMeasureSelection:

Elemento Multiplicidade Tipo Descrição
ExternalIdentifiers 0 ou 1 ExternalIdentifiers Associa um ID à seleção de medidas de votação. Um identificador estável é obrigatório.
Selection 1 InternationalizedText Fornece uma opção disponível para a votação, como Yes ou No.

Exemplos

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

Esse tipo de BallotSelection é usado para agregações de contagem de votos (por exemplo, agregar vários candidatos em "Outros") e diferentes tipos de não votos (ou seja, votos em branco, nulos ou inválidos e votos "nenhum dos acima").

SpecialBallotSelection não deve ser usado no subelemento BallotSelection geral de Contest e, em vez disso, tem seus próprios campos distintos em Contest, ou seja, AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection e NullBallotSelection. Consulte os Contest elementos para mais detalhes.

Elementos

A tabela a seguir descreve os elementos de SpecialBallotSelection:

Elemento Multiplicidade Tipo Descrição
CountedInTotal 0 ou 1 boolean Indica se as contagens de votos da seleção de entidades são contadas no total votos dados considerados notáveis. Presumido true se não especificado.
ExternalIdentifiers 0 ou 1 ExternalIdentifiers Associa um ID à seleção de medidas de votação. Um identificador estável é obrigatório.
Selection 1 InternationalizedText Fornece um nome para essa seleção de votação, como "Outros" ou "Nenhum dos acima".

Exemplos

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>