نامزد

از Candidate برای توصیف اطلاعات مربوط به یک نامزد در یک مسابقه استفاده کنید. یک Candidate می تواند توسط نهاد CandidateSelection ارجاع داده شود.

---

یکی از انواع فید زیر را انتخاب کنید تا درباره نحوه استفاده از Candidate با آن نوع فید بیشتر بدانید.

فیدهای داده‌های قبل از انتخابات فیدهای نتایج انتخابات

توجه: این موجودیت با فیدهای صاحبان دفتر استفاده نمی شود.

---

برخی از انتخابات از چندین رقابت کوچکتر تشکیل شده یا شامل یک سری رقابت های بعدی است. در این نوع مسابقات مرتبط، یک Person باید تنها توسط یک Candidate معرفی شود. به مثال زیر توجه کنید:

• در دور 1 انتخابات در لهستان، نامزد 1 به شخص 1 ارجاع داده می شود.
• اما در دور 2، شخص 1 توسط کاندید 2 ارجاع داده می شود.

در این حالت، کاندید 1 و کاندید 2 تکراری هستند. هر دو مسابقه باید به یک Candidate ارجاع دهند. به طور کلی، یک نامزد را در چندین مسابقه نامرتبط قرار ندهید.

صفات

جدول زیر ویژگی های Candidate را نشان می دهد:

صفت	مورد نیاز؟	تایپ کنید	توضیحات
objectId	مورد نیاز	ID	شناسه داخلی منحصر به فرد که توسط عناصر دیگر برای ارجاع به این عنصر استفاده می شود.

عناصر

جدول زیر عناصر Candidate را نشان می دهد:

عنصر	کثرت	تایپ کنید	توضیحات
BallotName	1	InternationalizedText	نام نامزد را همانطور که در برگه رای درج شده است ارائه می دهد.
CampaignSlogan	0 یا 1	InternationalizedText	شعاری که وقتی از یک نامزد یا کمپین انتخاباتی او می‌پرسید شعار تبلیغاتی آنها چیست. این نمونه ها از انتخابات ریاست جمهوری 2020 آمریکا را ببینید: شعار جو بایدن: "بهترین روزهای ما هنوز در راه است." شعار دونالد ترامپ: «آمریکا را دوباره بزرگ کنیم».
ContactInformation	0 یا بیشتر	ContactInformation	آدرس ستاد، شماره تلفن و غیره را با اطلاعات نامزدها مرتبط کنید.
ExternalIdentifiers	1	ExternalIdentifiers	شناسه ای را با نامزد مرتبط می کند. یک شناسه پایدار مورد نیاز است.
FileDate	0 یا 1	PartialDate	تاریخی که نامزد رسماً برای مسابقه ثبت نام کرد.
IsIncumbent	0 یا 1	boolean	مقدار true نشان می دهد که نامزد صاحب فعلی دفتر مرتبط با مسابقه است. اگر این عنصر وجود نداشته باشد، پیش فرض false است.
IsTopTicket	0 یا 1	boolean	نشان می دهد که آیا نامزد بالای یک بلیط است که شامل چندین نامزد می شود یا خیر. فقط زمانی این عنصر را درج کنید که بیش از یک Candidate در یک شی CandidateSelection وجود داشته باشد. اگر این عنصر وجود نداشته باشد، پیش فرض false است.
PartyId	1 یا بیشتر	IDREF	شناسه منحصر به فرد برای یک عنصر Party . برای مرتبط کردن یک نامزد با حزب سیاسی آنها استفاده می شود.
PersonId	1	IDREF	شناسه منحصر به فرد برای عنصر Person . برای مرتبط کردن اطلاعات دقیق تر در مورد نامزد استفاده می شود.
PostElectionStatus	0 یا 1	CandidatePostElectionStatus	وضعیت نهایی نامزد مانند winner یا withdrawn .
PreElectionStatus	0 یا 1	CandidatePreElectionStatus	وضعیت ثبت نام داوطلب مانند filed یا qualified .

انواع اضافی برای شناسه های خارجی

در عنصر ExternalIdentifiers از Candidate ، داده های اضافی را با Type of other همراه با مقادیر OtherType و Value ارائه دهید. جدول زیر مقادیر ممکن برای این عناصر را نشان می دهد:

نوع دیگر	مقادیر نمونه	توضیحات
electoral-commission	H2NY22097	اختیاری شناسه کمیسیون انتخابات

نمونه ها

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