نامزد

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

---

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

فیدهای داده‌های پیش از انتخابات فیدهای نتایج انتخابات

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

---

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

• در دور اول انتخابات در لهستان، شخص ۱ توسط نامزد ۱ مورد خطاب قرار می‌گیرد.
• با این حال، در دور دوم، شخص ۱ توسط کاندیدای ۲ ارجاع داده می‌شود.

در این مورد، کاندیدای ۱ و کاندیدای ۲ تکراری هستند. هر دو مسابقه باید به یک Candidate واحد ارجاع دهند. به طور کلی، یک کاندیدا را در چندین مسابقه غیرمرتبط قرار ندهید.

ویژگی‌ها

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

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

عناصر

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

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

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

در عنصر ExternalIdentifiers از Candidate ، داده‌های اضافی با Type 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>

جی‌سون

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