הישות 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" } ] }