משתמשים ב-ElectionReport כישות שורש. הוא מגדיר פריטים שקשורים לסטטוס ולפורמט של הדוח, ולמועד שבו הוא נוצר.
ElectionReport כולל את הרכיבים העיקריים הבאים:
בדומה ל-Election, התג ElectionReport 'עוטף' מופעים של הרכיבים, למעט Election, ברכיבי קונטיינר. כך קל יותר לתפעל את קובצי המופע בעורכי XML ובכלי צפייה בקובצי XML.
לפעמים חשוב לשמור על סדר מסוים של פריטים, כמו משרדים או מפלגות. במקרים כאלה, אנחנו מצפים שהאפליקציה שיוצרת את הרכיבים האלה תגדיר אותם בהתאם לכל תוכנית הזמנות שכבר קיימת.
רכיבים
בטבלה הבאה מפורטים רכיבים של ElectionReport:
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
CommitteeCollection |
0 או 1 | לא רלוונטי | רכיב wrapper עבור
הגדרות Committee. פרטים נוספים זמינים במאמר בנושא יחידות של אוספים. |
DataSourceCollection |
0 או 1 | לא רלוונטי | רכיב wrapper עבור
הגדרות DataSource. פרטים נוספים זמינים במאמר בנושא יחידות של אוספים.
|
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 |
0 או 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"> <DataSourceCollection> <DataSource objectId="ds1">…</DataSource> </DataSourceCollection> <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", "DataSourceCollection": { "DataSource": [ { "objectId": "ds1", ... } ] }, "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 }