Candidate を使用して、コンテストの候補者に関する情報を記述します。Candidate は CandidateSelection エンティティで参照できます。
次のいずれかのフィードタイプを選択して、そのタイプのフィードで Candidate を使用する方法の詳細をご覧ください。
一部の選挙は、複数の小規模な選挙で構成されています。このような関連するコンテストでは、Person は 1 つの Candidate によってのみ参照される必要があります。たとえば次のようになります。
- 全国選挙戦を構成する州の選挙戦では、候補者 1 が人物 1 を参照します。
- 同じ全国コンテストを構成する別の州コンテストでは、候補者 2 が人物 1 を参照しています。
この場合、候補 1 と候補 2 は重複しています。両方のコンテストで同じ Candidate を参照する必要があります。一般的に、候補者を複数の無関係なコンテストや後続のコンテストに含めないでください。
属性
次の表に、Candidate の属性を示します。
| 属性 | 必須かどうか | 種類 | 説明 |
|---|---|---|---|
objectId |
必須 | ID |
他の要素がこの要素を参照するために使用する一意の内部識別子。 |
要素
次の表に、Candidate の要素を示します。
| 要素 | 重複 | タイプ | 説明 |
|---|---|---|---|
BallotName |
1 | InternationalizedText |
候補者の名前を投票用紙に記載されているとおりに提供します。 |
CampaignSlogan |
0 または 1 |
InternationalizedText |
候補者またはそのキャンペーンにキャンペーン スローガンを尋ねたときに得られるスローガン。2020 年の米国大統領選挙の例をご覧ください。
|
ContactInformation |
0 以上 | ContactInformation |
候補者の情報に、選挙事務所の住所や電話番号などを関連付けます。 |
ExternalIdentifiers |
1 | ExternalIdentifiers |
候補者と ID を関連付けます。安定した識別子が必要です。 |
FileDate |
0 または 1 | PartialDate |
候補者がコンテストに正式にエントリーした日付。 |
IsIncumbent |
0 または 1 | boolean |
値 true は、候補者がコンテストに関連付けられた役職の現職者であることを示します。この要素がない場合、デフォルトは false です。 |
IsNotable |
0 または 1 | boolean |
エンティティが注目すべきものと見なされるかどうか。指定しない場合は false とみなされます。
|
IsTopTicket |
0 または 1 | boolean |
候補が複数の候補を含むチケットの最上位にあるかどうかを示します。この要素は、CandidateSelection オブジェクトに複数の Candidate がある場合にのみ含めます。この要素がない場合、デフォルトは false です。 |
PartyId |
1 以上 | IDREF |
Party 要素の一意の識別子。候補者を政党に関連付けるために使用されます。 |
PartyLabel |
0 または 1 | InternationalizedText |
投票用紙で候補者の名前の横に政党として表示される可能性があるが、投票用紙に記載される資格のある政党ではないテキスト(これが認められている地域の場合)。 |
PersonId |
1 | IDREF |
Person 要素の一意の識別子。候補者に関する詳細情報を関連付けるために使用されます。 |
PostElectionStatus |
0 または 1 | CandidatePostElectionStatus |
候補者の最終ステータス(winner、withdrawn など)。 |
PreElectionStatus |
0 または 1 | CandidatePreElectionStatus |
候補者の登録ステータス(filed、qualified など)。 |
ExternalIdentifiers の追加タイプ
Candidate の ExternalIdentifiers 要素で、Type が other の追加データと、OtherType と Value の値を指定します。次の表に、これらの要素で使用可能な値を示します。
| OtherType | 値の例 | 説明 |
|---|---|---|
electoral-commission |
H2NY22097 |
任意 選挙管理委員会の ID。 |
tse-candidate-number |
12345 |
任意 ブラジルの選挙では、Superior Electoral Court(Tribunal Superior Eleitoral – TSE)が発行した候補者番号。 |
例
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-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>