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

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

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

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

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

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

السمات

يوضّح الجدول التالي سمات 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"
        }
      ]
    }