Kandydat

Użyj Candidate, aby opisać informacje o kandydacie w konkursie. Do elementu Candidate może odwoływać się encja CandidateSelection.

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

Niektóre wybory składają się z kilku mniejszych głosowań lub obejmują serię kolejnych głosowań. W tego rodzaju powiązanych konkursach Person musi być powiązany tylko z jednym Candidate. Przeanalizuj te przykłady:

  • W wyborach na poziomie stanu, które składają się na wybory na poziomie kraju, Osoba 1 jest wymieniona przez Kandydata 1.
  • Jednak w innym konkursie stanowym, który składa się na ten sam konkurs krajowy, Osoba 1 jest wymieniona przez Kandydata 2.

Lub:

  • W pierwszej turze wyborów w Polsce kandydat 1 odnosi się do osoby 1.
  • Jednak w rundzie 2 Osoba 1 jest polecana przez Kandydata 2.

W takich przypadkach kandydat 1 i kandydat 2 są duplikatami. Oba konkursy muszą odwoływać się do tego samego elementu Candidate. Zasadniczo nie należy uwzględniać kandydata w kilku niepowiązanych 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 Imię i nazwisko kandydata w takiej formie, w jakiej widnieje na karcie do głosowania.
CampaignSlogan 0 lub 1 InternationalizedText

Slogan, który otrzymasz, gdy zapytasz kandydata lub jego sztab wyborczy o hasło kampanii. Oto przykłady z wyborów prezydenckich w USA w 2020 r.:

  • Slogan Joe Bidena: „Our Best Days Still Lie Ahead” (Najlepsze dni jeszcze przed nami).
  • Slogan Donalda Trumpa: „Make America Great Again”.
ContactInformation 0 lub więcej ContactInformation Powiąż adres siedziby sztabu wyborczego, numery telefonów itp. z informacjami o kandydacie.
ExternalIdentifiers 1 ExternalIdentifiers Powiązuje identyfikator z kandydatem. Wymagany jest stały identyfikator.
FileDate 0 lub 1 PartialDate Data oficjalnego zgłoszenia kandydata do wyborów.
IsIncumbent 0 lub 1 boolean Wartość true oznacza, że kandydat obecnie sprawuje urząd, którego dotyczy głosowanie. Jeśli ten element nie jest określony, domyślnie używana jest wartość false.
IsNotable 0 lub 1 boolean Czy podmiot jest uważany za godny uwagi. Jeśli nie określono, przyjmuje się false.
IsTopTicket 0 lub 1 boolean Wskazuje, czy kandydat jest na pierwszym miejscu na liście kandydatów, która zawiera wielu kandydatów. Uwzględnij ten element tylko wtedy, gdy w obiekcie CandidateSelection jest więcej niż 1 element Candidate. Jeśli ten element nie jest obecny, 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 to partia, która może znaleźć się na karcie do głosowania (w miejscach, gdzie 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 advanced-to-runoff.
PreElectionStatus 0 lub 1 CandidatePreElectionStatus Stan rejestracji kandydata, np. filed lub qualified.

Dodatkowe typy identyfikatorów zewnętrznych

W elemencie ExternalIdentifiers w Candidate podaj dodatkowe dane z Type o wartości other oraz wartości 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 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>