Seleção de balão

Use BallotSelection para identificar as opções de voto em uma disputa, como quando você vincula candidatos e partidos à contagem de votos.

Neste documento, discutimos BallotSelection e as subentidades dele:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

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

BallotSelection

BallotSelection é um elemento abstrato com três tipos que são usados com base no tipo de concurso:

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 este 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 cédulas 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 cédulas em uma disputa de candidatos, incluindo as opções de voto por escrito.

CandidateSelection herda os atributos e elementos de BallotSelection. Referências a vários elementos Candidate podem ser incluídas, se necessário. Por exemplo, quando a seleção da cédula é para uma chapa com vários candidatos.

Quando vários candidatos são referenciados para um tíquete, às vezes é importante preservar a ordem deles. Nesses casos, esperamos que o aplicativo gerador liste as referências aos elementos Candidate 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 elementos Office em OfficeIds no 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 de 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 com um par de candidatos, e um deles tenha IsTopTicket definido como true. Se essas condições não forem atendidas, o seguinte vai acontecer:
    • Todos os candidatos com IsTopTicket definido como true são apresentados em uma ordem indefinida.
    • Todos os candidatos sem IsTopTicket 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 de um ou mais elementos Candidate. Usado para associar um candidato à seleção de candidatos na cédula. Também é útil quando a seleção de cédulas é para vários candidatos, como uma chapa com presidente e vice-presidente selecionados juntos.
EndorsementPartyIds 0 ou mais IDREFS Identificador exclusivo de duas ou mais entidades Party. Isso representa um acordo em que os partidos políticos listam o mesmo candidato em uma cédula.
IsWriteIn 0 ou 1 boolean Indica se o candidato é um voto por escrito. O valor padrão é false.

Exemplos

XML

    <BallotSelection objectId="cs10861" xsi:type="CandidateSelection">
      <CandidateIds>can10861a can10861b</CandidateIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "CandidateSelection",
        "objectId": "cs10861",
        "CandidateIds": [
          "can10861a",
          "can10861b"
        ]
      }
    ]

PartySelection

Use PartySelection para identificar seleções de cédulas que envolvem um partido, como uma seleção de lista partidária na cédula.

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
PartyIds 1 IDREFS Identificador exclusivo de um ou mais elementos Party. Usado para associar uma ou mais partes à seleção de partes.

Exemplos

XML

    <BallotSelection objectId="ps150" xsi:type="PartySelection">
      <PartyIds>par100</PartyIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "PartySelection",
        "objectId": "ps150",
        "PartyIds": [
          "par100"
        ]
      }
    ]

BallotMeasureSelection

Use BallotMeasureSelection para identificar seleções de cédulas que envolvem uma medida eleitoral, 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 1 ExternalIdentifiers Associa um ID à seleção de referendo. Um identificador estável é obrigatório.
Selection 1 InternationalizedText Fornece uma opção disponível para a cédula, como Yes ou No.

Exemplos

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"
            }
          ]
        }
        "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"
            }
          ]
        }
        "Text": [
          {
            "value": "Yes",
            "language": "en"
          },
        ]
      }
    ]