מזהה חיצוני

הישות ExternalIdentifier מאפשרת ליוצרי פידים לשייך קבוצות שרירותיות של צמדים של מקור-ערך עם אובייקטים מסוימים. ExternalIdentifier הוא לעיתים קרובות את הקוד של סמכות השיפוט במערכת חיצונית שמשמשת לשיוך סמכות שיפוט עם אובייקטים כמו מועמדים, משרדים או יחידות גיאופוליטיות.

השדה Type של הישות ExternalIdentifier משמש לתיאור של המקור של המזהה, לא של האובייקט שזוהה. לדוגמה, שתיים מתוך הסוגים המובנים הם fips, קיצור של Federal Information עיבוד רגיל" ו-state. למרות שניתן להשתמש בקודים דו-ספרתיים מסוג FIPS משמש לתיאור מדינות, ערך ה-Type המיועד למצב הזה הוא fips ולא state. הסיבה לכך היא ש-fips מתאר את מקור המזהה.

מזהים חיצוניים משמשים לאורך הפיד למטרות הבאות:

  • צריך לספק מזהה יציב.
  • לספק מזהה קנוני ממשאב חיצוני, כמו Open Civic מזהי נתונים או קוד FIPS.
  • צריך לספק מאפיינים נוספים שאינם מותאמים לסכימת NIST CDF.

כשהוא משמש למתן נתונים או הקשר נוספים עבור אובייקט, חיצוני מזהים צריכים להשתמש ב-Type של other. הם כוללים גם OtherType ו-Value ששניהם תלויים בסוג הנתונים שסופקו. עבור דוגמה לאופן שבו אפשר לספק נתונים באופן הזה, Office

מאפיינים

הטבלה הבאה מתארת את המאפיינים של 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"
        }
      ]
    }