cảnh báo

Để xác định thông tin cơ bản về một sự kiện hiện tại, hãy sử dụng thực thể <alert>.

Nếu một sự kiện chiếm nhiều vị trí đang diễn ra cùng một lúc, tốt hơn là bạn nên chia sự kiện đó thành nhiều đối tượng alert. Ví dụ: nếu một đám cháy rừng trải dài trên nhiều tiểu bang, bạn có thể chia cảnh báo thành nhiều cảnh báo, mỗi cảnh báo cho một tiểu bang. Bằng cách đó, bạn cung cấp thông tin khẩn cấp cụ thể cho từng tiểu bang và cập nhật tình hình cháy rừng chính xác hơn.

Nếu một sự kiện thay đổi nhanh chóng, chẳng hạn như một cơn bão di chuyển từ đông sang tây, thì bạn nên cập nhật định kỳ cảnh báo. Đừng xoá cảnh báo hiện có khỏi nguồn cấp dữ liệu. Thay vào đó, hãy đưa ra một cảnh báo mới tham chiếu đến cảnh báo trước đó.

Thuộc tính

Bảng 1 mô tả giá trị thuộc tính cho thực thể <alert>:

Bảng 1. Thuộc tính thực thể <alert>

Tên phần tử Không bắt buộc Loại Mô tả
xmlns:cap BẮT BUỘC string

Thuộc tính xmlns phải tham chiếu đến CAP URN làm không gian tên.

Ví dụ:

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

Thành phần

Bảng 2 mô tả các giá trị phần tử con cho thực thể <alert>:

Bảng 2. Phần tử thực thể <alert>

Tên phần tử Không bắt buộc Loại Lưu ý và yêu cầu của CAP và Google
<identifier> BẮT BUỘC string Cung cấp mã của cảnh báo đại diện cho sự kiện. Giá trị của phần tử <identifier> phải là duy nhất trên tất cả các sự kiện.
<sender> BẮT BUỘC string Phần tử <sender> xác định nguồn gốc của cảnh báo. Tên không được chứa dấu cách, dấu phẩy hoặc ký tự bị hạn chế.
<sent> BẮT BUỘC dateTime

Nếu vị trí được trích dẫn trong khối <area> nằm trong một múi giờ, hãy sử dụng phần tử <sent> để chỉ định thời gian trong múi giờ đó. Khi có thể, hãy thêm khoản chênh lệch cho giờ mùa hè.

Khi nội dung của một thông báo áp dụng cho nhiều múi giờ, hãy ưu tiên sử dụng giờ UTC thay vì giờ địa phương.
<status> BẮT BUỘC AlertStatus

Google chỉ phát hành các cảnh báo có sẵn công khai có giá trị phần tử <status> là Actual.
<msgType> BẮT BUỘC AlertMsgType

<msgType> UPDATE hoặc CANCEL phải bao gồm ít nhất một phần tử <references>. Tiêu chuẩn CAP chỉ định những nội dung sau:

  • Mọi thông báo cảnh báo cập nhật cảnh báo trước đó đều sử dụng UPDATE và đặt giá trị phần tử <references> thành tất cả thông báo trước đó chưa đến ngày <expires>.
  • Phần tử UPDATE hoặc CANCEL <msgType> phải áp dụng cho một cảnh báo chưa hết hạn. Do đó, tất cả thông báo liên quan và cảnh báo chưa hết hạn phải được tham chiếu khi phát hành UPDATE hoặc CANCEL <msgType>.

Để biết thêm thông tin, hãy xem phần Thay đổi hoặc hết hạn sự kiện.
<source> KHÔNG BẮT BUỘC string Phần tử <source> biểu thị nguồn cụ thể của cảnh báo. Ví dụ: nhà mạng hoặc một thiết bị cụ thể.
<scope> BẮT BUỘC AlertScope

Phần tử <scope> biểu thị phạm vi phân phối dự kiến của thông báo cảnh báo.
<restriction> CONDITIONAL string Nếu giá trị phần tử <scope> là Restricted, thì bạn bắt buộc phải có phần tử <restriction>. Phần tử này mô tả quy tắc để giới hạn việc phân phối thông báo cảnh báo bị hạn chế.
<addresses> CONDITIONAL string Nếu giá trị phần tử <scope> là Private, thì bạn bắt buộc phải sử dụng phần tử <addresses>. Phần tử này liệt kê người nhận dự kiến của thông báo cảnh báo. Bạn có thể thêm nhiều địa chỉ được phân tách bằng dấu cách, nhưng bạn phải đặt các địa chỉ có khoảng trắng trong dấu ngoặc kép.
<code> KHÔNG BẮT BUỘC string

Phần tử <code> biểu thị cách xử lý đặc biệt của thông báo cảnh báo.
<note> CONDITIONAL string

Nếu cảnh báo chứa một trong các giá trị phần tử sau, thì bạn bắt buộc phải có phần tử <note>:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> CONDITIONAL string

Nếu giá trị phần tử <msgType> là UPDATE hoặc CANCEL, thì bạn bắt buộc phải có phần tử <references>.

Khi hệ thống của bạn phát hành lại nội dung CAP của một nhà xuất bản khác, hãy đưa vào cảnh báo CAP đầy đủ. Để liên kết nội dung đã chỉnh sửa với nguồn gốc, hãy sử dụng thẻ <references>.

Nếu bạn tham chiếu nhiều thông báo, hãy sử dụng dấu cách làm dấu phân cách.
<incidents> KHÔNG BẮT BUỘC string Phần tử <incidents> tổng hợp nhiều thông báo đề cập đến các khía cạnh khác nhau của cùng một sự cố.
<info>

BẮT BUỘC*

 info Bạn phải có ít nhất một phần tử <info>. Nhiều khối <info> phải có cùng giá trị phần tử <category> và <event>.

* Google yêu cầu các phần tử có dấu BẮT BUỘC in đậm và màu đỏ, nhưng các phần tử đó không bắt buộc theo tiêu chuẩn CAP.

Ví dụ:

<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>