اختيار الاقتراع

استخدِم BallotSelection لتحديد اختيارات الاقتراع في مسابقة، مثل. عند ربط المرشحين والأحزاب بأعداد الأصوات الخاصة بهم.

يناقش هذا المستند BallotSelection والكيانات الفرعية التابعة له:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

اختَر أحد أنواع الخلاصات التالية لمعرفة المزيد حول كيفية استخدامه السمة BallotSelection والعناصر الأساسية فيها مع هذا النوع من الخلاصات

BallotSelection

BallotSelection هو عنصر تجريدي مؤلف من ثلاثة أنواع يتم استخدامه بناءً على نوع المسابقة:

  • CandidateSelection: استخدام هذه الـ type من BallotSelection عندما تكون المسابقة لمرشح واحد أو أكثر. إنه يربط اختيار الاقتراع إلى Candidate.
  • PartySelection: استخدام هذه type من BallotSelection عندما يكون نوع المسابقة هو Party، على سبيل المثال، منافسة حزبية نسبية
  • BallotMeasureSelection: استخدِم هذا النوع من BallotSelection لتمثيل الاختيارات المحتملة في BallotMeasureContest

السمات

يوضّح الجدول التالي سمات BallotSelection:

السمة مطلوب؟ النوع الوصف
objectId مطلوب ID معرّف داخلي فريد تستخدمه عناصر أخرى للإشارة إليه لهذا العنصر.

العناصر

ويوضّح الجدول التالي عناصر السمة BallotSelection:

العنصر التعددية النوع الوصف
SequenceOrder 0 أو 1 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 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 لتحديد اختيارات الاقتراع التي تشمل طرفًا، مثل اختيار قائمة الأحزاب في الاقتراع.

تكتسِب 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 لتحديد اختيارات الاقتراع التي تتضمن إجراء الاقتراع، مثل الاستفتاءات.

تكتسِب الدالة 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"
          },
        ]
      }
    ]