Konkurs

Użyj typu Contest, aby opisać konkurs i połączyć go z odpowiednimi kandydatami i partiami.

W tym dokumencie omawiamy Contest i jego podmioty:

• Contest
  • CandidateContest
  • PartyContest
  • BallotMeasureContest
  • RetentionContest

Uwaga: ta encja jest taka sama w przypadku danych przedwyborczych i rodzajów plików danych z wynikami wyborów. Nie jest używany w przypadku plików danych o osobach pełniących funkcje publiczne.

Typy

Contest to element abstrakcyjny, który ma 3 typy używane w zależności od rodzaju konkursu:

• CandidateContest: użyj tego typu, gdy Contest dotyczy jednego lub większej liczby kandydatów na stanowisko.
• PartyContest: użyj tego typu, gdy Contest ma na karcie do głosowania listę kandydatów z. Może to być też wirtualny konkurs, który jest podsumowaniem większego zestawu mniejszych konkursów.
• BallotMeasureContest: użyj tego typu, gdy Contest obejmuje co najmniej 1 propozycję głosowania.
• RetentionContest: użyj tego typu, gdy Contest dotyczy referendum, w którym wyborcy decydują, czy wybrany urzędnik powinien pozostać na stanowisku, czy zostać z niego odwołany.

W miarę publikowania wyników wyborów możesz aktualizować plik danych, aby wyświetlać różne etapy wyników, np. sondaże exit poll lub szacunki. Google podaje wskazówki dotyczące etapów wyborów i rodzajów wyników, których się spodziewamy. Google może poprosić o przeprowadzenie 1 lub kilku etapów. Wartości te mogą ulec zmianie podczas wieczoru wyborczego. Ustaw początkową wartość pliku danych na etap, od którego chcesz zacząć. Więcej informacji znajdziesz ExternalIdentifiers w sekcji Elementy.

Atrybuty

W tabeli poniżej opisano atrybuty Contest:

Atrybut	Wymagany?	Typ	Opis
objectId	Wymagane	ID	Unikalny identyfikator wewnętrzny używany przez inne elementy do odwoływania się do tego elementu.

Elementy

W tabeli poniżej opisano elementy Contest:

Element	Mnogość	Typ	Opis
Abbreviation	0 lub 1	string	Krótka nazwa konkursu.
AggregateBallotSelection	0 lub 1	SpecialBallotSelection	Wybór kart do głosowania na potrzeby agregacji liczby głosów, np. agregowanie głosów oddanych na wielu kandydatów w kategorii „Inni”.
BallotSelection	0 lub więcej	BallotSelection	Powiązanie wyborów na karcie do głosowania z wyborami. Kolejność kandydatów lub partii w Contest musi być taka sama jak w BallotSelection. Jeśli atrybut BallotSelection.SequenceOrder jest obecny w przypadku każdego produktu, jest on używany jako domyślna kolejność wyborów.
BallotSubTitle	0 lub 1	InternationalizedText	Podtytuł wyborów, który musi być zgodny z tym, jak pojawia się na kartach do głosowania.
BallotTitle	0 lub 1	InternationalizedText	Tytuł konkursu. Tekst tytułu powinien być zgodny z przewodnikiem po składni. W przypadku konkursów dotyczących głosowania w referendum tytuł powinien być zgodny z treścią pytania na karcie do głosowania.
BlankBallotSelection	0 lub 1	SpecialBallotSelection	Wybór kart do głosowania w przypadku pustych kart.
ComposingContestIds	0 lub więcej	IDREFS	Służy do definiowania konkursu zbiorczego. Na przykład w powszechnych wyborach prezydenckich w Stanach Zjednoczonych odbywają się wybory na poziomie krajowym, które składają się z wyborów na poziomie stanowym. Każde z nich ma swój identyfikator. ComposingContest musi mieć mniejszy zakres niż konkurs nadrzędny i odbywać się w tej samej rundzie wyborów.
ContestDateStatus	0 lub 1	DateStatus	Ten element wskazuje aktualizacje harmonogramu wyborów. Wartością domyślną jest confirmed. W większości przypadków najlepiej, aby wartości ContestDateStatus były zgodne z ElectionDateStatus elementu Election, który je zawiera.
CountingDate	0 lub 1	PartialDate	Data po głosowaniu, w której odbywa się liczenie głosów w wyborach. Należy to uwzględnić tylko wtedy, gdy dzień zliczania różni się od ostatniego dnia głosowania, np. w przypadku wyborów do indyjskiej Lok Sabhy. Zwykle liczenie głosów odbywa się tego samego dnia co ostatni dzień głosowania, czyli w EndDate wyborów. Uwaga: jeśli ten atrybut jest ustawiony, data musi być późniejsza niż EndDate.
CurrentResultsReportingStage	1	ResultsReportingStageType	Obecny etap raportowania wyników konkursu.
EarliestPollsClose	0 lub 1	dateTime	Kiedy zamykają się pierwsze lokale wyborcze. Konkursy na kompozycje będą dziedziczyć tę wartość z konkursu nadrzędnego, jeśli nie jest ona obecna.
ElectoralDistrictId	1	IDREF	Unikalny identyfikator elementu GpUnit. Łączy konkurs z jednostką raportowania, która reprezentuje zasięg geograficzny konkursu, np. okręg. Na przykład w przypadku konkretnego konkursu ElectoralDistrictId może odwoływać się do ReportingUnit zdefiniowanego dla okręgu powiązanego z konkursem. Office zawiera też opcjonalne odwołanie, które służy temu samemu celowi. Na przykład w przypadku konkursu krajowego możesz ponownie użyć tego samego GpUnit, który jest zdefiniowany dla danego kraju.
ExternalIdentifiers	1	ExternalIdentifiers	Powiązanie identyfikatora z konkursem. Wymagany jest stabilny identyfikator. Aby podać etap wyników wyborów, który jest raportowany przez Twój plik danych, ustaw OtherType na wartość z ContestStage.
EndDate	0 lub 1	PartialDate	Data zakończenia konkursu w kalendarzu. Użyj daty zakończenia głosowania, np. 2022-11-08. Datę zakończenia należy ustawić tylko wtedy, gdy data rozpoczęcia i zakończenia Contest różni się od daty rozpoczęcia i zakończenia Election. Uwaga: jeśli ten atrybut jest ustawiony, musi być też ustawiony atrybut StartDate. Każdy element EndDate musi mieć odpowiadający mu element StartDate.
FilingDeadline	0 lub 1	PartialDate	Data, do której kandydat musi zgłosić się do konkursu.
HasRotation	0 lub 1	boolean	Wskazuje, czy wybory w konkursie są rotowane. Jeśli ten element nie jest obecny, domyślna wartość to false.
IsNotable	0 lub 1	boolean	Czy jednostka jest uważana za godną uwagi. Jeśli nie zostanie podana, przyjmuje wartość false. Uwaga: jest to decyzja redakcyjna, którą podejmują dostawcy danych, aby określić, co w danych wyborach jest warte uwagi.
LatestPollsClose	0 lub 1	dateTime	Kiedy zamykają się ostatnie lokale wyborcze. Konkursy na kompozycje będą dziedziczyć tę wartość z konkursu nadrzędnego, jeśli nie jest ona obecna.
Name	1	string	Musi być zgodny z elementem BallotTitle w języku angielskim i odpowiadać składni tytułu.
NoneOfTheAboveBallotSelection	0 lub 1	SpecialBallotSelection	Wybór na karcie do głosowania opcji „Żadne z powyższych” lub podobnej, np. „Żadne”, „Żadne z tych” lub „Nieokreślone”.
NullBallotSelection	0 lub 1	SpecialBallotSelection	Wybór kart do głosowania, które są nieważne lub zniszczone. Są to karty do głosowania, które zostały oznaczone w taki sposób, że głosu nie można prawidłowo policzyć. Przykłady nieważnych kart do głosowania to karty, które zostały podarte, zabrudzone, nadmiernie lub niedostatecznie oznaczone albo oznaczone w sposób umożliwiający identyfikację głosującego.
Seat	0 lub 1	string	konkretne miejsce, o które toczy się konkurs;
SequenceOrder	0 lub 1	integer	Domyślna kolejność elementów Contest na potrzeby wyświetlania wyników. Konkursy są wyświetlane zgodnie z tymi regułami: Jeśli 2 konkursy mają identyczne wartości, mogą być prezentowane w nieokreślonej kolejności. Wszystkie konkursy z symbolem SequenceOrder są wyświetlane w tej kolejności, a potem wszystkie konkursy bez wartości SequenceOrder w nieokreślonej kolejności. SequenceOrder służy do określania kolejności wyświetlanych wyników. Na przykład 100 może oznaczać konkurs regionalny, 200 – konkurs lokalny itd. SequenceOrder nie nadaje się do użycia jako kolejność konkursów na karcie do głosowania; kolejność konkursów na każdej karcie do głosowania można zachować, używając jednak elementu BallotStyle, który łączy style kart do głosowania z odpowiednimi jednostkami geopolitycznymi.
StartDate	0 lub 1	PartialDate	Data rozpoczęcia konkursu w kalendarzu. Użyj daty rozpoczęcia głosowania, np. 2022-11-08. Datę rozpoczęcia należy ustawić tylko wtedy, gdy data rozpoczęcia i zakończenia Contest różni się od daty rozpoczęcia i zakończenia Election. Uwaga: jeśli ten atrybut jest ustawiony, musi być też ustawiony atrybut EndDate. Każdy element StartDate musi mieć odpowiadający mu element EndDate.
SubsequentContestId	0 lub 1	IDREF	Służy do wskazywania późniejszego konkursu w tym samym powiązanym zestawie. Na przykład w przypadku wyborów w Stanach Zjednoczonych zwykle wskazuje od prawyborów do powiązanych z nimi wyborów powszechnych. Może też wskazywać wybory powszechne jako źródło wyborów uzupełniających. SubsequentContest ma zwykle taki sam zakres jak poprzedni konkurs.
SubUnitsReported	0 lub 1	integer	Liczba podjednostek, np. okręgów wyborczych, które zakończyły zgłaszanie głosów w tym konkursie.
SummaryCounts	0 lub więcej	SummaryCounts	Zawiera podsumowanie różnych liczb związanych z konkursem. Obejmuje to łączną liczbę oddanych głosów, które zawierają wybory, oraz łączną liczbę głosów wstrzymujących się, głosów oddanych na więcej niż 1 kandydata, głosów oddanych na mniej niż 1 kandydata lub głosów oddanych na kandydata, którego nie ma na liście. Podsumowania można powiązać z konkursem jako całością lub z innymi jednostkami raportowania niższego poziomu, używając wielokrotnie elementu SummaryCounts.
TotalSeats	0 lub 1	integer	Łączna liczba miejsc, które okręg wyborczy w tych wyborach może obsadzić w danym urzędzie. Jest to równoznaczne z liczbą miejsc do zdobycia + miejsc przeniesionych + wolnych miejsc.
TotalSubUnits	0 lub 1	integer	Łączna liczba podjednostek, np. okręgów wyborczych, w których w głosowaniu występuje ten konkurs.
VoteVariation	0 lub 1	VoteVariation	Rodzaj wariantu głosowania powiązanego z konkursem, np. n-of-m.
OtherVoteVariation	0 lub 1	string	Służy do podawania wartości niestandardowej, gdy warunek VoteVariation jest other.
ResultsEmbargoEnd	0 lub 1	dateTime	Gdy skończy się embargo na publikowanie wyników wyborów. Konkursy na kompozycje będą dziedziczyć tę wartość z konkursu nadrzędnego, jeśli nie jest ona w nich obecna.
ResultsExpected	0 lub 1	dateTime	Kiedy w kanale mają się pojawić pierwsze wyniki liczenia głosów. Konkursy na kompozycje będą dziedziczyć tę wartość z konkursu nadrzędnego, jeśli nie jest ona obecna.
ResultsReportingStageCollection	0 lub 1	Nie dotyczy	Element opakowujący definicje ResultsReportingStage. Więcej informacji znajdziesz w artykule Podmioty zbierające.

CandidateContest

Używaj typu CandidateContest do opisu konkursu, w którym wybiera się co najmniej jednego kandydata.

Uwaga: ta encja jest taka sama w przypadku danych przedwyborczych i rodzajów plików danych z wynikami wyborów. Nie jest używany w przypadku plików danych o osobach pełniących funkcje publiczne.

Ten podmiot może opcjonalnie odwoływać się do Office lub Party według identyfikatora. Nie obsługujemy reprezentacji listy kandydatów w tym samym konkursie. Możesz odwoływać się tylko do jednego elementu Office. Na przykład w przypadku kandydatów na prezydenta i wiceprezydenta potrzebne będą 2 Candidate konkursy. Każdy z nich odnosiłby się do innego biura.

Elementy

W tabeli poniżej opisano elementy CandidateContest:

Element	Mnogość	Typ	Opis
NumberElected	0 lub 1	integer	Liczba kandydatów wybranych w konkursie, czyli n w konkursie typu n-of-m. Jeśli w pliku danych nie ma atrybutu NumberElected, używana jest wartość domyślna 1.
OfficeIds	1	IDREFS	Unikalny identyfikator co najmniej jednego elementu Office. Łączy opis biura z konkursem.
PrimaryPartyIds	0 lub więcej	IDREFS	Unikalny identyfikator co najmniej jednego elementu Party, który wskazuje, że Contest jest częścią prawyborów partyjnych. PrimaryPartyId ma znaczenie tylko w prawyborach.
VotesAllowed	1	integer	Maksymalna liczba głosów lub dopisków dozwolonych na wyborcę w tym konkursie. Jeśli w pliku danych nie ma atrybutu VotesAllowed, używana jest wartość domyślna 1.
Type	0 lub więcej	ElectionType	Typ wyborów, np. prawybory lub wybory powszechne. Typ Contest należy ustawić tylko wtedy, gdy różni się od typu Election.

Przykłady

XML

    <Contest xsi:type="CandidateContest" objectId="c-1-001">
      <Abbreviation>KENYAPRES</Abbreviation>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kenyatta">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-odinga">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-mudavadi">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kenneth">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-dida">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-karua">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kiyiapi">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-muite">...</BallotSelection>
      <BallotTitle>
        <Text language="en">2022 Kenya Presidential election</Text>
        <Text language="es">2022 Elecciones presidenciales de Kenia</Text>
        <Text language="fr">2022 Élection présidentielle au Kenya</Text>
      </BallotTitle>
      <CountStatus>...</CountStatus>
      <CountingDate>2022-08-11</CountingDate>
      <ElectoralDistrictId>...</ElectoralDistrictId>
      <EndDate>2022-08-09</EndDate>
      <Name>2022 Kenya Presidential election</Name>
      <StartDate>2022-08-09</StartDate>
      <SubUnitsReported>48</SubUnitsReported>
      <SummaryCounts>...</SummaryCounts>
      <TotalSubUnits>48</TotalSubUnits>
      <VoteVariation>1-of-m</VoteVariation>
      <NumberElected>1</NumberElected>
      <OfficeIds>off-9999a</OfficeIds>
      <VotesAllowed>1</VotesAllowed>
      <Type>general</Type>
    </Contest>

PartyContest

Użyj PartyContest w przypadku konkursu, w którym głosujący wybierają partię na karcie do głosowania. Można go też używać w pliku danych z wynikami wyborów jako wirtualnego podsumowania wyborów, aby przekazywać zagregowane dane (np. wybory na poziomie stanu, w których uczestniczą partie i które agregują wyniki wyborów w okręgach).

Uwaga: ta encja jest taka sama w przypadku danych przedwyborczych i rodzajów plików danych z wynikami wyborów. Nie jest używany w przypadku plików danych o osobach pełniących funkcje publiczne.

Elementy

W tabeli poniżej opisano elementy PartyContest:

Element	Mnogość	Typ	Opis
NumberElected	0 lub 1	integer	Liczba kandydatów wybranych w konkursie, czyli n w konkursie typu n-of-m. Jeśli w pliku danych nie ma atrybutu NumberElected, używana jest wartość domyślna 1.
VotesAllowed	0 lub 1	integer	Maksymalna liczba głosów lub dopisków dozwolonych na wyborcę w tym konkursie. Jeśli w pliku danych nie ma atrybutu VotesAllowed, używana jest wartość domyślna 1.
OfficeIds	1	IDREFS	Unikalny identyfikator co najmniej jednego elementu Office. Łączy opis biura z konkursem.
Type	0 lub więcej	ElectionType	Typ wyborów, np. prawybory lub wybory powszechne. Typ Contest należy ustawić tylko wtedy, gdy różni się od typu Election.

Przykłady

XML

    <Contest xsi:type="PartyContest" objectId="c-20001">
      <BallotSelection objectId="ps-101321" xsi:type="PartySelection">
        <PartyIds>par-10132</PartyIds>
      </BallotSelection>
      <BallotSelection objectId="ps-101322" xsi:type="PartySelection">
        <PartyIds>par-10133</PartyIds>
      </BallotSelection>
      <BallotTitle>
        <Text language="en">Ballot title example</Text>
      </BallotTitle>
      <ContestDateStatus>confirmed</ContestDateStatus>
      <CountingDate>2022-08-11</CountingDate>
      <ElectoralDistrictId>...</ElectoralDistrictId>
      <EndDate>2022-08-09</EndDate>
      <ExternalIdentifiers>...</ExternalIdentifiers>
      <Name>Contest name example</Name>
      <StartDate>2022-08-09</StartDate>
      <VoteVariation>1-of-m</VoteVariation>
      <OfficeIds>off-9999a</OfficeIds>
      <Type>general</Type>
      <VotesAllowed>1</VotesAllowed>
    </Contest>

BallotMeasureContest

Użyj ikony BallotMeasureContest w przypadku konkursu, który obejmuje głosowanie.

Uwaga: ta encja jest taka sama w przypadku danych przedwyborczych i rodzajów plików danych z wynikami wyborów. Nie jest używany w przypadku plików danych o osobach pełniących funkcje publiczne.

Elementy

W tabeli poniżej opisano elementy BallotMeasureContest:

Element	Mnogość	Typ	Opis
BallotTitle	1	InternationalizedText	Oficjalny tytuł karty do głosowania, np. Nevada Renewable Energy Standards Initiative. Upewnij się, że BallotTitle jest unikalny. Niektóre referenda mają jeden zbiorczy tytuł z wieloma ponumerowanymi pytaniami. W takich przypadkach tytuł może zawierać numer pytania, aby odróżnić BallotMeasureContest jednostki utworzone dla każdego pytania.
BallotSubTitle	0 lub 1	InternationalizedText	Podtytuł karty do głosowania, jeśli taki istnieje.
BallotText	1	InternationalizedText	Tekst, który pojawia się na karcie do głosowania. Na przykład: Shall Article 4 of the Nevada Constitution be amended to require, beginning in calendar year 2022, that all providers of electric utility services who sell electricity... in Nevada comes from renewable energy resources?
FullText	0 lub 1	InternationalizedText	Kopia pełnego tekstu środka do głosowania. Podaj ten element, jeśli jest dodatkowy tekst, który nie jest uwzględniony na karcie do głosowania. Limit: 30 000 znaków. Jeśli pełny tekst propozycji jest krótszy niż 30 000 znaków i nie zawiera formatowania,które byłoby nieprawidłowe w pliku danych, umieść go w polu FullText. Dodaj też element InfoUri z adnotacją URI fulltext. W przeciwnym razie podaj tylko identyfikator URI z adnotacją fulltext.
InfoUri	0 lub 1	AnnotatedUri	Adnotowany identyfikator URI, który akceptuje te adnotacje, a nie adnotacje wymienione w innych miejscach: wikipedia: strona w Wikipedii na temat głosowania; ballotpedia: strona Ballotpedia dotycząca głosowania. Na przykład https://ballotpedia.org/Nevada_Renewable_Energy_Standards_Initiative_(2020) official-website: oficjalna strona internetowa dotycząca głosowania nad środkiem, fulltext: jeśli tekst jest dłuższy niż ten na karcie do głosowania, np. kopia proponowanego prawa, jest to URI do pełnego tekstu dodatkowego. Oto przykład:https://www.nvsos.gov/sos/home/showdocument?id=5330 logo-uri: obraz logo
SummaryText	0 lub 1	InternationalizedText	Streszczenie propozycji ustawodawczej. Składa się z 1–2 krótkich akapitów i może być generowany przez partnera w celu podsumowania pełnego tekstu karty do głosowania, jak w tym przykładzie: Requires utilities to acquire 50 percent of their electricity from renewable resources by 2030 Official Summary: EXPLANATION—This ballot measure proposes to amend Article 4 of the Nevada Constitution to require all providers of electric utility services that sell electricity to retail customers for consumption in Nevada to meet a Renewable Portfolio Standard (RPS) that would go into effect beginning in calendar year 2022 and increase gradually until the RPS reaches 50 percent in calendar year 2030. According to the Public Utilities Commission of Nevada, an RPS establishes the percentage of electricity sold by an electric utility to retail customers that must come from renewable sources.
ProStatement	0 lub 1	InternationalizedText	Oświadczenie wyjaśniające, co oznacza głos Tak w przypadku tego środka na karcie do głosowania. Nie jest to argument przemawiający za tym środkiem. Na przykład: A "yes" vote supports this initiative to require electric utilities to acquire 50 percent of their electricity from renewable resources by 2030.
ConStatement	0 lub 1	InternationalizedText	Wyjaśnienie, co oznacza głos Nie w tym referendum. Nie jest to argument przeciwko temu środkowi. Na przykład: A "no" vote opposes this initiative, thus keeping the existing requirement that electric utilities acquire 25 percent of their electricity from renewable resources by 2025.
Type	0 lub 1	BallotMeasureType	Typ wyliczeniowy propozycji ustawodawczej. Wybierz wartość, która najlepiej opisuje głosowanie w danym okręgu.
PassageThreshold	0 lub 1	string	Minimalny odsetek głosów wymagany do przyjęcia wniosku.

Przykłady

XML

     <Contest objectId="c-0" xsi:type="BallotMeasureContest">
        <BallotSelection objectId="bms-00" xsi:type="BallotMeasureSelection">
          <ExternalIdentifiers>
            <ExternalIdentifier>
              <Type>other</Type>
              <OtherType>stable</OtherType>
              <Value>bms-00-yes</Value>
            </ExternalIdentifier>
          </ExternalIdentifiers>
          <Selection>
            <Text language="en">Yes</Text>
          </Selection>
        </BallotSelection>
        <BallotSelection objectId="bms-01" xsi:type="BallotMeasureSelection">
          <ExternalIdentifiers>
            <ExternalIdentifier>
              <Type>other</Type>
              <OtherType>stable</OtherType>
              <Value>bms-01-no</Value>
            </ExternalIdentifier>
          </ExternalIdentifiers>
          <Selection>
            <Text language="en">No</Text>
          </Selection>
        </BallotSelection>
        <BallotSubTitle>
          <Text language="en">Farm Animal Confinement Initiative</Text>
        </BallotSubTitle>
        <BallotTitle>
          <Text language="en">
            California Proposition 12, Farm Animal Confinement Initiative (2018)
          </Text>
        </BallotTitle>
        <ElectoralDistrictId>ru-ca-1</ElectoralDistrictId>
        <ExternalIdentifiers>
          <ExternalIdentifier>
            <Type>other</Type>
            <OtherType>stable</OtherType>
            <Value>c-0</Value>
          </ExternalIdentifier>
        </ExternalIdentifiers>
        <Name>
          California Proposition 12, Farm Animal Confinement Initiative (2018)
        </Name>
        <BallotText>
          <Text language="en">
            Establishes minimum requirements for confining certain farm animals. Prohibits sales of meat and egg products from animals confined in noncomplying manner. Fiscal Impact: Potential decrease in state income tax revenues from farm businesses, likely not more than several million dollars annually. State costs up to $10 million annually to enforce the measure.
          </Text>
        </BallotText>
        <ConStatement>
          <Text language="en">No means the measure will not be enacted
          </Text>
        </ConStatement>
        <InfoUri Annotation="fulltext">
          https://example-government.gov/ballot-measures/California_Proposition_12_2018
        </InfoUri>
        <InfoUri Annotation="wikipedia">
          https://en.wikipedia.org/wiki/2018_California_Proposition_12
        </InfoUri>
        <PassageThreshold>
          <Text language="en">50.01%</Text>
        </PassageThreshold>
        <ProStatement>
          <Text language="en">Yes means the measure will be enacted
          </Text>
        </ProStatement>
        <SummaryText>
          <Text language="en">
            The proposition establishes new minimum requirements on farmers to provide more space for egg-laying hens, breeding pigs, and calves raised for veal. California businesses will be banned from selling eggs or uncooked pork or veal that came from animals housed in ways that did not meet these requirements.
          </Text>
        </SummaryText>
        <Type>ballot-measure</Type>
      </Contest>

RetentionContest

Użyj tego typu, gdy Contest dotyczy referendum, w którym głosujący decydują, czy wybrany urzędnik powinien pozostać na stanowisku, czy zostać z niego usunięty.

Dotyczy to na przykład wyborów sędziów w niektórych stanach USA, w których decyduje się, czy sędzia powinien pozostać na stanowisku na kolejną kadencję. Dotyczy to również wyborów odwoławczych, w których decyduje się, czy urzędnik powinien zostać usunięty ze stanowiska przed zakończeniem kadencji.

Elementy

Wszystkie elementy z BallotMeasureContest obowiązują też w przypadku RetentionContest.

Element	Mnogość	Typ	Opis
CandidateId	1	IDREF	Identyfikator kandydata reprezentującego urzędującego urzędnika
OfficeId	0 lub 1	IDREF	Identyfikator urzędu, który obecnie sprawuje osoba pełniąca funkcję

Przykłady

XML

        <Contest objectId="c-40001" xsi:type="RetentionContest">
        <!-- Retention contest selections are actually BallotMeasureSelection
          objects, and should use the 'bms-' objectId prefix.-->
          <BallotSelection objectId="bms-40001a" xsi:type="BallotMeasureSelection">
            <ExternalIdentifiers>
              <ExternalIdentifier>
                <Type>other</Type>
                <OtherType>stable</OtherType>
                <Value>bms-40001a</Value>
              </ExternalIdentifier>
            </ExternalIdentifiers>
          <Selection label="bms-40001at">
            <Text language="en">Yes</Text>
          </Selection>
          </BallotSelection>
          <BallotSelection objectId="bms-40001b" xsi:type="BallotMeasureSelection">
            <ExternalIdentifiers>
              <ExternalIdentifier>
                <Type>other</Type>
                <OtherType>stable</OtherType>
                <Value>bms-40001b</Value>
              </ExternalIdentifier>
            </ExternalIdentifiers>
          <Selection label="bms-40001bt">
            <Text language="en">No</Text>
          </Selection>
          </BallotSelection>
          <BallotTitle>
            <Text language="en">Retention of Supreme Court Justice</Text>
          </BallotTitle>
          <ElectoralDistrictId>ru-0002</ElectoralDistrictId>
          <ExternalIdentifiers>
            <ExternalIdentifier>
              <Type>other</Type>
              <OtherType>stable</OtherType>
              <Value>c-vageneral-2013-va16-country-us</Value>
            </ExternalIdentifier>
          </ExternalIdentifiers>
          <Name>Judicial Retention, Supreme Court</Name>
          <CandidateId>can-12345</CandidateId>
          <OfficeId>off-20006</OfficeId>
        </Contest>