شناسه خارجی

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

توجه: این موجودیت برای همه انواع فید یکسان است.

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

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

• یک شناسه پایدار ارائه دهید.
• یک شناسه متعارف از یک منبع خارجی، مانند Open Civic Data Identifiers یا کد 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"
        }
      ]
    }