يتيح الكيان 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" } ] }