Kandidat

Verwenden Sie Candidate, um Informationen zu einem Kandidaten in einem Wettbewerb zu beschreiben. Auf eine Candidate kann über die Entität CandidateSelection verwiesen werden.

Wählen Sie einen der folgenden Feedtypen aus, um mehr darüber zu erfahren, wie Sie Candidate mit diesem Feedtyp verwenden.

Einige Wahlen bestehen aus mehreren kleineren Wettbewerben oder umfassen eine Reihe von aufeinanderfolgenden Wettbewerben. Bei solchen verwandten Wettbewerben muss auf ein Person nur von einem Candidate verwiesen werden. Dazu ein Beispiel:

  • In der ersten Runde einer Wahl in Polen wird Person 1 von Kandidat 1 erwähnt.
  • Im zweiten Durchgang wird Person 1 jedoch von Kandidat 2 referenziert.

In diesem Fall sind Kandidat 1 und Kandidat 2 Duplikate. Beide Wettbewerbe müssen sich auf dieselbe Candidate beziehen. Nehmen Sie einen Kandidaten in der Regel nicht an mehreren nicht zusammenhängenden Wettbewerben teil.

Attribute

In der folgenden Tabelle sind die Attribute für Candidate aufgeführt:

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 sind die Elemente für Candidate aufgeführt:

Element Multiplizität Typ Beschreibung
BallotName 1 InternationalizedText Gibt den Namen des Kandidaten an, wie er auf dem Stimmzettel aufgeführt ist.
CampaignSlogan 0 oder 1 InternationalizedText

Der Slogan, den Sie erhalten, wenn Sie einen Kandidaten oder seine Wahlkampforganisation nach dem Kampagnenslogan fragen. Hier einige Beispiele aus den US-Präsidentschaftswahlen 2020:

  • Slogan von Joe Biden: „Our Best Days Still Lie Ahead.“ (Unsere besten Tage liegen noch vor uns.)
  • Donald Trumps Slogan: „Make America Great Again“ (Amerika wieder groß machen).
ContactInformation 0 oder mehr ContactInformation Verknüpfen Sie die Adresse des Wahlkampfbüros, Telefonnummern usw. mit den Kandidateninformationen.
ExternalIdentifiers 1 ExternalIdentifiers Ordnet dem Kandidaten eine ID zu. Eine stabile Kennung ist erforderlich.
FileDate 0 oder 1 PartialDate Das Datum, an dem der Kandidat offiziell für den Wettbewerb angemeldet wurde.
IsIncumbent 0 oder 1 boolean Der Wert true gibt an, dass der Kandidat der aktuelle Amtsinhaber des mit dem Wettbewerb verbundenen Amtes ist. Wenn dieses Element nicht vorhanden ist, wird standardmäßig false verwendet.
IsNotable 0 oder 1 boolean Gibt an, ob die Einheit als bemerkenswert gilt. Wenn nichts angegeben ist, wird false angenommen.
IsTopTicket 0 oder 1 boolean Gibt an, ob der Kandidat der Anfang eines Tickets mit mehreren Kandidaten ist. Dieses Element sollte nur angegeben werden, wenn in einem CandidateSelection-Objekt mehr als ein Candidate vorhanden ist. Fehlt dieses Element, wird standardmäßig false verwendet.
PartyId Mindestens 1 IDREF Eindeutige Kennung für ein Party-Element. Wird verwendet, um einen Kandidaten mit seiner politischen Partei zu verknüpfen.
PersonId 1 IDREF Eindeutige Kennung für ein Person-Element. Wird verwendet, um detailliertere Informationen zum Kandidaten zu verknüpfen.
PostElectionStatus 0 oder 1 CandidatePostElectionStatus Der endgültige Status des Kandidaten, z. B. winner oder withdrawn.
PreElectionStatus 0 oder 1 CandidatePreElectionStatus Der Registrierungsstatus des Kandidaten, z. B. filed oder qualified.

Zusätzliche Typen für ExternalIdentifiers

Geben Sie im ExternalIdentifiers-Element von Candidate zusätzliche Daten mit einem Type von other sowie Werte für OtherType und Value an. In der folgenden Tabelle sind die möglichen Werte für diese Elemente aufgeführt:

OtherType Beispielwerte Beschreibung
electoral-commission H2NY22097

Optional

ID der Wahlkommission.

Beispiele

XML

    <Candidate objectId="can-1001-kenyatta">
      <BallotName>
        <Text language="en">Uhuru Kenyatta</Text>
        <Text language="sw">Uhuru Kenyatta</Text>
      </BallotName>
      <ExternalIdentifiers>
         <ExternalIdentifier>
            <Type>other</Type>
            <OtherType>stable</OtherType>
            <Value>can-per-100</Value>
          </ExternalIdentifier>
          <ExternalIdentifier>
            <Type>other</Type>
            <OtherType>electoral-commission</OtherType>
            <Value>H2NY22097</Value>
          </ExternalIdentifier>
        </ExternalIdentifiers>
      <IsIncumbent>1</IsIncumbent>
      <IsTopTicket>1</IsTopTicket>
      <PartyId>par-jubilee</PartyId>
      <PartyId>par-0002</PartyId>
      <PersonId>per-001-kenyatta</PersonId>
      <PostElectionStatus>projected-winner</PostElectionStatus>
      <PreElectionStatus>qualified</PreElectionStatus>
    </Candidate>

JSON

      "Candidate": [
          {
            "objectId": "can-1001-kenyatta",
            "BallotName": {
              "Text": [
                {
                  "value": "Uhuru Kenyatta",
                  "language": "en"
                },
                {
                  "value": "Uhuru Kenyatta",
                  "language": "sw"
                }
              ]
            },
            "ExternalIdentifiers": {
              "ExternalIdentifier" : [
                {
                  "Type": "other",
                  "OtherType": "stable",
                  "Value": "can-per-100"
                },
                {
                  "Type": "other",
                  "OtherType": "electoral-commission",
                  "Value": "H2NY22097"
                },
              ]
            }
            "IsIncumbent": 1,
            "IsTopTicket": 1,
            "PartyId": ["par-jubilee","par-0002"]
            "PersonId": "per-001-kenyatta",
            "PostElectionStatus": "projected-winner",
            "PreElectionStatus": "qualified"
          }
      ]