Candidat

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

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 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 l'exemple suivant :

  • Au 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 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 Indique le nom du candidat tel qu'il figure 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 leur slogan. Voici quelques exemples tirés des élections présidentielles américaines de 2020 :

  • Slogan de Joe Biden : "Le meilleur est encore à venir".
  • Le slogan de Donald Trump : "Make America Great Again" (Rendre à l'Amérique sa grandeur).
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 Une valeur de 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 remarquable. false par défaut si non spécifié.
IsTopTicket 0 ou 1 boolean Indique si le candidat est en haut d'une demande incluant plusieurs candidats. N'incluez cet élément que lorsqu'il y a 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. Permet d'associer un candidat à son parti politique.
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 withdrawn.
PreElectionStatus 0 ou 1 CandidatePreElectionStatus État de l'inscription du candidat, par exemple 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 indique les valeurs possibles pour ces éléments :

OtherType Exemples de valeur Description
electoral-commission H2NY22097

Optional

Carte d'identité de la commission électorale.

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"
          }
      ]