מועמד

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

---

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

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

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

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

---

חלק ממערכות הבחירות מורכבות מכמה התמודדויות קטנות יותר או כוללות סדרה של התמודדויות משנה. בתחרויות קשורות מהסוג הזה, Person אחד יכול להיות מקושר רק ל-Candidate אחד. מומלץ להביא בחשבון את הדוגמאות הבאות:

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

או:

• בסבב הראשון של הבחירות בפולין, מועמד 1 מאזכר את אדם 1.
• אבל בסבב 2, מועמד 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 או advanced-to-runoff. הערה: אם המועמד מוזכר בכמה התמודדויות קשורות, כמו בחירות כלליות וסיבוב שני, צריך להגדיר את הסטטוס הסופי הכולל של המועמד. זהו הסטטוס של התחרות ברמה הגבוהה ביותר, שהיא האחרונה ברצף של התחרויות הבאות. במקום זאת, צריך להגדיר את הסטטוס של כל תחרות בנפרד בCandidateSelection של אותה תחרות.
PreElectionStatus	0 או 1	CandidatePreElectionStatus	סטטוס הרישום של המועמד, למשל filed או qualified. הערה: אם המועמד מוזכר בכמה התמודדויות קשורות, כמו בחירות כלליות וסיבוב שני, צריך להגדיר את הסטטוס הסופי הכולל של המועמד. זהו הסטטוס של התחרות ברמה הגבוהה ביותר, שהיא האחרונה ברצף של התחרויות הבאות. במקום זאת, צריך להגדיר את הסטטוס של כל תחרות בנפרד בCandidateSelection של אותה תחרות.

סוגים נוספים של 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>