מועמד

משתמשים ב-Candidate כדי לתאר מידע על מועמד בתחרות. אפשר להפנות אל Candidate באמצעות הישות CandidateSelection.

---

בוחרים אחד מסוגי הפידים הבאים כדי לקבל מידע נוסף על השימוש ב-Candidate עם סוג הפיד הזה.

פידים של נתונים לפני הבחירות פידים של תוצאות הבחירות

הערה: הישות הזו לא משמשת בפידים של בעלי תפקידים ציבוריים.

חשוב: לפני שמשנים שמות של מועמדים או מנהלים רשומות כפולות, כדאי לעיין במדריך בנושא 'שינויים בישויות בעלות שם'.

---

בחלק מהבחירות יש כמה התמודדויות קטנות יותר. בתחרויות קשורות כאלה, כל Person צריך להיות מוזכר רק בCandidate אחד. דוגמה:

• במערכת בחירות במדינה שמהווה חלק ממערכת בחירות ארצית, מועמד 1 מתייחס לאדם 1.
• לעומת זאת, בתחרות אחרת במדינה שמהווה חלק מאותה תחרות ארצית, מועמד 2 מתייחס לאדם 1.

במקרה הזה, מועמד 1 ומועמד 2 הם כפילויות. שתי התחרויות צריכות להתייחס לאותו Candidate. בדרך כלל, לא כדאי לכלול מועמד בכמה תחרויות לא קשורות או בתחרויות עוקבות.

מאפיינים

בטבלה הבאה מפורטים המאפיינים של Candidate:

מאפיין	חובה?	סוג	תיאור
objectId	חובה	ID	מזהה פנימי ייחודי שמשמש רכיבים אחרים כדי ליצור הפניה לרכיב הזה.

רכיבים

בטבלה הבאה מפורטים הרכיבים של Candidate:

רכיב	ריבוי	סוג	תיאור
BallotName	1	InternationalizedText	שם המועמד כפי שהוא מופיע בפתק ההצבעה.
CampaignSlogan	0 או 1	InternationalizedText	הסלוגן שמתקבל כששואלים מועמד או את הקמפיין שלו מה הסלוגן של הקמפיין. הנה כמה דוגמאות מהבחירות לנשיאות ארה"ב ב-2020: הסיסמה של ג'ו ביידן: "הימים הטובים ביותר עוד לפנינו". הסיסמה של דונלד טראמפ: "Make America Great Again" (להחזיר את אמריקה לגדולתה).
ContactInformation	‫0 או יותר	ContactInformation	משייכים את הכתובת של מטה הקמפיין, מספרי הטלפון וכו' לפרטי המועמד.
ExternalIdentifiers	1	ExternalIdentifiers	משייך מזהה למועמד. צריך לציין מזהה יציב.
FileDate	0 או 1	PartialDate	התאריך שבו המועמד הגיש באופן רשמי את מועמדותו לתחרות.
IsIncumbent	0 או 1	boolean	הערך true מציין שהמועמד הוא בעל התפקיד הנוכחי שמשויך לבחירות. אם הרכיב הזה לא קיים, ברירת המחדל היא false.
IsNotable	0 או 1	boolean	האם הישות נחשבת לראויה לציון. אם לא מציינים ערך, ברירת המחדל היא false. הערה: זו החלטה מערכתית שספקי הנתונים מקבלים לגבי מה נחשב לנתון חשוב בבחירות מסוימות.
IsTopTicket	0 או 1	boolean	מציין אם המועמד הוא בראש כרטיס הצבעה שכולל כמה מועמדים. צריך לכלול את הרכיב הזה רק אם יש יותר מ-Candidate אחד באובייקט CandidateSelection. אם הרכיב הזה לא קיים, ברירת המחדל היא false.
PartyId	1 או יותר	IDREF	מזהה ייחודי של רכיב Party. התכונה הזו משמשת לשיוך של מועמד למפלגה הפוליטית שלו.
PartyLabel	0 או 1	InternationalizedText	טקסט שיכול להופיע ליד השם של מועמד בקלפי בתור המפלגה שלו, אבל לא מדובר במפלגה שעומדת בדרישות להופעה בקלפי (במקומות שבהם זה מותר).
PersonId	1	IDREF	מזהה ייחודי של רכיב Person. המאפיין הזה משמש לשיוך מידע מפורט יותר על המועמד.
PostElectionStatus	0 או 1	CandidatePostElectionStatus	הסטטוס הסופי של המועמד, למשל winner או withdrawn.
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>