شناسه خارجی

موجودیت ExternalIdentifier به سازندگان فید اجازه می‌دهد تا مجموعه‌های دلخواه از جفت‌های منبع-مقدار را با اشیاء خاص مرتبط کنند. ExternalIdentifier اغلب یک کد حوزه قضایی در یک سیستم خارجی است که برای مرتبط کردن یک حوزه قضایی با اشیاء مانند نامزدها، دفاتر یا واحدهای ژئوپلیتیکی استفاده می‌شود.

فیلد Type یک موجودیت ExternalIdentifier برای توصیف منبع شناسه استفاده می‌شود، نه شیء مورد شناسایی. برای مثال، دو نوع از نوع‌های داخلی fips ، مخفف کد "استاندارد پردازش اطلاعات فدرال" و state هستند. اگرچه کدهای دو رقمی FIPS می‌توانند برای توصیف حالت‌ها استفاده شوند، مقدار Type مورد نظر برای این وضعیت fips است و نه state . دلیل این امر این است که fips منبع شناسه را توصیف می‌کند.

شناسه‌های خارجی در سراسر فید برای اهداف زیر استفاده می‌شوند:

  • یک شناسه پایدار ارائه دهید.
  • یک شناسه استاندارد از یک منبع خارجی، مانند شناسه‌های داده‌های مدنی باز یا کد FIPS، ارائه دهید.
  • ویژگی‌های اضافی که مختص طرحواره NIST CDF نیستند را ارائه دهید.

وقتی از شناسه‌های خارجی برای ارائه داده‌ها یا زمینه‌های اضافی برای یک شیء استفاده می‌شود، باید از یک Type other استفاده کنند. آن‌ها همچنین شامل یک OtherType و یک Value هستند که هر دو به نوع داده‌ای که ارائه می‌شود بستگی دارند. برای مثالی از نحوه ارائه داده‌ها به این روش، به Office مراجعه کنید.

ویژگی‌ها

جدول زیر ویژگی‌های ExternalIdentifier را شرح می‌دهد:

ویژگی الزامی است؟ نوع توضیحات
label اختیاری string یک برچسب آموزنده. برای استفاده در صورت نیاز.

عناصر

جدول زیر عناصر مربوط به ExternalIdentifier را نشان می‌دهد:

عنصر چندگانگی نوع توضیحات
Type ۱ IdentifierType نوع شناسه را ارائه می‌دهد.
OtherType ۰ یا ۱ string زمانی استفاده می‌شود که مقدار IdentifierType other باشد.
Value ۱ 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>

جی‌سون

    "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"
        }
      ]
    }