बाहरी आइडेंटिफ़ायर

ExternalIdentifier इकाई की मदद से, फ़ीड क्रिएटर्स कुछ ऑब्जेक्ट के साथ सोर्स-वैल्यू पेयर के आर्बिट्ररी सेट को जोड़ सकते हैं. ExternalIdentifier अक्सर किसी बाहरी सिस्टम में क्षेत्राधिकार का कोड होता है. इसका इस्तेमाल किसी क्षेत्राधिकार को उम्मीदवारों, ऑफ़िस या भू-राजनीतिक इकाइयों जैसी चीज़ों से जोड़ने के लिए किया जाता है.

ध्यान दें: यह इकाई, सभी फ़ीड टाइप के लिए एक जैसी होती है.

ExternalIdentifier इकाई के Type फ़ील्ड का इस्तेमाल, आइडेंटिफ़ायर के सोर्स के बारे में बताने के लिए किया जाता है. इसका इस्तेमाल, उस ऑब्जेक्ट के बारे में बताने के लिए नहीं किया जाता जिसकी पहचान की जा रही है. उदाहरण के लिए, दो बिल्ट-इन टाइप fips और state हैं. fips, "फ़ेडरल इन्फ़ॉर्मेशन प्रोसेसिंग स्टैंडर्ड" कोड का संक्षिप्त रूप है. राज्यों के बारे में बताने के लिए, FIPS के दो अंकों वाले कोड का इस्तेमाल किया जा सकता है. हालांकि, इस स्थिति के लिए Type की सही वैल्यू fips है, न कि state. ऐसा इसलिए है, क्योंकि fips आइडेंटिफ़ायर के सोर्स के बारे में बताता है.

बाहरी आइडेंटिफ़ायर का इस्तेमाल पूरे फ़ीड में इन कामों के लिए किया जाता है:

• ऐसा आइडेंटिफ़ायर दें जिसे जल्दी बदला न जाए.
• किसी बाहरी संसाधन से कैननिकल आइडेंटिफ़ायर दें. जैसे, Open Civic Data Identifiers या FIPS कोड.
• ऐसे अतिरिक्त एट्रिब्यूट उपलब्ध कराएं जो NIST CDF स्कीमा के नेटिव नहीं हैं.

जब किसी ऑब्जेक्ट के लिए अतिरिक्त डेटा या कॉन्टेक्स्ट देने के लिए बाहरी आइडेंटिफ़ायर का इस्तेमाल किया जाता है, तो उन्हें other के Type का इस्तेमाल करना चाहिए. इनमें OtherType और Value भी शामिल हैं. ये दोनों, दिए गए डेटा के टाइप पर निर्भर करते हैं. इस तरह से डेटा कैसे दिया जा सकता है, इसका उदाहरण देखने के लिए Office पर जाएं.

ध्यान दें: प्लुरल ExternalIdentifiers, एक कलेक्शन होता है. इसमें एक या उससे ज़्यादा ExternalIdentifier इकाइयां शामिल होती हैं. ExternalIdentifier उप-इकाई के एक से ज़्यादा उदाहरणों का इस्तेमाल करके, किसी अधिकार क्षेत्र को कई कोड से जोड़ा जा सकता है.

विशेषताएं

यहां दी गई टेबल में, 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"
        }
      ]
    }