Use Candidate para descrever informações sobre um candidato em uma disputa. A
Candidate pode ser referenciado pela
CandidateSelection
entidade.
Selecione um dos seguintes tipos de feed para saber mais sobre como usar Candidate com esse tipo de feed.
Algumas eleições são compostas por várias disputas menores ou envolvem uma série de disputas subsequentes. Nesses tipos de disputas relacionadas, uma Person precisa ser referenciada por apenas um Candidate. Confira o exemplo abaixo:
- Na primeira rodada de uma eleição na Polônia, a Pessoa 1 é referenciada pelo Candidato 1.
- Na segunda rodada, a Pessoa 1 é referenciada pelo Candidato 2.
Nesse caso, o Candidato 1 e o Candidato 2 são duplicados. As duas disputas precisam referenciar o mesmo Candidate. Geralmente, não inclua um candidato em várias disputas não relacionadas.
Atributos
A tabela a seguir mostra os atributos de Candidate:
| Atributo | Obrigatório? | Tipo | Descrição |
|---|---|---|---|
objectId |
Obrigatório | ID |
Identificador interno exclusivo usado por outros elementos para referenciar esse elemento. |
Elementos
A tabela a seguir mostra os elementos de Candidate:
| Elemento | Multiplicidade | Tipo | Descrição |
|---|---|---|---|
BallotName |
1 | InternationalizedText |
Fornece o nome do candidato conforme listado na cédula. |
CampaignSlogan |
0 ou 1 |
InternationalizedText |
O slogan que você recebe quando pergunta a um candidato ou à campanha dele qual é o slogan. Confira estes exemplos da eleição presidencial dos EUA de 2020:
|
ContactInformation |
0 ou mais | ContactInformation |
Associe o endereço da sede da campanha, números de telefone etc. às informações do candidato. |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Associa um ID ao candidato. Um identificador estável é obrigatório. |
FileDate |
0 ou 1 | PartialDate |
A data em que o candidato se inscreveu oficialmente para a disputa. |
IsIncumbent |
0 ou 1 | boolean |
Um valor de true indica que o candidato é o
titular atual do cargo associado à disputa. Se este
elemento não estiver presente, o padrão será false.
|
IsNotable |
0 ou 1 | boolean |
Indica se a entidade é considerada notável. O valor padrão é false
se não for especificado.
|
IsTopTicket |
0 ou 1 | boolean |
Indica se o candidato é o principal de uma chapa que inclui
vários candidatos. Inclua esse elemento apenas quando houver mais de
um Candidate em um objeto CandidateSelection.
Se esse elemento não estiver presente, o padrão será false. |
PartyId |
1 ou mais | IDREF |
Identificador exclusivo de um
Party
elemento. Usado para associar um candidato ao partido político dele. |
PartyLabel |
0 ou 1 | InternationalizedText |
Texto que pode aparecer ao lado do nome de um candidato em uma cédula como partido dele, mas não é um partido qualificado para a cédula (para locais que permitem isso). |
PersonId |
1 | IDREF |
Identificador exclusivo de um
Person
elemento. Usado para associar informações mais detalhadas sobre o
candidato. |
PostElectionStatus |
0 ou 1 | CandidatePostElectionStatus |
Status final do candidato, como winner ou
withdrawn. |
PreElectionStatus |
0 ou 1 | CandidatePreElectionStatus |
Status de registro do candidato, como filed ou
qualified. |
Outros tipos de ExternalIdentifiers
No elemento ExternalIdentifiers de Candidate,
forneça dados adicionais com um Type de other, além
de valores para OtherType e Value. A tabela a seguir mostra os valores possíveis para esses elementos:
| OtherType | Exemplos de valores | Descrição |
|---|---|---|
electoral-commission |
H2NY22097 |
Opcional ID da comissão eleitoral. |
tse-candidate-number |
12345 |
Opcional Nas eleições brasileiras, o número do candidato emitido pelo Tribunal Superior Eleitoral (TSE). |
Exemplos
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" } ]