Candidat

Utilisez Candidate pour décrire des 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 en savoir plus sur l'utilisation de Candidate avec ce type de flux.

Certaines élections sont composées de plusieurs scrutins de plus petite envergure ou d'une série d'élections ultérieures. 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, le candidat 1 désigne la personne 1.
  • Cependant, au tour 2, la personne 1 est référencée par le candidat 2.

Dans ce cas, les propositions 1 et 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 scrutins sans rapport.

Attributs

Le tableau suivant présente les attributs pour Candidate:

Attribut Requis ? 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 pour Candidate:

Élément Multiplicité Type Description
BallotName 1 InternationalizedText Fournit le nom du candidat tel qu'il figure sur le bulletin de vote.
CampaignSlogan 0 ou 1 InternationalizedText

Slogan qui s'affiche lorsque vous demandez à un candidat ou à sa campagne quel est son slogan. Voici quelques exemples de l'élection présidentielle américaine de 2020:

  • Le slogan de Joe Biden : "Our Best Days Still Lie Ahead"
  • Le slogan de Donald Trump : "Make America Great Again"
ContactInformation 0 ou plus ContactInformation Associez l'adresse du siège social de la campagne, les numéros de téléphone, etc. aux informations sur les candidats.
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é au concours.
IsIncumbent 0 ou 1 boolean La valeur true indique que le candidat est le titulaire actuel du poste associé au concours. Si cet élément n'est pas présent, la valeur par défaut est false.
IsTopTicket 0 ou 1 boolean Indique si le candidat apparaît en haut d'une demande qui inclut 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 IDREF Identifiant unique d'un élément Party. Utilisés pour associer un candidat à son parti politique.
PersonId 1 IDREF Identifiant unique d'un élément Person. Permet d'associer des informations plus détaillées sur le candidat.
PostElectionStatus 0 ou 1 CandidatePostElectionStatus État final du candidat (par exemple, 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 défini sur 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.

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>
      <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",
            "PersonId": "per-001-kenyatta",
            "PostElectionStatus": "projected-winner",
            "PreElectionStatus": "qualified"
          }
      ]