Selección de boleta

Usa BallotSelection para identificar las selecciones de la boleta electoral en una contienda, por ejemplo, cuando vinculas a los candidatos y los partidos con sus recuentos de votos.

En este documento, se analizan BallotSelection y sus entidades secundarias:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

Selecciona uno de los siguientes tipos de feeds para obtener más información sobre cómo usar BallotSelection y sus elementos inherentes con ese tipo de feed.

BallotSelection

BallotSelection es un elemento abstracto con tres tipos que se usan según el tipo de concurso:

  • CandidateSelection: Usa este type de BallotSelection cuando el concurso sea para uno o más candidatos. Vincula la selección de la boleta electoral a los elementos Candidate.
  • PartySelection: Usa este type de BallotSelection cuando el tipo de concurso sea para un Party, como un concurso proporcional de partidos.
  • BallotMeasureSelection: Usa este tipo de BallotSelection para representar las posibles selecciones en un BallotMeasureContest.

Atributos

En la siguiente tabla, se describen los atributos de BallotSelection:

Atributo ¿Es obligatorio? Tipo Descripción
objectId Obligatorio ID Es el identificador interno único que usan otros elementos para hacer referencia a este.

Elementos

En la siguiente tabla, se describen los elementos de BallotSelection:

Elemento Multiplicidad Tipo Descripción
SequenceOrder 0 o 1 integer

Especifica un orden predeterminado para la selección de la boleta electoral con fines de visualización.

Si SequenceOrder no está presente en el feed, no se supone ningún orden.

CandidateSelection

Usa CandidateSelection para identificar las selecciones de la boleta en una contienda electoral, incluidas las candidaturas no escritas.

CandidateSelection hereda los atributos y elementos de BallotSelection. Se pueden incluir referencias a varios elementos Candidate si es necesario, por ejemplo, cuando la selección de la boleta es para un boleto de varios candidatos.

Cuando se hace referencia a varios candidatos para un ticket, a veces es importante conservar el orden de los candidatos. En estos casos, esperamos que la aplicación que genera la respuesta enumere las referencias a los elementos Candidate dentro de CandidateIds según el esquema de ordenamiento vigente. Por ejemplo, el orden de los candidatos debe coincidir con el mismo orden de las referencias de elementos Office dentro de OfficeIds en el Contest de tipo CandidateContest.

Si se hace referencia a más de un objeto Candidate, se le presentan al usuario en el siguiente orden:

  • Todos los candidatos con IsTopTicket establecido en true se ordenan antes que todos los candidatos sin un valor de IsTopTicket. A su vez, se ordenan antes que todos los candidatos con IsTopTicket establecido en false. Lo ideal es que la selección se establezca con un candidato sin un valor de IsTopTicket, o bien que haya un par de candidatos y uno de ellos tenga IsTopTicket establecido en true. Si no se cumplen estas condiciones, ocurrirá lo siguiente:
    • Todos los candidatos con IsTopTicket establecido en true se presentan en un orden indefinido.
    • Todos los candidatos que no tengan IsTopTicket se presentan en un orden indefinido.
    • Todos los candidatos con IsTopTicket establecido en false se presentan en un orden indefinido.

La sintaxis XML para CandidateSelection es la siguiente: <BallotSelection xsi:type="CandidateSelection">.

Elementos

En la siguiente tabla, se describen los elementos de CandidateSelection:

Elemento Multiplicidad Tipo Descripción
CandidateIds 1 IDREFS Son identificadores únicos para uno o más elementos Candidate. Se usa para asociar un candidato con la selección de candidatos en la boleta. También es útil cuando la selección de la boleta es para varios candidatos, como una fórmula con el presidente y el vicepresidente seleccionados juntos.
EndorsementPartyIds 0 o más IDREFS Identificador único para dos o más entidades Party. Representa un acuerdo en el que los partidos políticos incluyen al mismo candidato en la boleta electoral.
IsWriteIn 0 o 1 boolean Indica si el candidato es no registrado oficialmente. El valor predeterminado es false.

Ejemplos

XML

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

JSON

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

PartySelection

Usa PartySelection para identificar las selecciones de la boleta que involucran a un partido, como la selección de una lista de partidos en la boleta.

PartySelection hereda los atributos y elementos de BallotSelection. La sintaxis XML para PartySelection es la siguiente: <BallotSelection xsi:type="PartySelection" ... />.

Elementos

En la siguiente tabla, se describen los elementos de PartySelection:

Elemento Multiplicidad Tipo Descripción
PartyIds 1 IDREFS Identificador único para uno o más elementos Party Se usa para asociar una o más partes con la selección de partes.

Ejemplos

XML

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

JSON

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

BallotMeasureSelection

Usa BallotMeasureSelection para identificar las selecciones de la boleta electoral que involucran una medida electoral, como los referéndums.

BallotMeasureSelection hereda los atributos y elementos de BallotSelection. La sintaxis XML para BallotMeasureSelection es la siguiente: <BallotSelection xsi:type="BallotMeasureSelection" ... />.

Elementos

En la siguiente tabla, se describen los elementos de BallotMeasureSelection:

Elemento Multiplicidad Tipo Descripción
ExternalIdentifiers 1 ExternalIdentifiers Asocia un ID con la selección de la medida electoral. Se requiere un identificador estable.
Selection 1 InternationalizedText Proporciona una opción disponible para la boleta electoral, como Yes o No.

Ejemplos

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"
            }
          ]
        }
      }
    ]