Harici Tanımlayıcı

ExternalIdentifier öğesi, feed oluşturucuların rastgele kaynak-değer çiftlerini belirli nesnelerle ilişkilendirmesine olanak tanır. ExternalIdentifier, genellikle bir yargı alanını adaylar, ofisler veya jeopolitik birimler gibi nesnelerle ilişkilendirmek için kullanılan harici bir sistemdeki yargı alanı kodudur.

Bir ExternalIdentifier varlığının Type alanı, tanımlanan nesneyi değil, tanımlayıcının kaynağını tanımlamak için kullanılır. Örneğin, yerleşik türlerden ikisi "Federal Information Processing Standard" kodunun kısaltması olan fips ve state'dir. Eyaletleri tanımlamak için iki haneli FIPS kodları kullanılabilse de bu durum için amaçlanan Type değeri fips'dir ve state değildir. Bunun nedeni, fips öğesinin tanımlayıcının kaynağını açıklamasıdır.

Harici tanımlayıcılar, özet akışında aşağıdaki amaçlarla kullanılır:

  • Sabit bir tanımlayıcı sağlayın.
  • Open Civic Data Identifiers veya FIPS kodu gibi harici bir kaynaktan standart bir tanımlayıcı sağlayın.
  • NIST CDF şemasına özgü olmayan ek özellikler sağlayın.

Bir nesne için ek veri veya bağlam sağlamak üzere kullanıldığında, harici tanımlayıcılar Type other kullanmalıdır. Ayrıca, sağlanan verilerin türüne bağlı olan bir OtherType ve bir Value içerirler. Verilerin bu şekilde nasıl sağlanabileceğine dair bir örnek için Office bölümüne bakın.

Özellikler

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

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

Öğeler

Aşağıdaki tabloda ExternalIdentifier öğeleri 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ğerinin other olduğu durumlarda kullanılır.
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"
        }
      ]
    }