Licznik

Element Counts nie jest używany ani nie odwołuje się bezpośrednio do niego. Jest używany tylko jako podstawa rozszerzeń w tych elementach:

  • SummaryCounts: służy do generowania raportów o liczbie głosów oddanych w podsumowaniu głosów w Contest i jednostce geopolitycznej (GpUnit).
  • VoteCounts: służy do raportowania liczby głosów oddanych przez Contest.

Counts pozwala filtrować liczbę głosów według cech urządzenia lub typu karty do głosowania lub wpisu. Dzięki temu możesz też powiązać liczby ze zdefiniowanym elementem GpUnit, np. z krajem.

Elementy

Poniższa tabela zawiera opis elementów Counts:

Element Mnogość Typ Opis
GpUnitId 0 lub 1 IDREF Unikalny identyfikator elementu GpUnit. Służy do powiązania liczb z jednostką geopolityczną, taką jak okręg, hrabstwo lub powiat.
IsSuppressedForPrivacy 0 lub 1 boolean Wskazuje, czy głosy są pomijane ze względu na prywatność wyborców. Jeśli ta wartość nie jest podana, przyjmuje się wartość domyślną false.
Type 0 lub 1 CountItemType

Rodzaj używany do filtrowania liczby głosów, np. dzień wyborów lub wczesne głosowanie.

Jeśli typu elementu Count nie ma w wyliczeniu CountItemType, ustaw Type na other i uwzględnij typ niestandardowy w OtherType.
OtherType 0 lub 1 string Używana, gdy Type ma wartość other, aby określić, co ma być liczone.

SummaryCounts

Użyj pola SummaryCounts, aby przedstawić sumy obejmujące cały konkurs lub dane geopolityczne w całej jednostce.

SummaryCounts obejmuje Counts jako podstawę rozszerzenia i dlatego dziedziczy elementy z Counts. SummaryCounts nie jest jednak typem Counts. Zamiast tego jest uwzględniany bezpośrednio w przypadku Contest i GpUnit.

SummaryCounts może zawierać geograficzne podsumowanie różnych liczb powiązanych z elementem Contest, takich jak łączna liczba oddanych głosów, łączna liczba nadmiarowych głosów, zagłosów i dodanych głosów. SummaryCounts może opcjonalnie odwoływać się do elementów GpUnit zdefiniowanych na potrzeby jednostek raportowania niższego poziomu. Pozwala to powiązać liczniki podsumowujące z innymi jednostkami raportowania niższym poziomu w zakresie konkursu.

Za pomocą funkcji SummaryCounts można też podać zbiorcze liczby charakterystyczne dla obiektu GpUnit. Na przykład właściwość GpUnit określona dla kraju może zawierać parametr SummaryCounts, aby wyświetlić łączną liczbę. SummaryCounts w tym przypadku nie zawiera elementu GpUnitId w elemencie Counts.

Jeśli w funkcji Counts typ elementu „liczba” nie jest wymieniony w wyliczeniu CountItemType, użyj other i uwzględnij typ niestandardowy w OtherType.

Elementy

Poniższa tabela zawiera opis elementów SummaryCounts:

Element Mnogość Typ Opis
BallotsCast 0 lub 1 integer Liczba oddanych głosów.
BallotsOutstanding 0 lub 1 integer Liczba kart do głosowania nie została jeszcze policzona.
BallotsRejected 0 lub 1 integer Liczba odrzuconych kart do głosowania.
Overvotes 0 lub 1 integer Liczba nadmiarowych głosów.
Undervotes 0 lub 1 integer Liczba głosów za.
WriteIns 0 lub 1 integer Liczba zapisów.

Przykłady

XML

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

JSON

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

VoteCounts

Użyj funkcji VoteCounts, by opisać liczbę głosów dla użytkownika BallotSelection w: Contest.

Elementy

Poniższa tabela zawiera opis elementów VoteCounts:

Element Mnogość Typ Opis
Count 0 lub 1 float

Liczba oddanych głosów w konkursie, podana jako liczba od 0 do 100. W szczególnych przypadkach liczba może zawierać komponent ułamkowy. Na przykład podaj 14,2% jako 14.2, a nie 0,142.

Listę obsługiwanych typów liczb głosów znajdziesz w artykule Typy tabel wyników.

Przykłady

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"
      }
    ]