کاندیدا

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

---

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

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

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

مهم: قبل‌از اصلاح نام‌های نامزد یا مدیریت کردن سوابق تکراری، راهنمای «تغییرات نهاد نام‌دار» را مرور کنید.

---

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

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

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

مشخصه‌ها

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

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

عناصر

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

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

انواع دیگر برای ExternalIdentifiers

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

OtherType	مقادیر نمونه	شرح
electoral-commission	H2NY22097	اختیاری شناسه کمیسیون انتخابات.
tse-candidate-number	12345	اختیاری در انتخابات برزیل، شماره نامزد صادرشده توسط «دادگاه عالی گزینندگان» (Tribunal Superior Eleitoral – TSE).

مثال‌ها

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-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>