BallotSelection

از BallotSelection برای شناسایی گزینه‌های برگه رأی در رقابت استفاده کنید، مثلاً وقتی نامزدها و احزاب را به تعداد آرایشان پیوند می‌دهید.

این سند درباره BallotSelection و نهادهای فرعی آن بحث می‌کند:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection
    • SpecialBallotSelection

یکی از انواع فید زیر را انتخاب کنید تا درباره نحوه استفاده از BallotSelection و عناصر ذاتی آن با آن نوع فید بیشتر بدانید.

BallotSelection

BallotSelection عنصری انتزاعی با سه نوع است که براساس نوع مسابقه استفاده می‌شود:

  • CandidateSelection: از این type BallotSelection زمانی استفاده کنید که رقابت برای یک یا چند نامزد باشد. این ویژگی انتخاب برگه رأی را به عناصر Candidate پیوند می‌دهد.
  • PartySelection: از این type از BallotSelection وقتی نوع مسابقه برای Party باشد استفاده کنید، مثل مسابقه تناسبی حزب.
  • BallotMeasureSelection: از این نوع BallotSelection برای نشان دادن انتخاب‌های ممکن در BallotMeasureContest استفاده کنید.
  • SpecialBallotSelection: این نوع BallotSelection برای تجمیع شمارش آرا (مثلاً تجمیع چند نامزد در «دیگران») و انواع مختلف غیررأی (یعنی برگه‌های رأی سفید، برگه‌های رأی باطل یا مخدوش، و آرای «هیچ‌کدام از موارد بالا») استفاده می‌شود.

مشخصه‌ها

جدول زیر مشخصه‌های BallotSelection را شرح می‌دهد:

مشخصه الزامی است؟ نوع شرح
objectId الزامی ID شناسه داخلی منحصربه‌فردی که عناصر دیگر برای ارجاع به این عنصر از آن استفاده می‌کنند.

عناصر

جدول زیر عناصر BallotSelection را شرح می‌دهد:

عنصر چندگانگی نوع شرح
SequenceOrder ‫۰ یا ۱ integer

ترتیب پیش‌فرضی را برای انتخاب برگه رأی برای اهداف نمایش مشخص می‌کند.

اگر SequenceOrder در فید وجود نداشته باشد، هیچ ترتیبی درنظر گرفته نمی‌شود.

CandidateSelection

از 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 ‫۰ یا بیشتر IDREFS شناسه یکتا برای دو یا چند نهاد Party. این نشان‌دهنده ترتیبی است که در آن احزاب سیاسی نامزد یکسانی را در برگه رأی فهرست می‌کنند.
IncludedInAggregation 0 یا 1 boolean اینکه آیا تعداد آرای انتخاب در AggregateBallotSelection برای رقابت گنجانده شده است یا نه. اگر مشخص نشده باشد، false فرض می‌شود.
IsWriteIn 0 یا 1 boolean نشان می‌دهد که آیا نامزد نوشتنی است یا خیر. مقدار پیش‌فرض false است. ‫
PostElectionStatus 0 یا 1 CandidatePostElectionStatus وضعیت نهایی نامزد، مثل winner یا advanced-to-runoff.
PreElectionStatus ‫۰ یا ۱ CandidatePreElectionStatus وضعیت ثبت‌نام نامزد، مثلاً filed یا qualified.

مثال‌ها

XML

    <BallotSelection objectId="cs-10861" xsi:type="CandidateSelection">
      <CandidateIds>can-10861a can-10861b</CandidateIds>
    </BallotSelection>

PartySelection

از PartySelection برای شناسایی انتخاب‌های برگه رأی که شامل حزب می‌شود استفاده کنید، مثلاً انتخاب فهرست حزب در برگه رأی.

PartySelection مشخصه‌ها و عناصر BallotSelection را به ارث می‌برد. نحو زبان نشانه‌گذاری توسعه‌پذیر برای PartySelection به‌صورت زیر است: <BallotSelection xsi:type="PartySelection" ... />.

عناصر

جدول زیر عناصر PartySelection را شرح می‌دهد:

عنصر چندگانگی نوع شرح
IncludedInAggregation ‫۰ یا ۱ boolean اینکه آیا تعداد آرای انتخاب در AggregateBallotSelection برای رقابت گنجانده شده است یا نه. اگر مشخص نشده باشد، false فرض می‌شود.
PartyIds 1 IDREFS شناسه یکتا برای یک یا چند Party عنصر. از این گزینه برای مرتبط کردن یک یا چند طرف با انتخاب طرف استفاده کنید.

مثال‌ها

XML

    <BallotSelection objectId="ps-150" xsi:type="PartySelection">
      <PartyIds>par-100</PartyIds>
    </BallotSelection>

BallotMeasureSelection

از BallotMeasureSelection برای شناسایی گزینه‌های برگه رأی که شامل اقدام رأی‌گیری، مانند همه‌پرسی، می‌شود استفاده کنید.

BallotMeasureSelection مشخصه‌ها و عناصر BallotSelection را به ارث می‌برد. نحو زبان نشانه‌گذاری توسعه‌پذیر برای BallotMeasureSelection به‌صورت زیر است: <BallotSelection xsi:type="BallotMeasureSelection" ... />.

عناصر

جدول زیر عناصر BallotMeasureSelection را شرح می‌دهد:

عنصر چندگانگی نوع شرح
ExternalIdentifiers ‫۰ یا ۱ ExternalIdentifiers شناسه‌ای را با انتخاب همه‌پرسی مرتبط می‌کند. شناسه پایدار الزامی است.
Selection 1 InternationalizedText انتخاب دردسترسی برای برگه رأی ارائه می‌دهد، مثل Yes یا No.

مثال‌ها

XML

    <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>

XML

    <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>

SpecialBallotSelection

این نوع BallotSelection برای تجمیع شمارش آرا (مثلاً تجمیع چندین نامزد در «سایرین») و انواع مختلف غیررأی (یعنی برگه‌های رأی سفید، برگه‌های رأی باطل یا مخدوش، و آرای «هیچ‌کدام از موارد بالا») استفاده می‌شود.

SpecialBallotSelection نباید در زیرعنصر عمومی BallotSelection از Contest استفاده شود و به‌جای آن فیلدهای متمایز خود را در Contest دارد، یعنی AggregateBallotSelection، BlankBallotSelection، NoneOfTheAboveBallotSelection، و NullBallotSelection. برای جزئیات بیشتر، عناصر Contest را ببینید.

عناصر

جدول زیر عناصر SpecialBallotSelection را شرح می‌دهد:

عنصر چندگانگی نوع شرح
CountedInTotal ‫۰ یا ۱ boolean اینکه آیا تعداد آرای انتخاب نهاد در کل آرای داده‌شده که قابل‌توجه درنظر گرفته می‌شود شمارش شده است یا نه. اگر مشخص نشده باشد، true فرض می‌شود.
ExternalIdentifiers ‫۰ یا ۱ ExternalIdentifiers شناسه‌ای را با انتخاب همه‌پرسی مرتبط می‌کند. یک شناسه پایدار الزامی است.
Selection 1 InternationalizedText نامی برای این انتخاب برگه رأی ارائه می‌دهد، مثلاً «دیگران» یا «هیچ‌کدام از موارد بالا».

مثال‌ها

XML

    <AggregateBallotSelection objectId="sbs-3">
      <Selection>
        <Text language="en">Other Candidates</Text>
      </Selection>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>sbs-3</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </AggregateBallotSelection>
    <!-- Counts of ballots left blank -->
    <BlankBallotSelection objectId="sbs-4">
      <Selection>
        <Text language="en">Blank ballots</Text>
      </Selection>
      <!-- These ballots count in the total and can affect majorities -->
      <CountedInTotal>true</CountedInTotal>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>sbs-4</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </BlankBallotSelection>
    <!-- Votes for "None of the above" option on the ballot -->
    <NoneOfTheAboveBallotSelection objectId="sbs-5">
      <!--
        The NOTA selection optiona as it appears on the ballot, often
        "None of the above", "None", or "Uncommitted"
      -->
      <Selection>
        <Text language="en">None</Text>
      </Selection>
      <!-- These ballots count in the total and can affect majorities -->
      <CountedInTotal>true</CountedInTotal>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>sbs-5</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </NoneOfTheAboveBallotSelection>
    <!--
      Counts of null or spoiled ballots, i.e. ballots that have been marked in
      a way that the vote cannot be counted
    -->
    <NullBallotSelection objectId="sbs-6">
      <!--
        How these ballots are often called in a given country, often
        "null" or "spoiled"
      -->
      <Selection>
        <Text language="en">Spoiled ballots</Text>
      </Selection>
      <!--
        These ballots do count in the total and are treated as the same as
        if this vote did not happen at all
      -->
      <CountedInTotal>false</CountedInTotal>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>sbs-6</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </NullBallotSelection>