Ứng cử viên

Sử dụng Candidate để mô tả thông tin về một ứng cử viên trong một cuộc thi. Đáp Candidate có thể được tham chiếu bằng CandidateSelection thực thể.

Chọn một trong các loại nguồn cấp dữ liệu sau đây để tìm hiểu thêm về cách sử dụng Candidate với loại nguồn cấp dữ liệu đó.

Một số cuộc bầu cử bao gồm nhiều cuộc tranh cử quy mô nhỏ hơn hoặc liên quan đến một loạt các cuộc bầu cử các cuộc tranh cử tiếp theo. Trong các loại cuộc thi có liên quan này, Person phải: chỉ được một Candidate tham chiếu. Hãy xem ví dụ sau đây:

  • Trong Vòng 1 của một cuộc bầu cử ở Ba Lan, Ứng cử viên số 1 được Ứng cử viên 1 tham chiếu.
  • Tuy nhiên, ở Vòng 2, Người 1 được Ứng viên 2 tham chiếu.

Trong trường hợp này, Ứng viên 1 và Ứng viên 2 bị trùng lặp. Cả hai cuộc thi đều cần tham chiếu đến cùng một Candidate. Nói chung, đừng đưa ứng cử viên vào nhiều các cuộc thi không liên quan.

Thuộc tính

Bảng sau đây trình bày các thuộc tính của Candidate:

Thuộc tính Bắt buộc? Loại Mô tả
objectId Bắt buộc ID Giá trị nhận dạng nội bộ duy nhất được các phần tử khác dùng để tham chiếu phần tử này.

Thành phần

Bảng sau đây trình bày các phần tử cho Candidate:

Phần tử Số bội Loại Mô tả
BallotName 1 InternationalizedText Cung cấp tên của ứng cử viên theo đúng thông tin trên phiếu bầu.
CampaignSlogan 0 hoặc 1 InternationalizedText

Khẩu hiệu bạn nhận được khi hỏi một ứng cử viên hoặc chiến dịch của họ khẩu hiệu chiến dịch của họ là gì. Xem những ví dụ này ở Hoa Kỳ năm 2020 bầu cử tổng thống:

  • Khẩu hiệu của Joe Biden: "Những ngày tuyệt nhất của chúng ta vẫn ở phía trước".
  • Khẩu hiệu của Donald Trump: "Make America Great trở lại".
ContactInformation 0 trở lên ContactInformation Liên kết địa chỉ trụ sở chính của chiến dịch, số điện thoại, v.v. với thông tin của ứng viên.
ExternalIdentifiers 1 ExternalIdentifiers Liên kết mã nhận dạng với ứng viên. Đáp giá trị nhận dạng ổn định là trường bắt buộc.
FileDate 0 hoặc 1 PartialDate Ngày ứng cử viên chính thức gửi đơn tham gia cuộc thi.
IsIncumbent 0 hoặc 1 boolean Giá trị true cho biết ứng viên là người đang giữ chức vụ có liên quan đến cuộc thi. Nếu trường hợp này không có phần tử, giá trị mặc định là false.
IsTopTicket 0 hoặc 1 boolean Cho biết ứng cử viên có phải là người đứng đầu phiếu yêu cầu hỗ trợ bao gồm nhiều đề xuất. Chỉ bao gồm phần tử này khi có hơn một Candidate trong đối tượng CandidateSelection. Nếu không có phần tử này, giá trị mặc định sẽ là false.
PartyId từ 1 trở lên IDREF Giá trị nhận dạng duy nhất của Party . Dùng để liên kết một ứng cử viên với đảng phái chính trị của người đó.
PersonId 1 IDREF Giá trị nhận dạng duy nhất của Person . Dùng để liên kết thông tin chi tiết hơn về ứng cử viên.
PostElectionStatus 0 hoặc 1 CandidatePostElectionStatus Trạng thái cuối cùng của ứng cử viên, chẳng hạn như winner hoặc withdrawn
PreElectionStatus 0 hoặc 1 CandidatePreElectionStatus Trạng thái đăng ký của ứng cử viên, chẳng hạn như filed hoặc qualified

Các loại bổ sung cho ExternalIdentifiers

Trong phần tử ExternalIdentifiers của Candidate, cung cấp dữ liệu bổ sung với Type là other, cùng với có giá trị cho OtherType và Value. Nội dung sau đây bảng hiển thị các giá trị có thể có cho các phần tử sau:

OtherType Giá trị mẫu Mô tả
electoral-commission H2NY22097

Không bắt buộc

Mã hoa hồng bầu cử.

Ví dụ

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