מזהה חיצוני

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

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

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

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

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

מאפיינים

בטבלה הבאה מתוארים המאפיינים של ExternalIdentifier:

מאפיין חובה? תיאור התיאור
label אופציונלי string תווית אינפורמטיבית. לשימוש לפי הצורך.

Elements

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