Seleção de balão

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

Este documento discute BallotSelection e as subentidades dela:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

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

BallotSelection

BallotSelection é um elemento abstrato com três tipos que são usados com base em o 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 referência 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 cédulas para exibição propósitos.

Se SequenceOrder não estiver presente no feed, nenhum pedido será presumido.

CandidateSelection

Usar CandidateSelection para identificar as seleções de votação de um candidato concurso, incluindo textos.

CandidateSelection herda os atributos e elementos de BallotSelection. Referências a vários Os elementos Candidate poderão ser incluídos se necessário, por exemplo, quando a seleção da cédula é para um bilhete de múltiplas candidatos

Quando vários candidatos são indicados a um tíquete, às vezes é importante para preservar a ordem dos candidatos. Nesses casos, esperamos que os gerando o aplicativo para listar as referências a Elementos Candidate em CandidateIds de acordo com o esquema de ordenação em vigor. Por exemplo: a ordem dos candidatos precisa corresponder à mesma ordem dos As referências do elemento 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 candidatos sem um valor IsTopTicket. Eles, por sua vez, são ordenados com antecedência de todos os candidatos com IsTopTicket definido como false. O ideal é que a seleção é definido com um candidato sem um valor IsTopTicket ou são dois candidatos, e um deles tem IsTopTicket definido como true. Se essas condições não forem atendidas, ocorrerá o seguinte:
    • Todos os candidatos com IsTopTicket definido como true são apresentados em uma ordem indefinida.
    • Todos os candidatos com IsTopTicket ausente 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 Candidate os elementos. Use para associar um candidato à seleção de candidatos em na cédula. Também é útil quando a seleção da cédula é para múltiplos candidatos, como um tíquete com presidente e vice-presidente selecionados juntos.
EndorsementPartyIds 0 ou mais IDREFS Identificador exclusivo para dois ou mais Entidades Party. Isso representa um acordo em que os partidos políticos listam as mesmas candidato em uma cédula.
IsWriteIn 0 ou 1 boolean Indica se o candidato é um registro. 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 votação que envolvem um partido, como uma seleção da lista partidária na cédula.

A PartySelection herda os atributos e elementos de BallotSelection. A 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 Party os elementos. Use para associar uma ou mais partes à outra parte

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 votação que envolvem uma referendo, como referendos.

A 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 do referendo. Um identificador estável é obrigatório.
Selection 1 InternationalizedText Oferece 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"
          },
        ]
      }
    ]