דוח בחירות

משתמשים ב-ElectionReport בתור הישות ברמה הבסיסית (root). הוא מגדיר פריטים שקשורים למצב ולפורמט של הדוח, ולתאריך שבו הוא נוצר.

ElectionReport כולל את הרכיבים העיקריים הבאים:

בדומה ל-Election, הרכיב ElectionReport 'עוטף' את המופעים של הרכיבים, מלבד Election, ברכיבי מאגר. כך קל יותר לבצע פעולות בקובצי המכונות בתוכנות לצפייה ולעריכה של קובצי XML.

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

רכיבים

בטבלה הבאה מפורטים הרכיבים של ElectionReport:

רכיב ריבוי סוג תיאור
CommitteeCollection 0 או 1 לא רלוונטי רכיב wrapper להגדרות של Committee. לפרטים נוספים, ראו ישויות אוסף.
Election 0 או יותר Election משייך את הבחירות לדוח.
ElectoralCommissionCollection 0 או 1 לא רלוונטי רכיב wrapper להגדרות של ElectoralCommission. לפרטים נוספים, ראו ישויות אוסף.
ExternalIdentifiers 0 או 1 ExternalIdentifiers משייך מזהה לדוח.
Format 1 ReportDetailLevel רמת הפירוט של הדוח, למשל אם מדובר בסיכום של תחרות או בתוצאות ברמת התחנה.
GeneratedDate 1 dateTime מזהה את התאריך והשעה שבהם נוצר דוח הבחירות.
GpUnitCollection 0 או 1 לא רלוונטי רכיב wrapper להגדרות של GpUnit. לפרטים נוספים, ראו ישויות אוסף.
Issuer 1 string זיהוי של המנפיק של הדוח.
IssuerAbbreviation 1 string קיצור שם של המנפיק של הדוח, למשל קיצור של המדינה או המחוז עליהם מדווחים.
IsTest 0 או 1 boolean מציין אם הדוח הוא דוח בדיקה. אם הרכיב הזה לא נמצא, ערך ברירת המחדל הוא false.
Notes 0 או 1 string משמש להוספת הודעה שרירותית לדוח.
OfficeCollection 0 או 1 לא רלוונטי רכיב wrapper להגדרות של Office. לפרטים נוספים, ראו ישויות אוסף.
GovernmentBodyCollection 0 או 1 לא רלוונטי רכיב wrapper להגדרות של GovernmentBody. לפרטים נוספים, ראו ישויות אוסף.
PartyCollection 0 או 1 לא רלוונטי רכיב wrapper להגדרות של Party. לפרטים נוספים, ראו ישויות אוסף.
PersonCollection 0 או 1 לא רלוונטי רכיב wrapper להגדרות של Person. לפרטים נוספים, ראו ישויות אוסף.
SequenceStart 1 integer מספר הדוח כחלק מרצף של דוחות. הרכיב הזה משמש עם SequenceEnd כדי להקליט, לדוגמה, '1 מתוך 1', '1 מתוך 2' או '2 מתוך 2'. מתחיל ב-1.
SequenceEnd 1 integer הגבול העליון של רצף דוחות. לדוגמה, הערך הוא 1 אם יש רק דוח אחד, או 2 אם יש שני דוחות ברצף.
Status 1 ResultsStatus הסטטוס של דוח הבחירות, למשל 'לפני הבחירות' או 'לא רשמי'.
TestType 0 או 1 string תיאור של סוג הבדיקה, למשל לפני בחירות או לוגיקה ודיוק.
VendorApplicationID 1 string מזהה של אפליקציית הספק שיוצרת את דוח הבחירות. לדוגמה, X-EMS version 3.1.a.
VoterInformationCollection 0 או 1 לא רלוונטי רכיב wrapper להגדרות של VoterInformation. לפרטים נוספים, ראו ישויות אוסף.

דוגמאות

XML

    <ElectionReport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <Election>…</Election>
      <GpUnitCollection>
        <GpUnit objectId="ru-gpu0">…</GpUnit>
        <GpUnit objectId="ru-gpu1">…</GpUnit>
      </GpUnitCollection>
      <OfficeCollection>
        <Office objectId="off0001a">…</Office>
      </OfficeCollection>
      <GovernmentBodyCollection>
        <GovernmentBody objectId="gov0001a">…</GovernmentBody>
      </GovernmentBodyCollection>
      <PartyCollection>
        <Party objectId="par001">…</Party>
        <Party objectId="par002">…</Party>
      </PartyCollection>
      <PersonCollection>
        <Person objectId="per001">…</Person>
        <Person objectId="per002">…</Person>
      </PersonCollection>
      <Issuer>Example Data Provider</Issuer>
      <IssuerAbbreviation>EDP</IssuerAbbreviation>
      <Format>summary-contest</Format>
      <GeneratedDate>2013-11-05T14:25:28</GeneratedDate>
      <Status>unofficial-partial</Status>
      <VendorApplicationId>Hand-Generated v0.1</VendorApplicationId>
      <SequenceStart>1</SequenceStart>
      <SequenceEnd>1</SequenceEnd>
    </ElectionReport>

JSON

    {
      "@type": "ElectionReport",
      "Election": [
        ...
      ],
      "GpUnitCollection": {
        "GpUnit": [
          {...},
          {...}
        ]
      },
      "OfficeCollection": {
        "Office": [
          {
            "objectId": "off0001a",
            ...
          }
        ]
      },
      "PartyCollection": {
        "Party": [
          {
            "objectId": "par001",
            ...
          },
          {
            "objectId": "par002",
            ...
          }
        ]
      },
      "PersonCollection": {
        "Person": [
          {
            "objectId": "per001",
            ...
          },
          {
            "objectId": "per002",
            ...
          }
        ]
      },
      "Issuer": "Example Data Provider",
      "IssuerAbbreviation": "EDP",
      "Format": "summary-contest",
      'GeneratedDate": "2013-11-05T14:25:28",
      "Status": "unofficial-partial",
      "VendorApplicationId": "Hand-Generated v0.1",
      "SequenceStart": 1,
      "SequenceEnd": 1
    }