انتخاب رای

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