تقرير انتخابي

استخدِم ElectionReport ككيان جذري. ويحدّد هذا القسم العناصر ذات الصلة بحالة التقرير وتنسيقه وتاريخ إنشائه.

يتضمّن ElectionReport العناصر الرئيسية التالية:

كما هو الحال مع Election، يلتف ElectionReport حول مواضع ورود العناصر، باستثناء Election، في عناصر الحاوية. يسهّل ذلك التعامل مع ملفات المثيلات في عارضات ومحرّرات تنسيق XML.

في بعض الأحيان، من المهم الحفاظ على ترتيب معيّن للعناصر، مثل المكاتب أو الأحزاب السياسية. في هذه الحالات، نتوقّع أن يحدّد التطبيق الذي ينشئ هذه العناصر ترتيبها وفقًا لأي نظام ترتيب معمول به.

العناصر

يسرد الجدول التالي عناصر ElectionReport:

العنصر	التعددية	النوع	الوصف
`CommitteeCollection`	0 أو 1	لا ينطبق	عنصر برنامج تضمين لتعريفات `Committee` لمزيد من التفاصيل، يُرجى الاطّلاع على كيانات المجموعة.
`DataSourceCollection`	0 أو 1	لا ينطبق	عنصر برنامج تضمين لتعريفات `DataSource` لمزيد من التفاصيل، يُرجى الاطّلاع على كيانات المجموعة.
`Election`	‫0 أو أكثر	`Election`	ربط الانتخابات بالتقرير
`ElectoralCommissionCollection`	0 أو 1	لا ينطبق	عنصر برنامج تضمين لتعريفات `ElectoralCommission` لمزيد من التفاصيل، يُرجى الاطّلاع على كيانات المجموعة.
`ExternalIdentifiers`	0 أو 1	`ExternalIdentifiers`	يربط هذا الحقل رقم تعريف بالتقرير.
`Format`	1	`ReportDetailLevel`	تمثّل هذه السمة مستوى التفاصيل في التقرير، مثل ما إذا كان ملخّصًا للمسابقة أو نتائج على مستوى الدائرة الانتخابية.
`GeneratedDate`	1	`dateTime`	تحدّد هذه السمة تاريخ ووقت إنشاء تقرير الانتخابات.
`GpUnitCollection`	0 أو 1	لا ينطبق	عنصر برنامج تضمين لتعريفات `GpUnit` لمزيد من التفاصيل، يُرجى الاطّلاع على كيانات المجموعة.
`Issuer`	1	`string`	تحديد هوية الجهة التي أصدرت التقرير
`IssuerAbbreviation`	0 أو 1	`string`	اختصار لجهة إصدار التقرير، مثل اختصار للولاية أو الدائرة الانتخابية التي يتم إعداد التقارير بشأن نتائجها
`IsTest`	0 أو 1	`boolean`	تحدّد هذه السمة ما إذا كان التقرير تقريرًا اختباريًا. إذا لم يكن هذا العنصر متوفّرًا، ستكون القيمة التلقائية هي `false`.
`Notes`	0 أو 1	`string`	يُستخدَم لتضمين رسالة عشوائية مع التقرير.
`OfficeCollection`	0 أو 1	لا ينطبق	عنصر برنامج تضمين لتعريفات `Office` لمزيد من التفاصيل، يُرجى الاطّلاع على كيانات المجموعة.
`GovernmentBodyCollection`	0 أو 1	لا ينطبق	عنصر برنامج تضمين لتعريفات `GovernmentBody` لمزيد من التفاصيل، يُرجى الاطّلاع على كيانات المجموعة.
`PartyCollection`	0 أو 1	لا ينطبق	عنصر برنامج تضمين لتعريفات `Party` لمزيد من التفاصيل، يُرجى الاطّلاع على كيانات المجموعة.
`PersonCollection`	0 أو 1	لا ينطبق	عنصر برنامج تضمين لتعريفات `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	لا ينطبق	عنصر برنامج تضمين لتعريفات `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
    }