ตัวระบุภายนอก

เอนทิตี ExternalIdentifier ช่วยให้ครีเอเตอร์ฟีดเชื่อมโยงชุดคู่ค่ามาที่กำหนดเองกับออบเจ็กต์บางรายการได้ ExternalIdentifier เป็นบทบัญญัติของเขตอำนาจศาลในระบบภายนอกที่ใช้เชื่อมโยงเขตอำนาจศาลกับวัตถุต่างๆ เช่น ผู้สมัคร สำนักงาน หรือหน่วยภูมิศาสตร์การเมือง

หมายเหตุ: เอนทิตีนี้เหมือนกันกับฟีดทุกประเภท

ช่อง Type ของเอนทิตี ExternalIdentifier ใช้เพื่ออธิบายแหล่งที่มาของตัวระบุ ไม่ใช่ออบเจ็กต์ที่ระบุ เช่น มี 2 ประเภทในตัวคือ fips ซึ่งเป็นตัวย่อของรหัส "Federal Information Processing Standard" และ state แม้ว่ารหัส 2 หลัก FIPS จะใช้เพื่ออธิบายรัฐได้ แต่ค่า Type ที่ต้องการสำหรับสถานการณ์นี้คือ fips ไม่ใช่ state นั่นเป็นเพราะ fips อธิบายแหล่งที่มาของตัวระบุ

ตัวระบุภายนอกจะใช้ทั่วทั้งฟีดเพื่อวัตถุประสงค์ต่อไปนี้

• ใช้ตัวระบุแบบคงที่
• ใช้ตัวระบุ Canonical จากแหล่งข้อมูลภายนอก เช่น Open Civic Data Identifiers หรือรหัส FIPS
• ระบุแอตทริบิวต์เพิ่มเติมที่ไม่ใช่สคีมา NIST CDF

เมื่อใช้เพื่อให้ข้อมูลหรือบริบทเพิ่มเติมสำหรับออบเจ็กต์ ตัวระบุภายนอกต้องใช้ Type เป็น other และยังมี OtherType และ Value ซึ่งทั้ง 2 ประเภทขึ้นอยู่กับประเภทข้อมูลที่ให้ไว้ด้วย ดูตัวอย่างวิธีระบุข้อมูลในลักษณะนี้ได้ที่ Office

หมายเหตุ: รูปพหูพจน์ExternalIdentifiers เป็น collection ที่รวมเอนทิตีอย่างน้อย 1 รายการ ExternalIdentifier คุณใช้เอนทิตีย่อย ExternalIdentifier หลายรายการเพื่อเชื่อมโยงเขตอำนาจศาลกับรหัสหลายรายการได้

Attributes

ตารางต่อไปนี้อธิบายแอตทริบิวต์ของ 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"
        }
      ]
    }