Selección de boleta

Usa BallotSelection para identificar las selecciones de boletas en una contienda, como cuando vinculas candidatos y partidos a sus recuentos de votos.

En este documento, se analizan BallotSelection y sus subentidades:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection
    • SpecialBallotSelection

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 contienda:

  • CandidateSelection: Usa este type de BallotSelection cuando la contienda sea para uno o más candidatos. Vincula la selección de boletas a los Candidate elementos.
  • PartySelection: Usa este type de BallotSelection cuando el tipo de contienda sea para un Party, como en el caso de una contienda proporcional de partidos.
  • BallotMeasureSelection: Usa este tipo de BallotSelection para representar las posibles selecciones en un BallotMeasureContest.
  • SpecialBallotSelection: Este tipo de BallotSelection se usa para las agregaciones de recuentos de votos (p. ej., agregar varios candidatos en "Otros") y diferentes tipos de votos nulos (es decir, boletas en blanco, boletas nulas o anuladas, y votos de "ninguno de los anteriores").

Atributos

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

Atributo ¿Es obligatorio? Tipo Descripción
objectId Obligatorio ID Es un 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 boletas 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 boletas en una contienda de candidatos, incluidas las candidaturas por escrito.

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

Cuando se hace referencia a varios candidatos para una lista, a veces es importante conservar el orden de los candidatos. En estos casos, esperamos que la aplicación generadora enumere las referencias a los Candidate elementos dentro de CandidateIds según el esquema de ordenamiento que esté vigente. Por ejemplo, el orden de los candidatos debe coincidir con el mismo orden de las referencias de los elementos Office dentro de OfficeIds en la Contest del 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 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 IsTopTicket o que haya un par de candidatos y uno de ellos tenga IsTopTicket establecido en true. Si no se cumplen estas condiciones, sucede lo siguiente:
    • Todos los candidatos con IsTopTicket establecido en true se presentan en un orden indefinido.
    • Todos los candidatos con IsTopTicket no presente se presentan en un orden indefinido.
    • Todos los candidatos con IsTopTicket establecido en false se presentan en un orden indefinido.

La sintaxis XML de 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 Candidate elementos. Úsalos para asociar un candidato con la selección de candidatos en la boleta. También es útil cuando la selección de boletas es para varios candidatos, como una lista con el presidente y el vicepresidente seleccionados juntos.
EndorsementPartyIds 0 o más IDREFS Es un identificador único para dos o más Party entidades. Representa un acuerdo en el que los partidos políticos enumeran al mismo candidato en una boleta.
IncludedInAggregation 0 o 1 boolean Indica si los recuentos de votos de la selección se incluyen en el AggregateBallotSelection de la contienda. Se supone que es false si no se especifica.
IsWriteIn 0 o 1 boolean Indica si el candidato es una candidatura por escrito. El valor predeterminado es false.
PostElectionStatus 0 o 1 CandidatePostElectionStatus Es el estado final del candidato, como winner o advanced-to-runoff.
PreElectionStatus 0 o 1 CandidatePreElectionStatus Es el estado de registro del candidato, como filed o qualified.

Ejemplos

XML

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

PartySelection

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

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

Elementos

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

Elemento Multiplicidad Tipo Descripción
IncludedInAggregation 0 o 1 boolean Indica si los recuentos de votos de la selección se incluyen en el AggregateBallotSelection de la contienda. Se supone que es false si no se especifica.
PartyIds 1 IDREFS Es un identificador único para uno o más Party elementos. Úsalo para asociar uno o más partidos con la selección de partidos.

Ejemplos

XML

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

BallotMeasureSelection

Usa BallotMeasureSelection para identificar las selecciones de boletas que involucran una medida electoral, como los referendos.

BallotMeasureSelection hereda los atributos y elementos de BallotSelection. La sintaxis XML de 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 0 o 1 ExternalIdentifiers Asocia un ID con la selección de medidas electorales. Se requiere un identificador estable.
Selection 1 InternationalizedText Proporciona una opción disponible para la boleta, como Yes o No.

Ejemplos

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

Este tipo de BallotSelection se usa para las agregaciones de recuentos de votos (p. ej., agregar varios candidatos en "Otros") y diferentes tipos de votos nulos (es decir, boletas en blanco, boletas nulas o anuladas, y votos de "ninguno de los anteriores").

SpecialBallotSelection no se debe usar en el BallotSelection subelemento general de Contest y, en cambio, tiene sus propios campos distintos en Contest, es decir, AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection y NullBallotSelection. Consulta los Contest elementos para obtener más detalles.

Elementos

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

Elemento Multiplicidad Tipo Descripción
CountedInTotal 0 o 1 boolean Indica si los recuentos de votos de la selección de entidades se incluyen en el total votos emitidos que se consideran notables. Se supone que es true si no se especifica.
ExternalIdentifiers 0 o 1 ExternalIdentifiers Asocia un ID con la selección de medidas electorales. Se requiere un identificador estable.
Selection 1 InternationalizedText Proporciona un nombre para esta selección de boletas, como "Otros" o "Ninguno de los anteriores".

Ejemplos

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>