अलर्ट

किसी मौजूदा इवेंट के बारे में बुनियादी जानकारी देने के लिए, <alert> इकाई का इस्तेमाल करें.

अगर कोई इवेंट एक ही समय पर एक से ज़्यादा जगहों पर है, तो यह बेहतर होगा कि इवेंट को एक से ज़्यादा alert ऑब्जेक्ट में बांटा जाए. उदाहरण के लिए, अगर जंगल में लगी आग कई इलाकों में फैली है, तो हर चेतावनी को अलग-अलग स्थितियों में दिखाया जा सकता है. इस तरह, हर स्थिति के बारे में खास जानकारी दी जाती है. साथ ही, आग लगने की स्थिति को ज़्यादा सटीक तरीके से अपडेट किया जाता है.

अगर कोई इवेंट तेज़ी से बदलता है, जैसे किसी तूफ़ान के बारे में पहले से पश्चिम की ओर जाना, तो हमारा सुझाव है कि आप समय-समय पर सूचना देते रहें. अपने फ़ीड से मौजूदा सूचना न हटाएं. इसके बजाय, एक नया अलर्ट जारी करें, जो पिछली चेतावनी के बारे में बताता हो.

विशेषताएं

पहली टेबल में <alert> इकाई के लिए एट्रिब्यूट की वैल्यू के बारे में बताया गया है:

टेबल 1. <alert> इकाई एट्रिब्यूट

एलिमेंट का नाम वैकल्पिकता टाइप ब्यौरा
xmlns:cap ज़रूरी है string

xmlns एट्रिब्यूट में, CAP URN का रेफ़रंस नेमस्पेस के तौर पर दिया जाना चाहिए.

उदाहरण:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

एलिमेंट

दूसरी टेबल में <alert> इकाई के सब-एलिमेंट वैल्यू की जानकारी दी गई है:

टेबल 2. <alert> इकाई एलिमेंट

एलिमेंट का नाम वैकल्पिकता टाइप CAP और Google नोट और ज़रूरी शर्तें
<identifier> ज़रूरी है string उस सूचना का आईडी दें जो इवेंट को दिखाता है. <identifier> एलिमेंट की वैल्यू, सभी इवेंट में यूनीक होनी चाहिए.
<sender> ज़रूरी है string <sender> एलिमेंट से पता चलता है कि सूचना कहां से मिली है. इसमें स्पेस, कॉमा या प्रतिबंधित वर्ण शामिल नहीं किए जा सकते.
<sent> ज़रूरी है dateTime

<area> ब्लॉक में दिया गया जगह एक ही समय क्षेत्र में है. उस ज़ोन में समय बताने के लिए, <sent> एलिमेंट का इस्तेमाल करें. लागू होने पर, डेलाइट सेविंग टाइम के लिए एक अनुमति शामिल करें.

जब किसी मैसेज का कॉन्टेंट एक से ज़्यादा टाइम ज़ोन में लागू होता है, तो यूटीसी समय का इस्तेमाल स्थानीय समय के मुताबिक करें.
<status> ज़रूरी है AlertStatus

Google सिर्फ़ सार्वजनिक तौर पर उपलब्ध होने वाली ऐसी सूचनाओं को पब्लिश करता है जिनमें <status> एलिमेंट की वैल्यू Actual हो.
<msgType> ज़रूरी है AlertMsgType

UPDATE या CANCEL <msgType> में कम से कम एक <references> एलिमेंट शामिल होना चाहिए. CAP स्टैंडर्ड से यह जानकारी मिलती है:

  • पिछला सूचना अपडेट करने वाला कोई भी चेतावनी मैसेज अपडेट करें सुविधा का इस्तेमाल करता है. साथ ही, उन सभी पिछले मैसेज को <references> एलिमेंट के तौर पर सेट करता है जो उनके <expires> की तारीख तक नहीं पहुंचे हैं.
  • UPDATE या CANCEL <msgType> एलिमेंट, ऐसे अलर्ट पर लागू होना चाहिए जिसकी समयसीमा खत्म न हुई हो. इसलिए, जब कोई UPDATE या CANCEL <msgType> जारी किया जाता है, तो इससे जुड़े सभी मैसेज और खत्म नहीं होने वाली चेतावनियां रेफ़रंस की जानी चाहिए.

ज़्यादा जानकारी के लिए, इवेंट में बदलाव या उसके खत्म होने की तारीख देखें.
<source> वैकल्पिक string <source> एलिमेंट, सूचना के खास स्रोत की जानकारी देता है. उदाहरण के लिए, कोई ऑपरेटर या कोई खास डिवाइस.
<scope> ज़रूरी है AlertScope

<scope> एलिमेंट से पता चलता है कि चेतावनी वाला मैसेज किस मकसद से बनाया जाना है.
<restriction> कंडीशनल string अगर <scope> एलिमेंट की वैल्यू Restricted है, तो <restriction> एलिमेंट की वैल्यू डालना ज़रूरी है. इस एलिमेंट में ऐसे नियम के बारे में बताया गया है जिससे पाबंदी वाले चेतावनी मैसेज के डिस्ट्रिब्यूशन को सीमित किया जा सकता है.
<addresses> कंडीशनल string अगर <scope> एलिमेंट की वैल्यू Private है, तो <addresses> एलिमेंट की वैल्यू डालना ज़रूरी है. यह एलिमेंट, चेतावनी वाले मैसेज को पाने वाले के बारे में बताता है. आप एक से ज़्यादा स्पेस-डीलिमिटेड पते शामिल कर सकते हैं. हालांकि, आपको उन पतों को अटैच करना होगा जिनमें डबल कोट के अंदर खाली सफ़ेद जगह हो.
<code> वैकल्पिक string

<code> एलिमेंट से पता चलता है कि सूचना के मैसेज में खास हैंडलिंग की गई है.
<note> कंडीशनल string

अगर सूचना में इनमें से कोई एक वैल्यू मौजूद है, तो <note> एलिमेंट ज़रूरी है:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> कंडीशनल string

अगर <msgType> एलिमेंट की वैल्यू UPDATE या CANCEL है, तो <references> एलिमेंट ज़रूरी है.

जब आपका सिस्टम किसी दूसरे पब्लिशर के सीएपी कॉन्टेंट को फिर से पब्लिश करता है, तो पूरे सीपीए की चेतावनी शामिल करें. जिस कॉन्टेंट में बदलाव किया गया है उसे मूल सोर्स से जोड़ने के लिए, <references> टैग का इस्तेमाल करें.

अगर एक से ज़्यादा मैसेज का रेफ़रंस दिया जाता है, तो डीलिमिटर के तौर पर खाली सफ़ेद जगह का इस्तेमाल करें.
<incidents> वैकल्पिक string <incidents> एलिमेंट में एक से ज़्यादा मैसेज शामिल होते हैं, जो एक ही घटना के अलग-अलग पहलुओं के बारे में बताते हैं.
<info>

ज़रूरी है*

 info कम से कम एक <info> एलिमेंट मौजूद होना चाहिए. एक से ज़्यादा <info> ब्लॉक में, एक ही <category> और <event> एलिमेंट की वैल्यू एक ही होनी चाहिए.

* Google को ऐसे एलिमेंट की ज़रूरत होती है जिन्हें बोल्ड और लाल रंग की ज़रूरी है ज़रूरी नहीं है. हालांकि, ये एलिमेंट CAP स्टैंडर्ड में ज़रूरी नहीं होते.

उदाहरण

<alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
    <identifier>AL20110412020900TornadoWarning</identifier>
    <sender>w-nws.webmaster@noaa.gov</sender>
    <sent>2011-04-11T21:18:07-05:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <scope>Public</scope>
    <info>
        <language>en-US</language>
        <category>Met</category>
        <event>Tornado Warning</event>
        <urgency>Immediate</urgency>
        <severity>Extreme</severity>
        <certainty>Observed</certainty>
        <effective>2011-04-11T21:09:00-05:00</effective>
        <expires>2011-04-11T21:30:00-05:00</expires>
        <headline>Tornado Warning issued April 11 at
        9:30PM CDT by NWS Birmingham</headline>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't wait to see or hear the tornado.
          For your protection, move to an interior room on the lowest floor
          of your home or business.</instruction>
        <area>
            <areaDesc>Cleburne</areaDesc>
            <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
            33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
            33.61,-85.58</polygon>
        </area>
    </info>
</alert>