المعرّف الخارجي

تتيح السمة ExternalIdentifier لمنشئي الخلاصات ربط مجموعات عشوائية من أزواج المصدر والقيمة بكائنات معيّنة. ExternalIdentifier هو رمز خاص بالولاية القضائية في نظام خارجي، ويُستخدم لربط ولاية قضائية بعناصر مثل المرشحين أو المناصب أو الوحدات الجغرافية السياسية.

ملاحظة: يكون هذا العنصر هو نفسه لجميع أنواع الخلاصات.

يُستخدَم الحقل Type الخاص بالكيان ExternalIdentifier لوصف مصدر المعرّف، وليس العنصر الذي يتم تعريفه. على سبيل المثال، من بين الأنواع المضمّنة، هناك fips، وهو اختصار لرمز "المعيار الفيدرالي لمعالجة المعلومات"، وstate. على الرغم من أنّه يمكن استخدام رموز FIPS المكوّنة من رقمَين لوصف الولايات، فإنّ قيمة Type المقصودة في هذه الحالة هي fips وليس state. ذلك لأنّ fips يصف مصدر المعرّف.

تُستخدَم المعرّفات الخارجية في جميع أنحاء الخلاصة للأغراض التالية:

• قدِّم معرّفًا ثابتًا.
• قدِّم معرّفًا أساسيًا من مصدر خارجي، مثل معرّفات Open Civic Data أو رمز FIPS.
• قدِّم سمات إضافية غير متوافقة مع مخطط NIST CDF.

عند استخدام المعرّفات الخارجية لتوفير بيانات أو سياق إضافيَّين لكائن، يجب أن تستخدم المعرّفات الخارجية Type بقيمة other. وتتضمّن أيضًا OtherType وValue يعتمدان على نوع البيانات المقدَّمة. للاطّلاع على مثال حول كيفية تقديم البيانات بهذه الطريقة، يُرجى الرجوع إلى Office.

ملاحظة: الجمع ExternalIdentifiers هو مجموعة تضم عنصرًا واحدًا أو أكثر من عناصر ExternalIdentifier. يمكن استخدام عدة تكرارات للعنصر الفرعي ExternalIdentifier لربط جهة قضائية برموز متعددة.

السمات

يوضّح الجدول التالي سمات النوع ExternalIdentifier:

السمة	مطلوب؟	النوع	الوصف
label	اختياري	string	تصنيف إعلامي للاستخدام عند الحاجة

العناصر

يعرض الجدول التالي عناصر ExternalIdentifier:

العنصر	التعددية	النوع	الوصف
Type	1	IdentifierType	توفّر هذه السمة نوع معرّف.
OtherType	0 أو 1	string	يُستخدَم عندما تكون قيمة IdentifierType هي other.
Value	1	string	المعرّف المستخدَم في نطاق السلطة.

أمثلة

XML

    <ExternalIdentifiers>
     <ExternalIdentifier>
        <Type>other</Type>
        <OtherType>stable</OtherType>
        <Value>stable-gu-0081</Value>
      </ExternalIdentifier>
      <ExternalIdentifier>
        <Type>ocd-id</Type>
        <Value>ocd-division/country:ke/county:narok</Value>
      </ExternalIdentifier>
      <ExternalIdentifier>
        <Type>national-level</Type>
        <Value>33</Value>
      </ExternalIdentifier>
    </ExternalIdentifiers>

JSON

    "ExternalIdentifiers": {
      "ExternalIdentifier" : [
        {
          "Type": "other",
          "OtherType": "stable",
          "Value": "stable-gu-0081"
        },
        {
          "Type": "ocd-id",
          "Value": "ocd-division/country:ke/county:narok"
        },
        {
          "Type": "national-level",
          "Value": "33"
        }
      ]
    }