Harici Tanımlayıcı

ExternalIdentifier varlığı, feed içerik üreticilerinin rastgele kaynak-değer çiftlerini kullanır. ExternalIdentifier, sık sık yargı alanı kodunun, bir araştırmayı ilişkilendirmek için kullanılan harici bir sistemde adaylar, makamlar veya jeopolitik birimler gibi nesnelerin bulunduğu yargı alanları.

Bir ExternalIdentifier öğesinin Type alanı, kaynağı (tanımlanan nesne değil). Örneğin, yerleşik türler, "Federal Bilgi"nin kısaltması olan fips'dir. İşleme Standardı" kod ve state. FIPS iki haneli kodları eyaletleri açıklamak için kullanılır. Bu durum için amaçlanan Type değeri fips şeklindedir. state değil. Bunun nedeni, fips öğesinin tanımlayıcının kaynağını tanımlamasıdır.

Harici tanımlayıcılar, feed genelinde aşağıdaki amaçlar için kullanılır:

  • Sabit bir tanımlayıcı sağlayın.
  • Open Civic gibi harici bir kaynaktan standart bir tanımlayıcı sağlayın Veri Tanımlayıcıları veya FIPS kodu.
  • NIST CDF şemasında yerel olmayan ek özellikler sağlayın.

Bir nesneye ek veri veya bağlam sağlamak için kullanıldığında harici tanımlayıcıların bir Type/other kullanması gerekiyor. Ayrıca OtherType içerirler ve her ikisi de sağlanan veri türüne bağlı olan bir Value. Örneğin, verilerin bu şekilde nasıl sağlanabileceğiyle ilgili bir örnek için Office.

Özellikler

Aşağıdaki tabloda ExternalIdentifier özellikleri açıklanmaktadır:

Özellik Zorunlu mu? Tür Açıklama
label İsteğe bağlı string Bilgilendirici bir etiket. Gerektiğinde kullanılabilir.

Öğeler

Aşağıdaki tabloda ExternalIdentifier için öğeler gösterilmektedir:

Öğe Çokluk Tür Açıklama
Type 1 IdentifierType Tanımlayıcı türü sağlar.
OtherType 0 veya 1 string IdentifierType değeri şu olduğunda kullanılır: other.
Value 1 string Yargı alanı tarafından kullanılan tanımlayıcı.

Örnekler

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