מועמד

אפשר להשתמש ב-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. התג הזה משמש לציון המפלגה שאליה משויך המועמד.
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	אופציונלי תעודה מזהה של ועדת הבחירות.

דוגמאות

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