Selección de boleta

Usa BallotSelection para identificar las selecciones de votaciones de un concurso, como cuando vinculas candidatos y partidos a sus recuentos de votos.

En este documento, se analiza BallotSelection y sus subentidades:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

Selecciona uno de los siguientes tipos de feed si quieres obtener más información para 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 votación a los elementos Candidate.
  • PartySelection: Usa este type de BallotSelection cuando el tipo de concurso sea para Party, por ejemplo, en el caso de un concurso proporcional de grupos.
  • BallotMeasureSelection: Usa este tipo de BallotSelection para representar posibles selecciones en un BallotMeasureContest.

Atributos

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

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

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 votación con fines de visualización.

Si SequenceOrder no está presente en el feed, no se supone que existe un orden.
VoteCountsCollection 0 o más No disponible Wrapper para colecciones de elementos VoteCounts. Para obtener más detalles, consulta Entidades de colección.

CandidateSelection

Usa CandidateSelection para identificar las selecciones de votaciones de un concurso de candidatos, incluidas las escrituras.

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 votación es para una entrada 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, se espera que la aplicación generadora enumere las referencias a elementos Candidate dentro de CandidateIds de acuerdo con el esquema de orden establecido. Por ejemplo, el orden de los candidatos debe coincidir con el mismo orden de las referencias del elemento Office dentro de OfficeIds en el Contest de tipo CandidateContest.

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

  • Todos los candidatos con IsTopTicket establecido en true se ordenan por delante de todos los candidatos sin un valor de IsTopTicket. A su vez, se ordenan por delante de todos los candidatos con IsTopTicket establecido en false. Lo ideal es que la selección se establezca con un candidato sin un valor IsTopTicket, o bien con un par de candidatos, y uno de ellos tenga el valor 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 con IsTopTicket ausentes 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 Identificadores únicos para uno o más elementos Candidate Se usa para asociar a un candidato con la selección de candidato en la votación. También es útil cuando la selección de votación es para varios candidatos, como una entrada con el presidente y el vicepresidente seleccionados juntos.
EndorsementPartyIds 0 o más IDREFS Es el identificador único de dos o más entidades Party. Esto representa un acuerdo en el que los partidos políticos incluyen al mismo candidato en una votación.
IsWriteIn 0 o 1 boolean Indica si el candidato está escrito. 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 votación que involucran a un partido, como una selección de lista de partidos en la votación.

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 Es el identificador único de uno o más elementos Party. Se usa para asociar una o más partes con la selección de parte.

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 votación que involucran una votación, 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 medida sometida a votación. Se requiere un identificador estable.
Selection 1 InternationalizedText Proporciona una opción disponible para la votación, 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"
            }
          ]
        }
        "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"
          },
        ]
      }
    ]