候補

Candidate を使用して、コンテストの候補者に関する情報を記述します。Candidate は CandidateSelection エンティティで参照できます。

次のいずれかのフィードタイプを選択して、そのタイプのフィードで Candidate を使用する方法の詳細をご確認ください。

一部の選挙は、複数の小規模な選挙で構成されているか、一連の連続した選挙が含まれています。このような関連するコンテストでは、Person は 1 つの Candidate によってのみ参照される必要があります。たとえば次のようになります。

  • ポーランドの選挙の第 1 ラウンドで、候補者 1 が人物 1 を参照しています。
  • 第 2 ラウンドでは、候補者 2 が人物 1 を参照しています。

この場合、候補 1 と候補 2 は重複しています。両方のコンテストで同じ Candidate を参照する必要があります。一般的に、候補者を複数の無関係なコンテストに含めないでください。

属性

次の表に、Candidate の属性を示します。

属性 必須かどうか 型 説明
objectId 必須 ID 他の要素がこの要素を参照するために使用する一意の内部識別子。

要素

次の表に、Candidate の要素を示します。

要素 重複 タイプ 説明
BallotName 1 InternationalizedText 投票用紙に記載されている候補者の名前を提供します。
CampaignSlogan 0 または 1 InternationalizedText

候補者またはそのキャンペーンにキャンペーン スローガンを尋ねたときに得られるスローガン。2020 年の米国大統領選挙の例をご覧ください。

  • ジョー・バイデンのスローガン: 「Our Best Days Still Lie Ahead」（最高の日はまだこれから）。
  • ドナルド・トランプのキャッチフレーズ: 「Make America Great Again（アメリカを再び偉大な国に）」
ContactInformation 0 以上 ContactInformation 候補者の情報に、選挙事務所の住所や電話番号などを関連付けます。
ExternalIdentifiers 1 ExternalIdentifiers 候補者と ID を関連付けます。安定した識別子が必要です。
FileDate 0 または 1 PartialDate 候補者がコンテストに正式に登録した日付。
IsIncumbent 0 または 1 boolean 値 true は、候補者がコンテストに関連付けられた役職の現在の保持者であることを示します。この要素がない場合、デフォルトは false です。
IsTopTicket 0 または 1 boolean 候補が複数の候補を含むチケットの最上位にあるかどうかを示します。この要素は、CandidateSelection オブジェクトに複数の Candidate がある場合にのみ含めます。この要素がない場合、デフォルトは false です。
PartyId 1 以上 IDREF Party 要素の一意の識別子。候補者を政党に関連付けるために使用されます。
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。

例

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