Utilizza Candidate per descrivere le informazioni su un candidato in una competizione. Un
Candidate può essere referenziato dall'
CandidateSelection
entità.
Seleziona uno dei seguenti tipi di feed per scoprire di più su come utilizzare Candidate con quel tipo di feed.
Alcune elezioni sono composte da più competizioni più piccole. In questi tipi di competizioni correlate, un Person deve essere referenziato da un solo Candidate.
Considera l'esempio seguente:
- In una competizione statale che compone una competizione nazionale, Person 1 viene referenziato da Candidate 1.
- In un'altra competizione statale che compone la stessa competizione nazionale, Person 1 viene referenziato da Candidate 2.
In questo caso, Candidate 1 e Candidate 2 sono duplicati. Entrambe le competizioni devono referenziare lo stesso Candidate. In genere, non includere un candidato in più competizioni non correlate o in competizioni successive.
Attributi
La tabella seguente mostra gli attributi di Candidate:
| Attributo | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
objectId |
Obbligatorio | ID |
Identificatore interno univoco utilizzato da altri elementi per referenziare questo elemento. |
Elementi
La tabella seguente mostra gli elementi di Candidate:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
BallotName |
1 | InternationalizedText |
Fornisce il nome del candidato così come è elencato nella scheda elettorale. |
CampaignSlogan |
0 o 1 |
InternationalizedText |
Lo slogan che ottieni quando chiedi a un candidato o alla sua campagna qual è lo slogan della campagna. Consulta questi esempi delle elezioni presidenziali statunitensi del 2020:
|
ContactInformation |
0 o più | ContactInformation |
Associa l'indirizzo della sede della campagna, i numeri di telefono e così via alle informazioni del candidato. |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Associa un ID al candidato. È richiesto un identificatore stabile. |
FileDate |
0 o 1 | PartialDate |
La data in cui il candidato ha presentato ufficialmente la domanda per la competizione. |
IsIncumbent |
0 o 1 | boolean |
Un valore true indica che il candidato è l'
attuale titolare della carica associata alla competizione. Se questo
elemento non è presente, il valore predefinito è false.
|
IsNotable |
0 o 1 | boolean |
Indica se l'entità è considerata degna di nota. Se non specificato, si presume che sia false.
|
IsTopTicket |
0 o 1 | boolean |
Indica se il candidato è il primo di una lista che include
più candidati. Includi questo elemento solo quando è presente più di
un Candidate in un oggetto CandidateSelection.
Se questo elemento non è presente, il valore predefinito è false. |
PartyId |
1 o più | IDREF |
Identificatore univoco per un
Party
elemento. Utilizzato per associare un candidato al suo partito politico. |
PartyLabel |
0 o 1 | InternationalizedText |
Testo che può essere visualizzato accanto al nome di un candidato in una scheda elettorale come partito ma non è un partito qualificato per la scheda elettorale (per i luoghi che lo consentono). |
PersonId |
1 | IDREF |
Identificatore univoco per un
Person
elemento. Utilizzato per associare informazioni più dettagliate sul
candidato. |
PostElectionStatus |
0 o 1 | CandidatePostElectionStatus |
Stato finale del candidato, ad esempio winner o
advanced-to-runoff. |
PreElectionStatus |
0 o 1 | CandidatePreElectionStatus |
Stato di registrazione del candidato, ad esempio filed o
qualified. |
Tipi aggiuntivi per ExternalIdentifiers
Nell'elemento ExternalIdentifiers di Candidate,
fornisci dati aggiuntivi con un Type di other, insieme
ai valori per OtherType e Value. La tabella seguente mostra i valori possibili per questi elementi:
| OtherType | Valori di esempio | Descrizione |
|---|---|---|
electoral-commission |
H2NY22097 |
Facoltativo ID della commissione elettorale. |
tse-candidate-number |
12345 |
Facoltativo Nelle elezioni brasiliane, il numero del candidato rilasciato dal Tribunale superiore elettorale (Tribunal Superior Eleitoral – TSE). |
Esempi
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>