Candidato

Utilizza Candidate per descrivere le informazioni su un candidato in un concorso. Un Candidate può essere referenziato dall'entità CandidateSelection.

Seleziona uno dei seguenti tipi di feed per scoprire di più su come utilizzare Candidate con quel tipo di feed.

Alcune elezioni sono composte da più competizioni più piccole o prevedono una serie di competizioni successive. In questi tipi di concorsi correlati, un Person deve essere riferito a un solo Candidate. Considera l'esempio seguente:

  • Nel primo turno di un'elezione in Polonia, la persona 1 viene citata dal candidato 1.
  • Nel secondo round, invece, la persona 1 viene citata dal candidato 2.

In questo caso, il candidato 1 e il candidato 2 sono duplicati. Entrambi i concorsi devono fare riferimento allo stesso Candidate. In genere, non includere un candidato in più concorsi non correlati.

Attributi

La tabella seguente mostra gli attributi per Candidate:

Attributo Obbligatorio? Tipo Descrizione
objectId Obbligatorio ID Identificatore interno univoco utilizzato da altri elementi per fare riferimento a questo elemento.

Elementi

La tabella seguente mostra gli elementi per Candidate:

Elemento Molteplicità Tipo Descrizione
BallotName 1 InternationalizedText Fornisce il nome del candidato così come è elencato nella scheda elettorale.
CampaignSlogan 0 o 1 InternationalizedText

Lo slogan che ottieni quando chiedi a un candidato o alla sua campagna qual è lo slogan della campagna. Vedi questi esempi delle elezioni presidenziali statunitensi del 2020:

  • Lo slogan di Joe Biden: "Our Best Days Still Lie Ahead" (I nostri giorni migliori devono ancora venire).
  • Lo slogan di Donald Trump: "Make America Great Again".
ContactInformation 0 o più ContactInformation Associa l'indirizzo della sede della campagna, i numeri di telefono e così via alle informazioni del candidato.
ExternalIdentifiers 1 ExternalIdentifiers Associa un ID al candidato. È necessario un identificatore stabile.
FileDate 0 o 1 PartialDate La data in cui il candidato ha presentato ufficialmente la candidatura.
IsIncumbent 0 o 1 boolean Un valore di true indica che il candidato è l'attuale titolare della carica associata al concorso. Se questo elemento non è presente, il valore predefinito è false.
IsNotable 0 o 1 boolean Indica se l'entità è considerata degna di nota. false presunto se non specificato.
IsTopTicket 0 o 1 boolean Indica se il candidato è il primo di una richiesta che include più candidati. Includi questo elemento solo quando è presente più di un Candidate in un oggetto CandidateSelection. Se questo elemento non è presente, il valore predefinito è false.
PartyId 1 o più IDREF Identificatore univoco per un Party elemento. Utilizzato per associare un candidato al suo partito politico.
PersonId 1 IDREF Identificatore univoco per un Person elemento. Utilizzato per associare informazioni più dettagliate sul candidato.
PostElectionStatus 0 o 1 CandidatePostElectionStatus Stato finale del candidato, ad esempio winner o withdrawn.
PreElectionStatus 0 o 1 CandidatePreElectionStatus Stato della registrazione del candidato, ad esempio filed o qualified.

Tipi aggiuntivi per ExternalIdentifiers

Nell'elemento ExternalIdentifiers di Candidate, fornisci dati aggiuntivi con un Type di other, insieme ai valori per OtherType e Value. La tabella seguente mostra i valori possibili per questi elementi:

OtherType Valori di esempio Descrizione
electoral-commission H2NY22097

Facoltativo

ID della commissione elettorale.

Esempi

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