בחירת פתק

יש להשתמש ב-BallotSelection כדי לזהות את פתקי ההצבעה בבחירות, כגון כשמקשרים בין מועמדים ומפלגות לספירת הקולות שלהם.

מסמך זה עוסק בBallotSelection ובישויות המשנה שלו:

• BallotSelection
  • CandidateSelection
  • PartySelection
  • BallotMeasureSelection

---

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

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

---

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

BallotSelection

BallotSelection הוא אלמנט מופשט עם שלושה סוגים שנעשה בהם שימוש בהתבסס על סוג התחרות:

• CandidateSelection: שימוש ב-type מתוך BallotSelection כאשר התחרות היא למועמד אחד או יותר. הוא מקשר את פתקי ההצבעה בבחירות Candidate.
• PartySelection: שימוש ב-type מתוך BallotSelection הזה כשסוג התחרות הוא Party, למשל, לתחרות פרופורציונלית של מפלגה.
• BallotMeasureSelection: צריך להשתמש בסוג הזה של BallotSelection כדי לייצג בחירות אפשריות BallotMeasureContest.

מאפיינים

הטבלה הבאה מתארת את המאפיינים של BallotSelection:

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

רכיבים

בטבלה הבאה מתוארים הרכיבים של BallotSelection:

רכיב	ריבוי	סוג	תיאור
SequenceOrder	0 או 1	integer	מציין סדר ברירת מחדל לפתקי ההצבעה לתצוגה למטרות. אם הפיד SequenceOrder לא מופיע, המשמעות היא שלא קיימת הזמנה ככל הנראה.

CandidateSelection

אפשר להשתמש ב-CandidateSelection כדי לזהות את פתקי ההצבעה בהצבעה של מועמד תחרות, כולל דיווחים.

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

המאפיינים יורשת את המאפיין CandidateSelection והרכיבים של BallotSelection. הפניות לכמה הפניות ניתן לכלול רכיבי Candidate אם נדרש, לדוגמה, כאשר בחירת ההצבעה היא למספר הצבעה מועמדים בבחירות.

אם בכרטיס מסוים מוזכרים כמה מועמדים, לפעמים חשוב כדי לשמר את סדר המועמדים. במקרים כאלה, אנחנו מצפים ליצירת רשימה של ההפניות Candidate רכיבים בתוך CandidateIds בהתאם לסכימת ההזמנות הקיימת. לדוגמה, הסדר של המועמדים צריך להיות תואם לאותו סדר Office הפניות לרכיבים בתוך OfficeIds בסוג Contest CandidateContest.

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

• כל המתמודדים שערך המדד IsTopTicket שלהם הוא true מקבלים את הסדר לפני כולם מועמדים ללא ערך IsTopTicket. בתורם, הם מסודרים קדימה מכל המועמדים שבהם IsTopTicket הוגדר לערך false. במצב אידיאלי, הבחירה מוגדר עם מועמד אחד ללא ערך IsTopTicket, או הם זוג מועמדים, ובאחד מהם IsTopTicket מוגדר כ-true. זה מה שקורה אם התנאים האלה לא מתקיימים:
  • כל המתמודדים שהגדירו את IsTopTicket לערך true מוצגים במסגרת סדר בלתי מוגדר.
  • כל המועמדים שאין להם IsTopTicket מוצגים במסגרת סדר בלתי מוגדר.
  • כל המתמודדים שהגדירו את IsTopTicket לערך false מוצגים במסגרת סדר בלתי מוגדר.

תחביר ה-XML של CandidateSelection הוא: <BallotSelection xsi:type="CandidateSelection">.

רכיבים

בטבלה הבאה מתוארים הרכיבים של CandidateSelection:

רכיב	ריבוי	סוג	תיאור
CandidateIds	1	IDREFS	מזהה ייחודי של אחד או יותר Candidate רכיבים. משמש לשייך מועמד לבחירת המועמד מופעלת פתק ההצבעה. שימושי גם כאשר בחירת הפתקים היא למספר פתקים מועמדים לנשיאות, למשל כרטיס כניסה לנשיא וסמנכ"ל שנבחרו יחד.
EndorsementPartyIds	0 או יותר	IDREFS	מזהה ייחודי לשניים או יותר Party ישויות. מייצג הסכם שבו המפלגות הפוליטיות מציגות מועמד להצבעה.
IsWriteIn	0 או 1	boolean	מציין אם המועמד נכתב במקומך. ערך ברירת המחדל הוא false

דוגמאות

XML

    <BallotSelection objectId="cs10861" xsi:type="CandidateSelection">
      <CandidateIds>can10861a can10861b</CandidateIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "CandidateSelection",
        "objectId": "cs10861",
        "CandidateIds": [
          "can10861a",
          "can10861b"
        ]
      }
    ]

PartySelection

אפשר להשתמש ב-PartySelection כדי לזהות פתקי הצבעה שקשורים למפלגה, כגון רשימת מפלגות בפתק ההצבעה.

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

PartySelection יורש את המאפיינים והרכיבים של BallotSelection. תחביר ה-XML של PartySelection הוא: <BallotSelection xsi:type="PartySelection" ... />.

רכיבים

בטבלה הבאה מתוארים הרכיבים של PartySelection:

רכיב	ריבוי	סוג	תיאור
PartyIds	1	IDREFS	מזהה ייחודי של אחד או יותר Party רכיבים. משמש לשיוך צד אחד או יותר לגורם בחירה.

דוגמאות

XML

    <BallotSelection objectId="ps150" xsi:type="PartySelection">
      <PartyIds>par100</PartyIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "PartySelection",
        "objectId": "ps150",
        "PartyIds": [
          "par100"
        ]
      }
    ]

BallotMeasureSelection

יש להשתמש ב-BallotMeasureSelection כדי לזהות פתקי הצבעה שכוללים הצעות חוק, כמו משאלי עם.

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

BallotMeasureSelection יורש את המאפיינים והרכיבים של BallotSelection. תחביר ה-XML של BallotMeasureSelection הוא: <BallotSelection xsi:type="BallotMeasureSelection" ... />.

רכיבים

בטבלה הבאה מתוארים הרכיבים של BallotMeasureSelection:

רכיב	ריבוי	סוג	תיאור
ExternalIdentifiers	1	ExternalIdentifiers	משייך תעודה מזהה לתרחיש ההצבעה. א' מזהה יציב הוא שדה חובה.
Selection	1	InternationalizedText	מספקת אפשרות בחירה זמינה לפתקי ההצבעה, למשל Yes או No.

דוגמאות

XML

    <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bmc0_yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "BallotMeasureSelection",
        "objectId": "bms00",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0_yes"
            }
          ]
        }
        "Text": [
          {
            "value": "Yes",
            "language": "en"
          },
        ]
      }
    ]

XML

    <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bmc0_yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "BallotMeasureSelection",
        "objectId": "bms00",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0_yes"
            }
          ]
        }
        "Text": [
          {
            "value": "Yes",
            "language": "en"
          },
        ]
      }
    ]