מועמד

משתמשים ב-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-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"
          }
      ]