تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

معلومات

يحدِّد عنصر <info> تفاصيل التنبيه. يجب توفّر قالب <info> واحد على الأقل لإنشاء تنبيه. إذا كنت توفّر محتوى بلغات متعدّدة، ننصحك باستخدام كتلة <info> واحدة لكل لغة للكيان <alert> نفسه.

`info` عناصر الكيانات

يوضّح الجدول التالي قيم العناصر الفرعية لكيان <info>:

اسم العنصر	الخيار	النوع	ملاحظات ومتطلّبات CAP وGoogle
`<language>`	اختياري	`language`	بالنسبة إلى قيمة الرمز `<language>`، ننصحك باستخدام معيار RFC 3066 صالح. إذا لم يكن عنصر `<language>` متوفّرًا، تكون القيمة التلقائية `en-US`.
`<category>`	مطلوب	`InfoCategory`	يشير الرمز `<category>` إلى فئة حدث موضوع رسالة التنبيه. لتحديد الفئات المناسبة لأحداثك، يمكنك الرجوع إلى قائمة مصطلحات أحداث OASIS. يمكن أن تساعد التصنيفات المناسبة Google في عرض التنبيه للمستخدمين بدقة أكبر.
`<event>`	مطلوب	`string`	يشير العنصر `<event>` إلى نوع حدث الموضوع لرسالة التنبيه. في ما يلي متطلبات Google لعنصر `<event>`: يجب أن يكون طول العنوان أقل من 35 حرفًا. أدخِل مجموعة من أنواع `<event>` المحدّدة مسبقًا في ملف CSV أو جدول بيانات Google (اطّلِع على مثال على "جداول بيانات Google"). ملاحظة مهمة: ننصحك بشدة باستخدام قائمة أحكام أحداث OASIS وتنفيذ رمز `<event>` في القسم `<eventCode>`.
`<responseType>`	اختياري	`responseType`	للإشارة إلى نوع الإجراء المقترَح للجمهور الصحيح، عند الاقتضاء، ننصحك بشدة باستخدام عنصر `<responseType>` ، بالإضافة إلى قيمة عنصر `<instruction>` التي يتوافق معها.
`<urgency>`	مطلوب	`urgency`	لا تستخدِم القيمة "غير معروف" للعنصر `<urgency>` لأنّ هذه القيمة تصعِّب فهرسة التنبيهات والترتيبات المطلقة والنسبية. من المهم أن تعرف Google كيفية ضبط الحقل `<urgency>` ومن يضبطه. ومع ذلك، هذه المعلومات خارج نطاق الملف الشخصي الرسمي. من الأفضل أن يضبط الناشر قيمة `<urgency>` حسب كل حالة على حدة وأن يتّبع إرشادات واضحة حول عوامل التفعيل. ومع ذلك، قد يحدّد عنصر `<event>` قيمة `<urgency>`، وبالتالي يحدّ من مرونة كتاب التنبيهات. على سبيل المثال، تضبط وكالة NOAA في الولايات المتحدة مستوى العجلة بشكلٍ ثابت استنادًا إلى نوع الحدث.
`<severity>`	مطلوب	`severity`	لا تستخدِم القيمة "غير معروف" للعنصر `<severity>` لأنّ هذه القيمة تصعِّب فهرسة التنبيهات والترتيبات المطلقة والنسبية. من المهم أن تعرف Google كيفية ضبط الحقل `<severity>` ومن يضبطه. ومع ذلك، هذه المعلومات خارج نطاق الملف الشخصي الرسمي. من الأفضل أن يضبط الناشر قيمة `<severity>` حسب كل حالة على حدة وأن يتّبع إرشادات واضحة حول عوامل التفعيل. ومع ذلك، قد يحدّد عنصر `<event>` قيمة `<severity>`، وبالتالي يحدّ من مرونة كتاب التنبيهات. على سبيل المثال، تضبط وكالة NOAA في الولايات المتحدة مستوى العجلة بشكلٍ ثابت استنادًا إلى نوع الحدث.
`<certainty>`	مطلوب	`certainty`	لا تستخدِم القيمة "غير معروف" للعنصر `<certainty>` لأنّ هذه القيمة تصعِّب فهرسة التنبيهات والترتيبات المطلقة والنسبية. من المهم أن تعرف Google كيفية ضبط الحقل `<certainty>` ومن يضبطه. ومع ذلك، فإنّ هذه المعلومات خارج نطاق الملف الشخصي الرسمي. من الأفضل أن يضبط الناشر قيمة `<certainty>` حسب كل حالة على حدة وأن يتّبع إرشادات واضحة حول عوامل التفعيل. ومع ذلك، قد يحدّد عنصر `<event>` قيمة `<certainty>`، وبالتالي يحدّ من مرونة كتاب التنبيهات. على سبيل المثال، تضبط وكالة NOAA في الولايات المتحدة مستوى العجلة بشكلٍ ثابت استنادًا إلى نوع الحدث.
`<audience>`	اختياري	`string`	قيمة عنصر `<audience>` هي نص يصف الجمهور المستهدَف لرسالة التنبيه.
`<eventCode>`	اختياري	`string`	يحتوي العنصر `<eventCode>` على رمز خاص بالنظام يحدِّد نوع الحدث لرسالة التنبيه في النموذج التالي. `<eventCode>` `<valueName>valueName</valueName>` `<value>value</value>` `</eventCode>` حيث: `valueName` = سلسلة يحدّدها المستخدم لتحديد نطاق الرمز. إذا كانت هذه السلاسل عبارة عن اختصارات، يجب تمثيلها بأحرف كبيرة بالكامل بدون فواصل. تشمل الأمثلة `SAME` و`FIPS` و`ZIP`. `value` = سلسلة تشير إلى قيمة العنصر `<eventCode>`. يمكن أن تظهر نُسخ متعددة من عناصر `<eventCode>` ضمن كتلة `<info>`. ننصحك بشدة بالحصول على قيم عنصر `<eventCode>` من قائمة مصطلحات أحداث OASIS. إذا كنت تستخدِم قائمة مصطلحات أحداث OASIS، استخدِم `OET:v1.2` كاسم القيمة، كما هو موضّح في هذا المثال: `<eventCode>` `<valueName>OET:v1.2</valueName>` `<value>OET-003</value>` `</eventCode>`
`<effective>`	اختياري	`dateTime`	قيمة العنصر `<effective>` هي الوقت الذي تبدأ فيه المعلومات في رسالة التنبيه بالسريان. يجب تضمين حقول المنطقة الزمنية في جميع قيم `dateTime`. إذا كان الموقع الجغرافي المذكور في العنصر `<area>` يقع ضمن منطقة زمنية واحدة، ننصحك بأن يحدِّد العنصر `<effective>` الوقت في تلك المنطقة. يُرجى تضمين فترة زمنية للتوقيت الصيفي، إن توفّر. عندما ينطبق محتوى الرسالة على مناطق زمنية متعددة، ننصحك بأن يستخدم صانع الرسالة التوقيت العالمي المنسق بدلاً من التوقيت المحلي. مثال: يشير `2002-05-24T16:49:00-07:00` إلى 24 أيار (مايو) 2002 الساعة 4:49 بعد الظهر بتوقيت المحيط الهادئ.
`<onset>`	اختياري	`dateTime`	قيمة عنصر `<onset>` هي الوقت المتوقّع لبدء حدث الموضوع في رسالة التنبيه. يجب تضمين حقول المنطقة الزمنية في جميع قيم `dateTime`. إذا كان الموقع الجغرافي المذكور في قالب `<area>` يقع ضمن منطقة زمنية واحدة، ننصحك بأن يحدِّد العنصر `<effective>` الوقت في تلك المنطقة. عند الاقتضاء، يجب تضمين فترة التوقيت الصيفي. عندما ينطبق محتوى الرسالة على مناطق زمنية متعددة، ننصحك بأن يستخدم صانع الرسالة التوقيت العالمي المنسق بدلاً من التوقيت المحلي. مثال: يشير `2002-05-24T16:49:00-07:00` إلى 24 أيار (مايو) 2002 الساعة 4:49 بعد الظهر بتوقيت المحيط الهادئ.
`<expires>`	مطلوبة*	`dateTime`	قيمة العنصر `<expires>` هي وقت انتهاء صلاحية حدث الموضوع لرسالة التنبيه. يجب أن يأتي عنصر `<expires>` بعد عنصر `<effective>` بترتيب زمني. إذا لم تتمكّن من ضبط وقت انتهاء صلاحية لجميع تنبيهاتك، قدِّم لخدمة Google وقت انتهاء صلاحية تلقائيًا لأي تنبيهات لا تحتوي على عنصر `<expires>`. على سبيل المثال، يمكنك توضيح أنّه يتم تلقائيًا ضبط جميع التنبيهات لتنتهي صلاحيتها بعد 48 ساعة في حال عدم توفّر عنصر `<expires>`. يجب تضمين حقول المنطقة الزمنية في جميع قيم `dateTime`. إذا كان الموقع الجغرافي المذكور في العنصر `<area>` يقع ضمن منطقة زمنية واحدة، ننصحك بأن يحدِّد العنصر `<effective>` الوقت في تلك المنطقة. يُرجى تضمين فترة زمنية للتوقيت الصيفي، إن توفّر. عندما ينطبق محتوى الرسالة على مناطق زمنية متعددة، ننصحك بأن يستخدم صانع الرسالة التوقيت العالمي المنسق بدلاً من التوقيت المحلي. مثال: يشير `2002-05-24T16:49:00-07:00` إلى 24 أيار (مايو) 2002 الساعة 4:49 بعد الظهر بتوقيت المحيط الهادئ.
`<senderName>`	اختياري	`string`	عنصر `<senderName>` اختياري، ولكن ننصح بشدة باستخدامه. عندما يكون للمُرسِل اسم يمكن لشخص عادي قراءته، يمكن أن يظهر `<web>` الرابط بطريقة سهلة الاستخدام، وفقًا للإعدادات المفضّلة للناشر أو المُرسِل. بالإضافة إلى ذلك، يسمح عنصر `<senderName>` لمجمعي التنبيهات بالنشر من عدة مصادر.
`<headline>`	اختياري	`string`	يجب أن يكون طول سلاسل عناصر `<headline>` أقل من 140 حرفًا. يمكن أن تكون سلسلة `<headline>` نصًا مفتوحًا، ولكن ننصح بأن تتألف من أقل من 140 حرفًا. (يُقترح في CAP 1.2 استخدام عدد أقل من 160 حرفًا للرسائل النصية). ابدأ هذه السلسلة ببضع كلمات وصفية توضّح جوهر التنبيه. على سبيل المثال: "إغلاق جسر عائم...." لا تستخدِم القيم نفسها للعنصرَين `<headline>` و `<description>`. قدِّم تفاصيل أكثر في عنصر `<description>` مقارنةً بعنصر `<headline>`.
`<description>`	مطلوبة*	`string`	قيمة عنصر `<description>` هي نص يصف موضوع حدث رسالة التنبيه. ننصحك بتقديم محتوى غني بالمعلومات ويمكن لشخص عادي قراءته ويجيب عن هذه الأسئلة: ما الذي يحدث أو على وشك الحدوث؟ أين سيحدث ذلك؟ ما مدى سوء المشكلة؟ ملاحظة مهمة: يجب ألا تكون قيمة العنصر `<description>` هي نفسها قيمة العنصر `<instruction>`. تستخدِم Google عنصر `<description>` لتعبئة قسم الرسالة في صفحتنا، وتستخدِم عنصر `<instruction>` لتعبئة قسم الإجراءات المقترَحة . يكون كلا الحقلين مرئيَين للمستخدمين. يمكنك استخدام علامات Markdown المتوافقة التالية: `<newline>` و`<b>` و `<a href>`.
`<instruction>`	اختياري	`string`	قيمة عنصر `<instruction>` هي نص يصف الإجراءات المقترَحة لمستلمي رسالة التنبيه. ننصحك بتقديم محتوى غني بالمعلومات ويمكن لشخص عادي قراءته. يجب إدراج الإجراءات التي تتناسب مع مستوى خطورة التنبيه والتي ليست عامة. استخدِم جملًا موجزة وحساسة لحالة الأحرف، وأدرِج نصائح أمان يمكن للقراء اتّباعها، مع تقديم أهم نصيحة أولاً. عنصر `<instruction>` اختياري، ولكننا ننصح به بشدة. تستخدِم "التنبيهات العامة" من Google الحقل `<instruction>` لتعبئة قسم الإجراءات المقترَحة في صفحات تفاصيل التنبيهات. اجعل قيم حقلَي `<instruction>` و`<description>` مختلفة لأنّهما يخدمان أغراضًا مختلفة.
`<web>`	اختياري	`string`	اربط عنصر <web> بعنوان URL صالح يقدّم المزيد من المعلومات عن تنبيهك.
`<contact>`	اختياري	`string`	حقل `<contact>` اختياري، ولكن ننصح بشدة بإدراجه لأنّه يقدّم للمستخدمين طريقة لإرسال الملاحظات والردّ على التنبيه. على سبيل المثال، "في حالات الطوارئ، يُرجى الاتصال بالرقم 911".
`<parameter>`	اختياري	`string`	يحتوي العنصر `<parameter>` على بيانات متعلقة بالنظام بالشكل التالي: `<parameter>` `<valueName>valueName</valueName>` `<value>value</value>` `</parameter>` حيث: `valueName` = سلسلة يحدّدها المستخدم لتحديد نطاق الرمز. `value` = قيمة سلسلة. يمكن أن تظهر عدّة نُسخ من عنصر `<parameter>` ضمن كتلة `<info>`.
`<resource>`	اختياري	`resource`	يقدّم عنصر `<resource>` أي معلومات إضافية تكميلية ذات صلة بالعنصر الرئيسي `<info>`. يمكن أن تظهر نُسخ متعددة من عنصر `<resource>` ضمن كتلة `<info>`.
`<area>`	مطلوبة*	`area`	يحتوي العنصر `<area>` على معلومات عن منطقة التنبيه للحدث، وليس منطقة الحادث. يجب أن تتضمّن كتل `<area>` عنصرًا واحدًا على الأقل من `<circle>` أو `<polygon>` أو `<geocode>`. ننصحك بشدة باستخدام عنصر `<polygon>` أو `<circle>` بدلاً من عنصر `<geocode>`.

* تتطلّب Google العناصر التي تحمل مطلوبة باللون الأحمر الغامق، ولكن هذه العناصر اختيارية في معيار CAP.

مثال

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>

معلومات تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

info عناصر الكيانات

مثال

معلومات

`info` عناصر الكيانات