מזהה חיצוני

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

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

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

  • צריך לספק מזהה יציב.
  • צריך לספק מזהה קנוני ממקור חיצוני, כמו מזהים של Open Civic Data או קוד 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"
        }
      ]
    }