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 głosowań. W tego typu powiązanych konkursach Person musi być powiązany tylko z jednym Candidate. Przyjrzyj się temu przykładowi:

  • W wyborach stanowych, które składają się na wybory krajowe, Osoba 1 jest powiązana z Kandydatem 1.
  • W innych wyborach stanowych, które składają się na te same wybory krajowe, osoba 1 jest jednak powiązana z kandydatem 2.

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 ani w kolejnych konkursach.

Atrybuty

W tabeli poniżej znajdziesz atrybuty elementu 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”.
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 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. Służy do powiązania kandydata z jego partią polityczną.
PartyLabel 0 lub 1 InternationalizedText Tekst, który może pojawić się obok nazwiska kandydata na karcie do głosowania jako jego partia, ale nie jest partią uprawnioną do udziału w wyborach (w miejscach, w których jest to dozwolone).
PersonId 1 IDREF Unikalny identyfikator elementu Person. Służy do powiązania bardziej szczegółowych informacji o kandydacie.
PostElectionStatus 0 lub 1 CandidatePostElectionStatus Ostateczny stan kandydata, np. winner lub withdrawn.
PreElectionStatus 0 lub 1 CandidatePreElectionStatus Stan rejestracji kandydata, np. filed lub qualified.

Dodatkowe typy identyfikatorów zewnętrznych

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.
tse-candidate-number 12345

Opcjonalny

W przypadku wyborów w Brazylii jest to numer kandydata wydany przez Najwyższy Trybunał Wyborczy (Tribunal Superior Eleitoral – TSE).

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