ספירה

Counts לא נעשה בו שימוש או הפניה אליו באופן ישיר. במקום זאת, הוא משמש רק כבסיס להרחבה של הישויות הבאות:

  • ‫SummaryCounts: משמש לדיווח על ספירת הקולות בסיכום של Contest ויחידה גיאופוליטית (GpUnit).
  • ‫VoteCounts: משמש לדיווח על מספר ההצבעות בContest.

Counts מאפשר לסנן את ספירת הקולות לפי מאפייני המכשיר, או לפי סוג הפתק או ההצבעה החופשית. בנוסף, אפשר לקשר את הספירות לGpUnit ישות מוגדרת, כמו מדינה.

רכיבים

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

רכיב ריבוי סוג תיאור
GpUnitId ‫0 או 1 IDREF מזהה ייחודי של רכיב GpUnit. המאפיין משמש לשיוך של מספרים ליחידה גיאופוליטית, כמו מחוז בחירות, מחוז או עיירה.
IsSuppressedForPrivacy ‫0 או 1 boolean מציין אם הקולות מושבתים כדי לשמור על פרטיות המצביעים. אם המאפיין הזה לא מופיע, ערך ברירת המחדל הוא false.
Type ‫0 או 1 CountItemType

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

אם הסוג של פריט Count לא מופיע ברשימת הערכים של CountItemType, צריך להגדיר את Type כ-other ולכלול את הסוג המותאם אישית ב-OtherType.
OtherType ‫0 או 1 string המאפיין הזה משמש כשערך המאפיין Type הוא other, כדי לציין מה נספר.

SummaryCounts

אפשר להשתמש ב-SummaryCounts כדי לייצג סיכום של מספרים ברמת התחרות או ברמת היחידה הגיאופוליטית.

‫SummaryCounts כולל את Counts כבסיס להרחבה, ולכן הוא יורש את הרכיבים מ-Counts. עם זאת, SummaryCounts הוא לא סוג של Counts, אלא הוא נכלל ישירות ב-Contest וב-GpUnit.

אפשר להשתמש ב-SummaryCounts כדי לספק סיכום של ספירות שונות שקשורות ל-Contest, כמו המספר הכולל של פתקי הצבעה, המספר הכולל של הצבעות מעל המותר, הצבעות מתחת למותר והצבעות למועמדים שלא מופיעים ברשימה. הסיכום הזה מתייחס לכל האזור הגיאוגרפי. ‫SummaryCounts יכול להפנות באופן אופציונלי לרכיבי GpUnit שהוגדרו ליחידות דיווח ברמה נמוכה יותר. כך תוכלו לשייך את סכומי הסיכום ליחידות דיווח אחרות ברמה נמוכה יותר במסגרת התחרות.

אפשר להשתמש ב-SummaryCounts גם כדי לספק סיכום של מספרים שספציפיים ל-GpUnit. לדוגמה, GpUnit שמוגדר למדינה יכול לכלול SummaryCounts כדי לספק סיכום של מספרים. ‫SummaryCounts, במקרה הזה, לא כולל את הרכיב GpUnitId ב-Counts.

ב-Counts, אם סוג הפריט לספירה לא מופיע ברשימת הערכים האפשריים CountItemType, צריך להשתמש ב-other ולכלול את הסוג המותאם אישית ב-OtherType.

רכיבים

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

רכיב ריבוי סוג תיאור
BallotsCast ‫0 או 1 integer מספר הפתקים שהושלכו לקלפי.
BallotsOutstanding ‫0 או 1 integer מספר פתקי ההצבעה שעדיין לא נספרו.
BallotsRejected ‫0 או 1 integer מספר הפתקים שנפסלו.
Overvotes ‫0 או 1 integer מספר ההצבעות בעד.
Undervotes ‫0 או 1 integer מספר ההצבעות החלקיות.
WriteIns ‫0 או 1 integer מספר ההצעות שנוספו.

דוגמאות

XML

    <SummaryCounts>
      <BallotsCast>2089540</BallotsCast>
      <WriteIns>2087</WriteIns>
    </SummaryCounts>

JSON

    "SummaryCounts": [
      {
        "BallotsCast": "2089540",
        "WriteIns": "2087"
      }
    ]

VoteCounts

משתמשים בVoteCounts כדי לתאר את מספר הקולות של BallotSelection בContest.

רכיבים

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

רכיב ריבוי סוג תיאור
Count ‫0 או 1 float

מספר ההצבעות בתחרות, כמספר בין 0 ל-100. במקרים מיוחדים, המספר יכול לכלול רכיב חלקי. לדוגמה, אם רוצים לדווח על 14.2%, צריך להזין 14.2 ולא 0.142.

במאמר סוגים של טבלאות תוצאות תוכלו למצוא רשימה של סוגי ספירת הקולות הנתמכים.

דוגמאות

XML

    <VoteCounts>
      <GpUnitId>ru_001</GpUnitId>
      <Type>total</Type>
      <Count>6173433</Count>
    </VoteCounts>
    <VoteCounts>
      <GpUnitId>ru_001</GpUnitId>
      <Type>other</Type>
      <OtherType>projected-vote-percent</OtherType>
      <Count>22.3</Count>
    </VoteCounts>

JSON

    "VoteCounts": [
      {
        "GpUnitId": "ru_001",
        "Type": "total",
        "Count": "6173433"
      },
      {
        "GpUnitId": "ru_001",
        "Type": "other",
        "OtherType": "projected-vote-percent",
        "Count": "22.3"
      }
    ]