Użyj właściwości BallotSelection
, aby zidentyfikować karty do głosowania w konkursie, na przykład
gdy łączysz kandydatów i partie z ich liczbą głosów.
W tym dokumencie omówiono usługę BallotSelection
i jej podelementy:
BallotSelection
CandidateSelection
PartySelection
BallotMeasureSelection
Wybierz jeden z tych typów plików danych, aby dowiedzieć się więcej o tym, jak z nich korzystać
BallotSelection
i elementy zawarte w pliku danych tego typu.
BallotSelection
BallotSelection
to abstrakcyjny element z 3 typami, które są używane w zależności od tego,
typ konkursu:
CandidateSelection
: użyjtype
zBallotSelection
, gdy konkurs dotyczy co najmniej jednego kandydata. Linki wybór kart do głosowaniaCandidate
.PartySelection
: użyjtype
zBallotSelection
gdy typem konkursu jestParty
, na przykład w przypadku konkursu proporcjonalnego.BallotMeasureSelection
: użyj tego typuBallotSelection
do reprezentowania możliwych wyborów wBallotMeasureContest
Atrybuty
W tabeli poniżej znajdziesz atrybuty związane z BallotSelection
:
Atrybut | Wymagana? | Typ | Opis |
---|---|---|---|
objectId
|
Wymagane | ID |
Unikalny identyfikator wewnętrzny używany przez inne elementy jako odniesienia ten element. |
Elementy
W tabeli poniżej znajdziesz opis elementów występujących w elemencie BallotSelection
:
Element | Mnogość | Typ | Opis |
---|---|---|---|
SequenceOrder |
0 lub 1 | integer |
Określa domyślną kolejność wyświetlania kart do głosowania w celach informacyjnych. Jeśli w pliku danych nie ma atrybutu |
CandidateSelection
Użyj funkcji CandidateSelection
, aby wskazać karty do głosowania w kandydacie
konkurs, w tym zapisy.
CandidateSelection
dziedziczy atrybuty
i elementów BallotSelection
. Odniesienia do wielu
Elementy Candidate
można uwzględnić, jeśli
jest konieczne, np. gdy wybór karty do głosowania dotyczy zgłoszenia więcej niż 1 osoby.
kandydaci.
Gdy do zgłoszenia odwołuje się więcej niż 1 kandydat, czasami ważne jest,
w celu zachowania kolejności kandydatów. W takich przypadkach oczekujemy
generując aplikację, która wyświetla odwołania do
Candidate
elementów w obrębie
CandidateIds
zgodnie z obowiązującym schematem porządkowania. Przykład:
kolejność kandydatów musi być taka sama jak kolejność
Office
odwołań do elementów w obrębie
OfficeIds
w: Contest
typu
CandidateContest
Jeśli odwołać się do więcej niż 1 obiektu Candidate
, zostaną one wyświetlone użytkownikowi.
w tej kolejności:
- Wszyscy kandydaci, w przypadku których pole
IsTopTicket
ma wartośćtrue
, są uporządkowane przed innymi kandydatów bez wartościIsTopTicket
. Z kolei są one uporządkowane z wyprzedzeniem wszystkich kandydatów z polemIsTopTicket
ustawionym nafalse
. Najlepiej, gdy wybierzesz jest ustawiona z jedną kandydatką bez wartościIsTopTicket
lub tam to para kandydatów, a jeden z nich ma atrybutIsTopTicket
ustawiony natrue
. Jeśli te warunki nie są spełnione:- Wszyscy kandydaci, w przypadku których parametr
IsTopTicket
ma wartośćtrue
, są przedstawiani w w nieokreślonej kolejności. - Wszyscy kandydaci, w przypadku których nie ma pola
IsTopTicket
, są przedstawiani w w nieokreślonej kolejności. - Wszyscy kandydaci, w przypadku których parametr
IsTopTicket
ma wartośćfalse
, są przedstawiani w w nieokreślonej kolejności.
- Wszyscy kandydaci, w przypadku których parametr
Składnia XML CandidateSelection
jest następująca:
<BallotSelection xsi:type="CandidateSelection">
Elementy
W tabeli poniżej znajdziesz opis elementów występujących w elemencie CandidateSelection
:
Element | Mnogość | Typ | Opis |
---|---|---|---|
CandidateIds |
1 | IDREFS |
Unikalne identyfikatory dla co najmniej jednego elementu
Candidate
. Służy do powiązania kandydata z wyborem kandydata w dniu
kartę do głosowania. Przydatne również wtedy, gdy wybór kart do głosowania dotyczy wielu
kandydatów, np. zgłoszenie do prezydenta i wiceprezydenta
wybrane razem. |
EndorsementPartyIds |
0 lub więcej | IDREFS |
Unikalny identyfikator co najmniej dwóch
Party elementów.
Jest to porozumienie, w którym partie polityczne podają te same
na karcie do głosowania. |
IsWriteIn |
0 lub 1 | boolean |
Wskazuje, czy kandydat jest pisany. Wartość domyślna to
false |
Przykłady
XML
<BallotSelection objectId="cs10861" xsi:type="CandidateSelection"> <CandidateIds>can10861a can10861b</CandidateIds> </BallotSelection>
JSON
"BallotSelection": [ { "@type": "CandidateSelection", "objectId": "cs10861", "CandidateIds": [ "can10861a", "can10861b" ] } ]
PartySelection
Użyj PartySelection
, aby wskazać, które karty do głosowania uczestniczą w wyborach określonej partii, np.
Lista partii na karcie do głosowania.
PartySelection
dziedziczy atrybuty i elementy tagu BallotSelection
.
Składnia XML dla atrybutu PartySelection
jest następująca:
<BallotSelection xsi:type="PartySelection" ... />
Elementy
W tabeli poniżej znajdziesz opis elementów występujących w elemencie PartySelection
:
Element | Mnogość | Typ | Opis |
---|---|---|---|
PartyIds |
1 | IDREFS |
Unikalny identyfikator co najmniej jednej jednostki
Party
. Użyj do powiązania co najmniej 1 podmiotu z grupą.
wyboru. |
Przykłady
XML
<BallotSelection objectId="ps150" xsi:type="PartySelection"> <PartyIds>par100</PartyIds> </BallotSelection>
JSON
"BallotSelection": [ { "@type": "PartySelection", "objectId": "ps150", "PartyIds": [ "par100" ] } ]
BallotMeasureSelection
Użyj właściwości BallotMeasureSelection
, aby wskazać, które karty do głosowania obejmują
np. referendum.
BallotMeasureSelection
dziedziczy atrybuty i elementy
BallotSelection
Składnia XML BallotMeasureSelection
jest następująca:
<BallotSelection xsi:type="BallotMeasureSelection" ... />
Elementy
W tabeli poniżej znajdziesz opis elementów występujących w elemencie BallotMeasureSelection
:
Element | Mnogość | Typ | Opis |
---|---|---|---|
ExternalIdentifiers |
1 | ExternalIdentifiers |
Przypisuje identyfikator do wyboru referendum. O identyfikator stabilny jest wymagane. |
Selection |
1 | InternationalizedText |
Wskazuje opcję głosowania, np. Yes
lub No . |
Przykłady
XML
<BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc0_yes</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">Yes</Text> </Selection> </BallotSelection>
JSON
"BallotSelection": [ { "@type": "BallotMeasureSelection", "objectId": "bms00", "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0_yes" } ] } "Text": [ { "value": "Yes", "language": "en" }, ] } ]
XML
<BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc0_yes</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">Yes</Text> </Selection> </BallotSelection>
JSON
"BallotSelection": [ { "@type": "BallotMeasureSelection", "objectId": "bms00", "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0_yes" } ] } "Text": [ { "value": "Yes", "language": "en" }, ] } ]