후보

Candidate를 사용하여 콘테스트의 후보에 관한 정보를 설명합니다. Candidate은 CandidateSelection 항목에서 참조할 수 있습니다.

다음 피드 유형 중 하나를 선택하여 해당 유형의 피드와 함께 Candidate를 사용하는 방법을 자세히 알아보세요.

일부 선거는 여러 개의 작은 콘테스트로 구성되거나 일련의 후속 콘테스트가 포함됩니다. 이러한 종류의 관련 콘테스트에서는 Person가 하나의 Candidate에 의해서만 참조되어야 합니다. 다음 예를 참고하세요.

  • 폴란드 선거 1차 투표에서 후보자 1이 사람 1을 언급합니다.
  • 하지만 2라운드에서는 후보자 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입니다.
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).

ExternalIdentifier의 추가 유형

Candidate의 ExternalIdentifiers 요소에서 other의 Type과 함께 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"
          }
      ]