Stimmauswahl

Verwenden Sie BallotSelection, um die Wahlauswahlen in einem Wettbewerb zu identifizieren, z. B. wenn Sie Kandidaten und Parteien mit ihren Stimmenzahlen verknüpfen.

In diesem Dokument werden BallotSelection und die zugehörigen Unterentitäten behandelt:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection
    • SpecialBallotSelection

Wählen Sie einen der folgenden Feedtypen aus, um mehr darüber zu erfahren, wie Sie BallotSelection und die zugehörigen Elemente mit diesem Feedtyp verwenden.

BallotSelection

BallotSelection ist ein abstraktes Element mit drei Typen, die je nach Art des Wettbewerbs verwendet werden:

  • CandidateSelection: Verwenden Sie diesen type von BallotSelection, wenn der Wettbewerb für einen oder mehrere Kandidaten ist. Es verknüpft die Wahlauswahl mit den Candidate Elementen.
  • PartySelection: Verwenden Sie diesen type von BallotSelection wenn der Wettbewerbstyp für eine Party, z. B. für einen Wettbewerb mit Verhältniswahl.
  • BallotMeasureSelection: Verwenden Sie diesen Typ von BallotSelection, um mögliche Auswahlen in einem BallotMeasureContest darzustellen.
  • SpecialBallotSelection: Dieser Typ von BallotSelection wird für die Aggregation von Stimmenzahlen verwendet (z.B. Aggregation mehrerer Kandidaten zu „Andere“) und verschiedene Arten von Nicht-Stimmen (z.B. leere Stimmzettel, ungültige oder verdorbene Stimmzettel und Stimmen für „Keiner der oben genannten“).

Attribute

In der folgenden Tabelle werden die Attribute für BallotSelection beschrieben:

Attribut Erforderlich? Typ Beschreibung
objectId Erforderlich ID Eindeutige interne ID, die von anderen Elementen verwendet wird, um auf dieses Element zu verweisen.

Elemente

In der folgenden Tabelle werden die Elemente für BallotSelection beschrieben:

Element Multiplizität Typ Beschreibung
SequenceOrder 0 oder 1 integer

Gibt eine Standardreihenfolge für die Wahlauswahl zur Anzeige an.

Wenn SequenceOrder nicht im Feed vorhanden ist, wird keine Reihenfolge angenommen.

CandidateSelection

Verwenden Sie CandidateSelection, um die Wahlauswahlen in einem Wettbewerb für Kandidaten zu identifizieren, einschließlich der Kandidaten, die nicht auf dem Stimmzettel stehen.

CandidateSelection erbt die Attribute und Elemente von BallotSelection. Bei Bedarf können Verweise auf mehrere Candidate Elemente eingefügt werden, z. B. wenn die Wahlauswahl für ein Ticket mit mehreren Kandidaten gilt.

Wenn mehrere Kandidaten für ein Ticket referenziert werden, ist es manchmal wichtig, die Reihenfolge der Kandidaten beizubehalten. In diesen Fällen muss die generierende Anwendung die Verweise auf Candidate Elemente in CandidateIds gemäß dem vorhandenen Ordnungsschema auflisten. Die Reihenfolge der Kandidaten muss beispielsweise mit der Reihenfolge der Office Elementverweise in OfficeIds in der Contest vom Typ CandidateContest übereinstimmen.

Wenn mehr als ein Candidate-Objekt referenziert wird, werden sie dem Nutzer in der folgenden Reihenfolge präsentiert:

  • Alle Kandidaten, bei denen IsTopTicket auf true gesetzt ist, werden vor allen Kandidaten ohne IsTopTicket-Wert angeordnet. Diese wiederum werden vor allen Kandidaten angeordnet, bei denen IsTopTicket auf false gesetzt ist. Im Idealfall wird die Auswahl entweder mit einem Kandidaten ohne IsTopTicket-Wert festgelegt oder es gibt ein Kandidatenpaar, bei dem IsTopTicket für einen der beiden auf true gesetzt ist. Wenn diese Bedingungen nicht erfüllt sind, geschieht Folgendes:
    • Alle Kandidaten, bei denen IsTopTicket auf true gesetzt ist, werden in einer nicht definierten Reihenfolge präsentiert.
    • Alle Kandidaten, bei denen IsTopTicket nicht vorhanden ist, werden in einer nicht definierten Reihenfolge präsentiert.
    • Alle Kandidaten, bei denen IsTopTicket auf false gesetzt ist, werden in einer nicht definierten Reihenfolge präsentiert.

Die XML-Syntax für CandidateSelection lautet: <BallotSelection xsi:type="CandidateSelection">.

Elemente

In der folgenden Tabelle werden die Elemente für CandidateSelection beschrieben:

Element Multiplizität Typ Beschreibung
CandidateIds 1 IDREFS Eindeutige IDs für ein oder mehrere Candidate Elemente. Verwenden Sie diese IDs, um einen Kandidaten mit der Wahlauswahl auf dem Stimmzettel zu verknüpfen. Sie sind auch nützlich, wenn die Wahlauswahl für mehrere Kandidaten gilt, z. B. für ein Ticket, bei dem Präsident und Vizepräsident zusammen ausgewählt werden.
EndorsementPartyIds 0 oder mehr IDREFS Eindeutige ID für zwei oder mehr Party Entitäten. Dies stellt eine Vereinbarung dar, bei der die politischen Parteien denselben Kandidaten auf einem Stimmzettel auflisten.
IncludedInAggregation 0 oder 1 boolean Gibt an, ob die Stimmenzahlen der Auswahl in der AggregateBallotSelection für den Wettbewerb enthalten sind. Wenn nicht angegeben, wird false angenommen.
IsWriteIn 0 oder 1 boolean Gibt an, ob der Kandidat nicht auf dem Stimmzettel steht. Der Standardwert ist false.

Beispiele

XML

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

PartySelection

Verwenden Sie PartySelection, um Wahlauswahlen zu identifizieren, die eine Partei betreffen, z. B. eine Auswahl einer Parteiliste auf dem Stimmzettel.

PartySelection erbt die Attribute und Elemente von BallotSelection. Die XML-Syntax für PartySelection lautet: <BallotSelection xsi:type="PartySelection" ... />.

Elemente

In der folgenden Tabelle werden die Elemente für PartySelection beschrieben:

Element Multiplizität Typ Beschreibung
IncludedInAggregation 0 oder 1 boolean Gibt an, ob die Stimmenzahlen der Auswahl in der AggregateBallotSelection für den Wettbewerb enthalten sind. Wenn nicht angegeben, wird false angenommen.
PartyIds 1 IDREFS Eindeutige ID für ein oder mehrere Party Elemente. Verwenden Sie diese IDs, um eine oder mehrere Parteien mit der Wahlauswahl zu verknüpfen.

Beispiele

XML

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

BallotMeasureSelection

Verwenden Sie BallotMeasureSelection, um Wahlauswahlen zu identifizieren, die eine Abstimmung betreffen, z. B. Referenden.

BallotMeasureSelection erbt die Attribute und Elemente von BallotSelection. Die XML-Syntax für BallotMeasureSelection lautet: <BallotSelection xsi:type="BallotMeasureSelection" ... />.

Elemente

In der folgenden Tabelle werden die Elemente für BallotMeasureSelection beschrieben:

Element Multiplizität Typ Beschreibung
ExternalIdentifiers 0 oder 1 ExternalIdentifiers Verknüpft eine ID mit der Wahlauswahl. Eine stabile ID ist erforderlich.
Selection 1 InternationalizedText Gibt eine verfügbare Auswahl für den Stimmzettel an, z. B. Yes oder No.

Beispiele

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

Dieser Typ von BallotSelection wird für die Aggregation von Stimmenzahlen (z.B. Aggregation mehrerer Kandidaten zu „Andere“) und verschiedene Arten von Nicht-Stimmen verwendet (z.B. leere Stimmzettel, ungültige oder verdorbene Stimmzettel und Stimmen für „Keiner der oben genannten“).

SpecialBallotSelection sollte nicht im allgemeinen BallotSelection Unterelement von Contest verwendet werden, sondern hat eigene Felder in Contest, nämlich AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection und NullBallotSelection. Weitere Informationen finden Sie unter Contest Elemente für weitere Details.

Elemente

In der folgenden Tabelle werden die Elemente für SpecialBallotSelection beschrieben:

Element Multiplizität Typ Beschreibung
CountedInTotal 0 oder 1 boolean Gibt an, ob die Stimmenzahlen der Entitätsauswahl in der Gesamtzahl der abgegebenen Stimmen berücksichtigt werden, die als bemerkenswert gelten. Wenn nicht angegeben, wird true angenommen.
ExternalIdentifiers 0 oder 1 ExternalIdentifiers Verknüpft eine ID mit der Wahlauswahl. Eine stabile ID ist erforderlich.
Selection 1 InternationalizedText Gibt einen Namen für diese Wahlauswahl an, z. B. „Andere“ oder „Keiner der oben genannten“.

Beispiele

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>