מועמד

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

---

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

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

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

---

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

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

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

מאפיינים

בטבלה הבאה מוצגים המאפיינים של חשבון Candidate:

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

Elements

הטבלה הבאה מציגה את הרכיבים של Candidate:

רכיב	ריבוי	תיאור	התיאור
BallotName	1	InternationalizedText	מציג את שם המועמד כפי שהוא מופיע בפתק ההצבעה.
CampaignSlogan	0 או 1	InternationalizedText	סיסמת הפרסום שמוצגת כששואלים מועמד או את הקמפיין שלו מהי סיסמת הקמפיין שלו. הנה דוגמאות מהבחירות לנשיאות ארה"ב בשנת 2020: הסלוגן של ג'ו ביידן: "הימים הטובים ביותר עדיין שקועים מראש". הסיסמה של דונלד טראמפ: "לעשות את אמריקה הגדולה מחדש".
ContactInformation	0 או יותר	ContactInformation	משייכים את הכתובת של המשרד הראשי של הקמפיין, מספרי הטלפון וכו' לפרטי המועמד.
ExternalIdentifiers	1	ExternalIdentifiers	משייכת מזהה למועמד. נדרש מזהה יציב.
FileDate	0 או 1	PartialDate	התאריך שבו המועמד הגיש את הבקשה באופן רשמי לתחרות.
IsIncumbent	0 או 1	boolean	הערך true מציין שהמועמד הוא המכהן הנוכחי בתפקיד הקשור לתחרות. אם הרכיב הזה לא קיים, ברירת המחדל היא 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 של 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>
      <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",
            "PersonId": "per-001-kenyatta",
            "PostElectionStatus": "projected-winner",
            "PreElectionStatus": "qualified"
          }
      ]