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

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

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

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

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

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

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

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

Attributes

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