Candidat

Utilisez Candidate pour décrire les informations sur un candidat à un concours. A Candidate peut être référencé par la classe CandidateSelection entité.

Sélectionnez l'un des types de flux suivants pour en savoir plus sur son utilisation Candidate par ce type de flux.

<ph type="x-smartling-placeholder"></ph>

Certaines élections se déroulent en plusieurs scrutins de petite envergure ou impliquent une série les concours suivants. Dans ces types de concours associés, un Person doit être référencée par un seul Candidate. Prenons l'exemple suivant :

  • Au premier tour d'une élection en Pologne, le candidat 1 fait référence à la personne 1.
  • Cependant, dans le second 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 concours doivent font référence au même Candidate. En règle générale, n'incluez pas un candidat dans plusieurs sans aucun rapport.

Attributs

Le tableau suivant présente les attributs de Candidate:

Attribut Requis ? Type Description
objectId Obligatoire ID Identifiant interne unique utilisé par d'autres éléments pour faire référence pour cet élément.

Éléments

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

Élément Multiplicité Type Description
BallotName 1 InternationalizedText Indique le nom du candidat tel qu'il est inscrit au bulletin de vote.
CampaignSlogan 0 ou 1 InternationalizedText

Le slogan que vous obtenez lorsque vous interrogez un candidat ou sa campagne le slogan de sa campagne. Consultez ces exemples de données recueillies aux États-Unis en 2020 élection présidentielle:

  • Le slogan de Joe Biden : "Our Best Days Still Lie Ahead".
  • Le slogan de Donald Trump : "Make America Great Again" (Rendez l'Amérique géniale à nouveau).
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 le candidat.
ExternalIdentifiers 1 ExternalIdentifiers Associe un ID au candidat. A identifiant stable est obligatoire.
FileDate 0 ou 1 PartialDate Date à laquelle le candidat s'est inscrit officiellement au concours.
IsIncumbent 0 ou 1 boolean La valeur true indique que le candidat est le qui est actuellement le détenteur du poste associé au concours. Si cette 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 incluant plusieurs candidats. N'incluez cet élément que lorsqu'il y a plus de un 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 . Permet d'associer un candidat à son parti politique.
PersonId 1 IDREF Identifiant unique d'un Person . Permet d'associer des informations plus détaillées sur candidat.
PostElectionStatus 0 ou 1 CandidatePostElectionStatus État final du candidat (winner ou withdrawn
PreElectionStatus 0 ou 1 CandidatePreElectionStatus État d'inscription du candidat (par exemple, filed ou qualified

Types supplémentaires pour les identifiants externes

Dans l'élément ExternalIdentifiers de Candidate, fournir des données supplémentaires avec un Type de other, ainsi que avec les valeurs OtherType et Value. Les éléments suivants : tableau présente les valeurs possibles pour ces éléments:

OtherType Exemples de valeurs 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>
      <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"
          }
      ]