Utilisez Candidate pour décrire les informations sur un candidat lors d'une élection. A
Candidate peut être référencée par l'
CandidateSelection
entité.
Sélectionnez l'un des types de flux suivants pour en savoir plus sur l'utilisation de Candidate avec ce type de flux.
Certaines élections sont composées de plusieurs élections plus petites ou impliquent une série d'élections ultérieures. Dans ce type d'élections associées, une Person ne doit être référencée que par une seule Candidate. Prenons l'exemple suivant :
- Au premier tour d'une élection en Pologne, la personne 1 est référencée par le candidat 1.
- Au deuxième tour, la personne 1 est référencée par le candidat 2.
Dans ce cas, les candidats 1 et 2 sont des doublons. Les deux élections doivent faire référence à la même Candidate. En règle générale, n'incluez pas un candidat dans plusieurs élections sans lien entre elles.
Attributs
Le tableau suivant présente les attributs de Candidate :
| Attribut | Obligatoire ? | Type | Description |
|---|---|---|---|
objectId |
Obligatoire | ID |
Identifiant interne unique utilisé par d'autres éléments pour faire référence à cet élément. |
Éléments
Le tableau suivant présente les éléments de Candidate :
| Élément | Multiplicité | Type | Description |
|---|---|---|---|
BallotName |
1 | InternationalizedText |
Fournit le nom du candidat tel qu'il apparaît sur le bulletin de vote. |
CampaignSlogan |
0 ou 1 |
InternationalizedText |
Slogan que vous obtenez lorsque vous demandez à un candidat ou à son équipe de campagne quel est son slogan. Voici quelques exemples tirés de l'élection présidentielle américaine de 2020 :
|
ContactInformation |
0 ou plus | ContactInformation |
Associez l'adresse du siège de campagne, les numéros de téléphone, etc. aux informations sur le candidat. |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Associe un ID au candidat. Un identifiant stable est requis. |
FileDate |
0 ou 1 | PartialDate |
Date à laquelle le candidat s'est officiellement présenté à l'élection. |
IsIncumbent |
0 ou 1 | boolean |
La valeur true indique que le candidat est le
titulaire actuel du poste associé à l'élection. Si cet
élément n'est pas présent, la valeur par défaut est false.
|
IsNotable |
0 ou 1 | boolean |
Indique si l'entité est considérée comme notable. La valeur false
est supposée si elle n'est pas spécifiée.
|
IsTopTicket |
0 ou 1 | boolean |
Indique si le candidat est en tête d'une liste qui comprend
plusieurs candidats. N'incluez cet élément que lorsqu'il existe plusieurs
Candidate dans un objet CandidateSelection.
Si cet élément n'est pas présent, la valeur par défaut est false. |
PartyId |
1 ou plus | IDREF |
Identifiant unique d'un
Party
élément. Permet d'associer un candidat à son parti politique. |
PartyLabel |
0 ou 1 | InternationalizedText |
Texte qui peut apparaître à côté du nom d'un candidat sur un bulletin de vote en tant que parti, mais qui n'est pas un parti éligible au vote (pour les lieux où cela est autorisé). |
PersonId |
1 | IDREF |
Identifiant unique d'un
Person
élément. Permet d'associer des informations plus détaillées sur le
candidat. |
PostElectionStatus |
0 ou 1 | CandidatePostElectionStatus |
État final du candidat, tel que winner ou
withdrawn. |
PreElectionStatus |
0 ou 1 | CandidatePreElectionStatus |
État d'inscription du candidat, tel que filed ou
qualified. |
Types supplémentaires pour ExternalIdentifiers
Dans l'élément ExternalIdentifiers de Candidate,
fournissez des données supplémentaires avec un Type de other, ainsi
que des valeurs pour OtherType et Value. Le tableau suivant présente les valeurs possibles pour ces éléments :
| OtherType | Exemples de valeur | Description |
|---|---|---|
electoral-commission |
H2NY22097 |
Facultatif ID de la commission électorale. |
tse-candidate-number |
12345 |
Facultatif Lors des élections au Brésil, numéro de candidat délivré par le Tribunal supérieur Electoral Court (Tribunal Superior Eleitoral – TSE). |
Exemples
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" } ]