Utilizza Candidate per descrivere le informazioni su un candidato in una competizione. A
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 o prevedono una serie di competizioni successive. In questi tipi di competizioni correlate, un Person deve essere referenziato da un solo Candidate. Considera l'esempio seguente:
- Nel primo turno di un'elezione in Polonia, Person 1 viene referenziato da Candidate 1.
- Nel secondo turno, invece, Person 1 viene referenziato da Candidate 2.
In questo caso, Candidate 1 e Candidate 2 sono duplicati. Entrambe le competizioni devono fare riferimento allo stesso Candidate. In genere, non includere un candidato in più competizioni non correlate.
Attributi
La tabella seguente mostra gli attributi di Candidate:
| Attributo | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
objectId |
Obbligatorio | ID |
Identificatore interno univoco utilizzato da altri elementi per fare riferimento 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 è riportato sulla 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 sul candidato. |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Associa un ID al candidato. È necessario 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 |
Il 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, il valore predefinito è false.
|
IsTopTicket |
0 o 1 | boolean |
Indica se il candidato è il primo di una lista che include
più candidati. Includi questo elemento solo quando in un oggetto CandidateSelection è presente più di
un Candidate.
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 su 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
withdrawn. |
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 in Brasile, 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-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" } ]