Usa Candidate para describir información sobre un candidato en un concurso. Se puede hacer referencia a un Candidate con la entidad CandidateSelection.
Selecciona uno de los siguientes tipos de feed para obtener más información sobre cómo usar Candidate con ese tipo de feed.
Algunas elecciones se componen de varias contiendas más pequeñas o implican una serie de contiendas posteriores. En este tipo de concursos relacionados, solo un Candidate puede hacer referencia a un Person. Consulta el siguiente ejemplo:
- En la primera ronda de las elecciones en Polonia, el candidato 1 hace referencia a la persona 1.
- Sin embargo, en la ronda 2, el candidato 2 hace referencia a la persona 1.
En este caso, el candidato 1 y el candidato 2 son duplicados. Ambos concursos deben hacer referencia al mismo Candidate. En general, no incluyas a un candidato en varios concursos no relacionados.
Atributos
En la siguiente tabla, se muestran los atributos de Candidate:
| Atributo | ¿Es obligatorio? | Tipo | Descripción |
|---|---|---|---|
objectId |
Obligatorio | ID |
Es el identificador interno único que usan otros elementos para hacer referencia a este. |
Elementos
En la siguiente tabla, se muestran los elementos de Candidate:
| Elemento | Multiplicidad | Tipo | Descripción |
|---|---|---|---|
BallotName |
1 | InternationalizedText |
Proporciona el nombre del candidato tal como aparece en la boleta electoral. |
CampaignSlogan |
0 o 1 |
InternationalizedText |
El lema que obtienes cuando le preguntas a un candidato o a su campaña cuál es su lema. Consulta estos ejemplos de las elecciones presidenciales de EE.UU. de 2020:
|
ContactInformation |
0 o más | ContactInformation |
Asocia la dirección de la sede central de la campaña, los números de teléfono, etc., con la información del candidato. |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Asocia un ID con el candidato. Se requiere un identificador estable. |
FileDate |
0 o 1 | PartialDate |
Es la fecha en la que el candidato presentó oficialmente su candidatura para el concurso. |
IsIncumbent |
0 o 1 | boolean |
Un valor de true indica que el candidato es el titular actual del cargo asociado con la contienda. Si este elemento no está presente, el valor predeterminado es false.
|
IsNotable |
0 o 1 | boolean |
Indica si la entidad se considera destacada. Se supone que es false si no se especifica.
|
IsTopTicket |
0 o 1 | boolean |
Indica si el candidato es el principal de un ticket que incluye varios candidatos. Solo incluye este elemento cuando haya más de un Candidate en un objeto CandidateSelection.
Si este elemento no está presente, el valor predeterminado es false. |
PartyId |
1 o más | IDREF |
Identificador único de un elemento Party. Se usa para asociar a un candidato con su partido político. |
PersonId |
1 | IDREF |
Identificador único de un elemento Person. Se usa para asociar información más detallada sobre el candidato. |
PostElectionStatus |
0 o 1 | CandidatePostElectionStatus |
Es el estado final del candidato, como winner o withdrawn. |
PreElectionStatus |
0 o 1 | CandidatePreElectionStatus |
Es el estado de registro del candidato, como filed o qualified. |
Tipos adicionales para ExternalIdentifiers
En el elemento ExternalIdentifiers de Candidate, proporciona datos adicionales con un Type de other, junto con valores para OtherType y Value. En la siguiente tabla, se muestran los valores posibles para estos elementos:
| OtherType | Valores de ejemplo | Descripción |
|---|---|---|
electoral-commission |
H2NY22097 |
Opcional ID de la comisión electoral. |
Ejemplos
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" } ]