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

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

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

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

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

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

السمات

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

السمة مطلوب؟ Type الوصف
label إجراء اختياري string عبارة عن تصنيف معبِّر. يمكن استخدامها حسب الحاجة.

العناصر

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

عنصر التعددية Type الوصف
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"
        }
      ]
    }