Stimmauswahl

Verwenden Sie BallotSelection, um die Wahlauswahl 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 untergeordneten Einheiten behandelt:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

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 diese type von BallotSelection, wenn es sich um einen Wettbewerb für einen oder mehrere Kandidaten handelt. Damit wird die Auswahl des Stimmzettels mit den Candidate-Elementen verknüpft.
  • PartySelection: Verwenden Sie diese type von BallotSelection, wenn der Wettbewerbstyp für eine Party ist, z. B. für einen parteiproportionalen Wettbewerb.
  • BallotMeasureSelection: Verwenden Sie diesen Typ von BallotSelection, um mögliche Auswahlen in einem BallotMeasureContest darzustellen.

Attribute

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

Attribut Erforderlich? Typ Beschreibung
objectId Erforderlich ID Eindeutige interne Kennung, 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 Auswahl der Stimmzettel für die Anzeige an.

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

CandidateSelection

Verwenden Sie CandidateSelection, um die Wahlscheinauswahl in einem Kandidatenwettbewerb zu identifizieren, einschließlich der handschriftlichen Einträge.

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 erfolgt.

Wenn für ein Ticket auf mehrere Kandidaten verwiesen wird, ist es manchmal wichtig, die Reihenfolge der Kandidaten beizubehalten. In diesen Fällen muss die generierende Anwendung die Verweise auf Candidate-Elemente innerhalb von CandidateIds gemäß dem geltenden Ordnungsschema auflisten. Die Reihenfolge der Kandidaten muss beispielsweise mit der Reihenfolge der Office-Elementreferenzen in OfficeIds im Contest vom Typ CandidateContest übereinstimmen.

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

  • Alle Kandidaten, bei denen IsTopTicket auf true festgelegt ist, werden vor allen Kandidaten ohne IsTopTicket-Wert sortiert. Sie werden wiederum vor allen Kandidaten mit IsTopTicket auf false gesetzt. Im Idealfall wird die Auswahl entweder mit einem Kandidaten ohne IsTopTicket-Wert oder mit einem Kandidatenpaar festgelegt, wobei bei einem der Kandidaten IsTopTicket auf true festgelegt ist. Wenn diese Bedingungen nicht erfüllt sind, passiert Folgendes:
    • Alle Kandidaten mit IsTopTicket auf true werden in einer undefinierten Reihenfolge präsentiert.
    • Alle Kandidaten, bei denen IsTopTicket nicht vorhanden ist, werden in einer undefinierten Reihenfolge präsentiert.
    • Alle Kandidaten mit IsTopTicket auf false werden in einer undefinierten 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 Kennungen für ein oder mehrere Candidate-Elemente. Wird verwendet, um einen Kandidaten mit der Kandidatenauswahl auf dem Stimmzettel zu verknüpfen. Auch nützlich, wenn die Stimmzettel für mehrere Kandidaten ausgewählt werden, z. B. für ein Ticket mit gemeinsam ausgewählten Präsidenten und Vizepräsidenten.
EndorsementPartyIds 0 oder mehr IDREFS Eindeutige Kennung für zwei oder mehr Party-Entitäten. Dies entspricht einer Vereinbarung, bei der die politischen Parteien denselben Kandidaten auf einem Stimmzettel aufführen.
IsWriteIn 0 oder 1 boolean Gibt an, ob der Kandidat nicht auf dem ursprünglichen Stimmzettel aufgeführt war. Der Standardwert ist false.

Beispiele

XML

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

JSON

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

PartySelection

Verwenden Sie PartySelection, um Wahlscheinauswahlen zu kennzeichnen, bei denen es um eine Partei geht, z. B. die Auswahl einer Parteiliste auf dem Wahlschein.

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

Elemente

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

Element Multiplizität Typ Beschreibung
PartyIds 1 IDREFS Eindeutige Kennung für ein oder mehrere Party-Elemente. Damit können Sie der Auswahl einer oder mehrerer Parteien eine oder mehrere Parteien zuordnen.

Beispiele

XML

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

JSON

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

BallotMeasureSelection

Verwenden Sie BallotMeasureSelection, um Wahlauswahlen zu identifizieren, die sich auf eine Wahlmaßnahme beziehen, 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 1 ExternalIdentifiers Ordnet der Auswahl für die Abstimmung eine ID zu. Eine stabile Kennung ist erforderlich.
Selection 1 InternationalizedText Gibt eine verfügbare Option für die Abstimmung an, z. B. Yes oder No.

Beispiele

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