ГолосованиеВыбор

Используйте BallotSelection , чтобы идентифицировать выбор бюллетеней в конкурсе, например, когда вы связываете кандидатов и партии с подсчетом их голосов.

В этом документе обсуждается BallotSelection и его подобъекты:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

Выберите один из следующих типов ленты, чтобы узнать больше о том, как использовать BallotSelection и присущие ей элементы с этим типом ленты.

Выбор бюллетеня

BallotSelection — это абстрактный элемент трех типов, которые используются в зависимости от типа конкурса:

  • CandidateSelection : используйте этот type BallotSelection , когда конкурс проводится для одного или нескольких кандидатов. Он связывает выбор бюллетеней с элементами Candidate .
  • PartySelection : используйте этот type BallotSelection когда тип конкурса предназначен для Party , например, для пропорционального конкурса партии.
  • BallotMeasureSelection : используйте этот тип BallotSelection для представления возможных выборов в BallotMeasureContest .

Атрибуты

В следующей таблице описаны атрибуты BallotSelection :

Атрибут Необходимый? Тип Описание
objectId Необходимый ID Уникальный внутренний идентификатор, используемый другими элементами для ссылки на этот элемент.

Элементы

В следующей таблице описаны элементы BallotSelection :

Элемент Множественность Тип Описание
SequenceOrder 0 или 1 integer

Определяет порядок выбора бюллетеней по умолчанию для отображения.

Если SequenceOrder отсутствует в фиде, порядок не предполагается.

Выбор кандидата

Используйте CandidateSelection для определения результатов голосования в конкурсе кандидатов, включая записи.

CandidateSelection наследует атрибуты и элементы BallotSelection . Ссылки на несколько элементов Candidate могут быть включены при необходимости, например, когда в бюллетене выбрано несколько кандидатов.

Когда в билете упоминается несколько кандидатов, иногда важно сохранить порядок кандидатов. В этих случаях мы ожидаем, что генерирующее приложение будет перечислять ссылки на элементы Candidate в CandidateIds в соответствии с действующей схемой упорядочения. Например, порядок кандидатов должен соответствовать тому же порядку ссылок на элементы Office в OfficeIds в Contest типа CandidateContest .

Если имеется ссылка на более чем один объект Candidate , они представляются пользователю в следующем порядке:

  • Все кандидаты, для которых IsTopTicket установлено true располагаются впереди всех кандидатов без значения IsTopTicket . Они, в свою очередь, располагаются впереди всех кандидатов, у которых для IsTopTicket установлено значение false . В идеале выбор задается либо одним кандидатом без значения IsTopTicket , либо имеется пара кандидатов, и для одного из них IsTopTicket установлено значение true . Если эти условия не выполняются, происходит следующее:
    • Все кандидаты, для которых IsTopTicket установлено значение true , представлены в неопределенном порядке.
    • Все кандидаты, у которых отсутствует IsTopTicket , представлены в неопределенном порядке.
    • Все кандидаты, для которых IsTopTicket установлено значение false , представлены в неопределенном порядке.

Синтаксис XML для CandidateSelection следующий: <BallotSelection xsi:type="CandidateSelection"> .

Элементы

В следующей таблице описаны элементы CandidateSelection :

Элемент Множественность Тип Описание
CandidateIds 1 IDREFS Уникальные идентификаторы для одного или нескольких элементов Candidate . Используйте, чтобы связать кандидата с выбранным кандидатом в бюллетене. Также полезно, когда избирательный бюллетень предназначен для нескольких кандидатов, например, когда президент и вице-президент выбираются вместе.
EndorsementPartyIds 0 или более IDREFS Уникальный идентификатор для двух или более Party . Это представляет собой договоренность, при которой политические партии включают в избирательный бюллетень одного и того же кандидата.
IsWriteIn 0 или 1 boolean Указывает, является ли кандидат вписанным. Значение по умолчанию — false .

Примеры

XML 

    <BallotSelection objectId="cs10861" xsi:type="CandidateSelection">
      <CandidateIds>can10861a can10861b</CandidateIds>
    </BallotSelection>

JSON 

    "BallotSelection": [
      {
        "@type": "CandidateSelection",
        "objectId": "cs10861",
        "CandidateIds": [
          "can10861a",
          "can10861b"
        ]
      }
    ]

Выбор вечеринки

Используйте PartySelection , чтобы идентифицировать варианты голосования, в которых участвует партия, например выбор партийного списка в бюллетене.

PartySelection наследует атрибуты и элементы BallotSelection . Синтаксис XML для PartySelection следующий: <BallotSelection xsi:type="PartySelection" ... /> .

Элементы

В следующей таблице описаны элементы PartySelection :

Элемент Множественность Тип Описание
PartyIds 1 IDREFS Уникальный идентификатор одного или нескольких элементов Party . Используйте, чтобы связать одну или несколько сторон с выбранной стороной.

Примеры

XML 

    <BallotSelection objectId="ps150" xsi:type="PartySelection">
      <PartyIds>par100</PartyIds>
    </BallotSelection>

JSON 

    "BallotSelection": [
      {
        "@type": "PartySelection",
        "objectId": "ps150",
        "PartyIds": [
          "par100"
        ]
      }
    ]

БюллетеньМераВыбор

Используйте BallotMeasureSelection чтобы идентифицировать варианты голосования, которые включают в себя меры голосования, такие как референдумы.

BallotMeasureSelection наследует атрибуты и элементы BallotSelection . Синтаксис XML для BallotMeasureSelection следующий: <BallotSelection xsi:type="BallotMeasureSelection" ... /> .

Элементы

В следующей таблице описаны элементы BallotMeasureSelection :

Элемент Множественность Тип Описание
ExternalIdentifiers 1 ExternalIdentifiers Связывает идентификатор с выбором меры голосования. Требуется стабильный идентификатор .
Selection 1 InternationalizedText Предоставляет доступный выбор для голосования, например Yes или No .

Примеры

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