מועמד

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

---

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

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

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

---

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

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

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

מאפיינים

הטבלה הבאה מציגה את המאפיינים של Candidate:

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

רכיבים

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

רכיב	ריבוי	סוג	תיאור
BallotName	1	InternationalizedText	מספקת את שם המועמד כפי שהוא מופיע בפתק ההצבעה.
CampaignSlogan	0 או 1	InternationalizedText	הסיסמה שאתם מקבלים כששואלים על מועמד או את הקמפיין שלו מהי הסלוגן שלהם בקמפיין. הדוגמאות האלה מארה"ב בשנת 2020 הבחירות לנשיאות: הסיסמה של ג'ו ביידן: "הימים הטובים ביותר עדיין נמצאים קדימה". הסיסמה של דונלד טראמפ: "Make America שוב YouTube"
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>
      <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"
          }
      ]