Kandydat

Użyj Candidate, aby opisać informacje o kandydacie w konkursie. Do elementu Candidate można się odwołać za pomocą elementu CandidateSelection.

Wybierz jeden z tych typów plików danych, aby dowiedzieć się więcej o tym, jak używać Candidate z danym typem pliku danych.

Niektóre wybory składają się z kilku mniejszych konkursów lub obejmują serię kolejnych konkursów. W przypadku powiązanych konkursów Person musi być powiązany tylko z jednym Candidate. Przyjrzyj się temu przykładowi:

  • W I turze wyborów w Polsce osoba 1 jest powiązana z kandydatem 1.
  • W rundzie 2 Kandydat 2 odwołuje się do Osoby 1.

W tym przypadku kandydat 1 i kandydat 2 to duplikaty. Oba konkursy muszą odwoływać się do tego samego Candidate. Zasadniczo nie należy uwzględniać kandydata w wielu niezwiązanych ze sobą konkursach.

Atrybuty

W tabeli poniżej znajdziesz atrybuty Candidate:

Atrybut Wymagany? Typ Opis
objectId Wymagane ID Unikalny identyfikator wewnętrzny używany przez inne elementy do odwoływania się do tego elementu.

Elementy

W tabeli poniżej znajdziesz elementy Candidate:

Element Mnogość Typ Opis
BallotName 1 InternationalizedText Zawiera imię i nazwisko kandydata w formie, w jakiej widnieje na karcie do głosowania.
CampaignSlogan 0 lub 1 InternationalizedText

Slogan, który uzyskasz, gdy zapytasz kandydata lub jego sztab wyborczy, jaki jest slogan kampanii. Oto przykłady z wyborów prezydenckich w USA w 2020 r.:

  • Slogan Joe Bidena: „Our Best Days Still Lie Ahead” (Najlepsze dni są jeszcze przed nami).
  • Slogan Donalda Trumpa: „Make America Great Again“ (Przywróćmy Ameryce wielkość).
ContactInformation 0 lub więcej ContactInformation Powiąż adres siedziby kampanii, numery telefonów itp. z informacjami o kandydacie.
ExternalIdentifiers 1 ExternalIdentifiers Przypisuje identyfikator do kandydata. Wymagany jest stabilny identyfikator.
FileDate 0 lub 1 PartialDate Data oficjalnego zgłoszenia kandydatury w konkursie.
IsIncumbent 0 lub 1 boolean Wartość true oznacza, że kandydat jest obecnym posiadaczem urzędu związanego z wyborami. Jeśli ten element nie jest określony, domyślnie używana jest wartość false.
IsNotable 0 lub 1 boolean Czy jednostka jest uważana za godną uwagi. Jeśli nie zostanie podana, przyjmuje się wartość false.
IsTopTicket 0 lub 1 boolean Wskazuje, czy kandydat jest na szczycie listy, która zawiera wielu kandydatów. Uwzględniaj ten element tylko wtedy, gdy w obiekcie CandidateSelection jest więcej niż 1 element Candidate. Jeśli ten element nie jest określony, domyślnie używana jest wartość false.
PartyId 1 lub więcej IDREF Unikalny identyfikator elementu Party. Używane do powiązania kandydata z jego partią polityczną.
PersonId 1 IDREF Unikalny identyfikator elementu Person. Służy do powiązania bardziej szczegółowych informacji o kandydacie.
PostElectionStatus 0 lub 1 CandidatePostElectionStatus Stan końcowy kandydata, np. winner lub withdrawn.
PreElectionStatus 0 lub 1 CandidatePreElectionStatus Stan rejestracji kandydata, np. filed lub qualified.

Dodatkowe typy dla ExternalIdentifiers

W elemencie ExternalIdentifiers elementu Candidate podaj dodatkowe dane z wartością Type równą other oraz wartościami OtherType i Value. W tabeli poniżej znajdziesz możliwe wartości tych elementów:

OtherType Przykładowe wartości Opis
electoral-commission H2NY22097

Opcjonalny

Identyfikator komisji wyborczej.

Przykłady

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