अलर्ट

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

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

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

विशेषताएं

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

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

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

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

उदाहरण:

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

एलिमेंट

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

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

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

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

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

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

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

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

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

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

<code> एलिमेंट से, अलर्ट मैसेज को खास तौर पर मैनेज करने के बारे में पता चलता है.
<note> CONDITIONAL string

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

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> CONDITIONAL 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>