انتخاب رای

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

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

• BallotSelection
  • CandidateSelection
  • PartySelection
  • BallotMeasureSelection
  • SpecialBallotSelection

---

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

فیدهای داده‌های پیش از انتخابات فیدهای نتایج انتخابات

---

توجه: این موجودیت با فیدهای صاحب‌منصب استفاده نمی‌شود.

انتخاب برگه رأی

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

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

ویژگی‌ها

جدول زیر ویژگی‌های BallotSelection را شرح می‌دهد:

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

عناصر

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

عنصر	چندگانگی	نوع	توضیحات
SequenceOrder	۰ یا ۱	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	۱	IDREFS	شناسه‌های منحصر به فرد برای یک یا چند عنصر Candidate . برای مرتبط کردن یک کاندیدا با انتخاب کاندیدا در برگه رأی استفاده می‌شود. همچنین زمانی مفید است که انتخاب برگه رأی برای چندین کاندیدا باشد، مانند یک بلیت که در آن رئیس جمهور و معاون رئیس جمهور با هم انتخاب شده‌اند.
EndorsementPartyIds	۰ یا بیشتر	IDREFS	شناسه منحصر به فرد برای دو یا چند نهاد Party . این نشان دهنده ترتیبی است که در آن احزاب سیاسی کاندیدای یکسانی را در برگه رأی فهرست می‌کنند.
IncludedInAggregation	۰ یا ۱	boolean	اینکه آیا تعداد آرای انتخاب شده در AggregateBallotSelection برای مسابقه لحاظ می‌شود یا خیر. در صورت عدم مشخص شدن، مقدار false در نظر گرفته می‌شود. توجه: مجموع آرای داده شده برای تمام گزینه‌های برگه رأی که ​​با عنوان IncludedInAggregation علامت‌گذاری شده‌اند، باید کمتر یا مساوی کل آرای AggregateBallotSelection باشد.
IsWriteIn	۰ یا ۱	boolean	نشان می‌دهد که آیا کاندید، یک متقاضی ثبت‌شده است یا خیر. مقدار پیش‌فرض false است.

مثال‌ها

XML

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

جی‌سون

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

انتخاب مهمانی

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

توجه: این موجودیت با فیدهای صاحب‌منصب استفاده نمی‌شود.

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

عناصر

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

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

مثال‌ها

XML

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

جی‌سون

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

انتخاب با رای گیری

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

توجه: این موجودیت با فیدهای صاحب‌منصب استفاده نمی‌شود.

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

عناصر

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

عنصر	چندگانگی	نوع	توضیحات
ExternalIdentifiers	۰ یا ۱	ExternalIdentifiers	یک شناسه را به انتخاب معیار رأی‌گیری مرتبط می‌کند. یک شناسه پایدار مورد نیاز است.
Selection	۱	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>

جی‌سون

    "BallotSelection": [
      {
        "@type": "BallotMeasureSelection",
        "objectId": "bms00",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0_yes"
            }
          ]
        },
        "Selection": {
          "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>

جی‌سون

    "BallotSelection": [
      {
        "@type": "BallotMeasureSelection",
        "objectId": "bms00",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0_yes"
            }
          ]
        },
        "Selection": {
          "Text": [
            {
              "value": "Yes",
              "language": "en"
            }
          ]
        }
      }
    ]

انتخاب ویژه با رأی‌گیری

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

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

توجه: این موجودیت با فیدهای صاحب‌منصب استفاده نمی‌شود.

عناصر

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

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

مثال‌ها

XML

    <AggregateBallotSelection objectId="selection3">
      <Selection>
        <Text language="en">Other Candidates</Text>
      </Selection>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>selection3</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </AggregateBallotSelection>
    <!-- Counts of ballots left blank -->
    <BlankBallotSelection objectId="selection4">
      <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>selection4</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </BlankBallotSelection>
    <!-- Votes for "None of the above" option on the ballot -->
    <NoneOfTheAboveBallotSelection objectId="selection5">
      <!--
        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>selection5</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="selection5">
      <!--
        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>selection5</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </NullBallotSelection>
      

جی‌سون

    "AggregateBallotSelection": {
      "objectId": "selection3",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "Other Candidates"
        }
      },
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection3"
        }
      },
    },
    "BlankBallotSelection": {
      "objectId": "selection4",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "Blank Ballots"
        }
      },
      "CountedInTotal": true,
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection4"
        }
      }
    },
    "NoneOfTheAboveBallotSelection": {
      "objectId": "selection5",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "None"
        }
      },
      "CountedInTotal": true,
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection5"
        }
      }
    },
    "NullBallotSelection": {
      "objectId": "selection5",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "Spoiled ballots"
        }
      },
      "CountedInTotal": false,
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection5"
        }
      }
    }