Candidat

Utilisez Candidate pour décrire les informations sur un candidat à un concours. Un Candidate peut être référencé par l'entité CandidateSelection.

---

Sélectionnez l'un des types de flux suivants pour savoir comment utiliser Candidate avec ce type de flux.

Flux de données préélectorales Flux de résultats des élections

Remarque : Cette entité n'est pas utilisée avec les flux de titulaires de fonction.

Important : Consultez le guide sur les modifications des entités nommées avant de modifier les noms des candidats ou de gérer les enregistrements en double.

---

Certaines élections se composent de plusieurs scrutins plus petits ou impliquent une série de scrutins ultérieurs. Dans ce type de concours associés, un Person ne doit être référencé que par un seul Candidate. Prenons les exemples suivants :

• Dans un scrutin d'État qui compose un scrutin national, la Personne 1 est référencée par le Candidat 1.
• Toutefois, dans un autre scrutin d'État qui compose le même scrutin national, la Personne 1 est référencée par le Candidat 2.

soit :

• Lors du premier tour d'une élection en Pologne, la Personne 1 est référencée par le Candidat 1.
• Cependant, au deuxième tour, la personne 1 est référencée par le candidat 2.

Dans ce cas, le candidat 1 et le candidat 2 sont des doublons. Les deux concours doivent faire référence au même Candidate. En règle générale, n'incluez pas un candidat dans plusieurs élections sans rapport.

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 référencer cet élément.

Éléments

Le tableau suivant présente les éléments de Candidate :

Élément	Multiplicité	Type	Description
BallotName	1	InternationalizedText	Indique le nom du candidat tel qu'il figure sur le bulletin de vote.
CampaignSlogan	0 ou 1	InternationalizedText	Le 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 : Slogan de Joe Biden : "Our Best Days Still Lie Ahead" (Le meilleur est encore à venir). Le slogan de Donald Trump : "Make America Great Again".
ContactInformation	0 ou plus	ContactInformation	Associez l'adresse du siège de la 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é au scrutin. 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 digne d'intérêt. false est utilisé si aucune valeur n'est spécifiée. Remarque : Il s'agit d'une décision éditoriale laissée à la discrétion des fournisseurs de données, qui déterminent ce qui est considéré comme notable lors d'une élection donné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 s'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 élément Party. Utilisé pour associer un candidat à son parti politique.
PartyLabel	0 ou 1	InternationalizedText	Texte pouvant s'afficher à côté du nom d'un candidat sur un bulletin de vote pour indiquer son parti, mais qui n'est pas un parti qualifié pour le scrutin (pour les lieux qui l'autorisent).
PersonId	1	IDREF	Identifiant unique d'un élément Person. Utilisé pour associer des informations plus détaillées sur le candidat.
PostElectionStatus	0 ou 1	CandidatePostElectionStatus	État final du candidat, tel que winner ou advanced-to-runoff. Remarque : Si le candidat est référencé dans plusieurs élections associées, comme une élection générale et son second tour, définissez ce champ sur le statut final global du candidat. Il s'agit de l'état du concours de plus haut niveau qui se trouve en dernier dans la séquence des concours suivants. Définissez plutôt l'état de chaque concours sur la page CandidateSelection de ce concours.
PreElectionStatus	0 ou 1	CandidatePreElectionStatus	État d'enregistrement du candidat, par exemple filed ou qualified. Remarque : Si le candidat est référencé dans plusieurs élections associées, comme une élection générale et son second tour, définissez ce champ sur le statut final global du candidat. Il s'agit de l'état du concours de plus haut niveau qui se trouve en dernier dans la séquence des concours suivants. Définissez plutôt l'état de chaque concours sur la page CandidateSelection de ce concours.

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	Optional ID de la commission électorale.
tse-candidate-number	12345	Optional Pour les élections au Brésil, numéro de candidat attribué par le Tribunal supérieur électoral (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-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>