= How to Publish CAP Alerts = [[TOC]] == Overview == This section of the guide is intended for authorized users with permissions to author alerts and approve for dissemination. The cycle of authoring and issuing an alert has several work flow combinations. These combinations are [wiki:BluePrint/CAPBroker/GUIDesign#msgType illustrated as state transitions in the blueprint]. In the subsequent sections we discuss the activities of: * [wiki:UserGuidelines/SAMBRO/Publish#CreateaCAPMessage How to CREATE an alert message?] The first step when an event of interest is declared as an event that should be notified. * [# How to UPDATE an alert message?] Execute this step when an alert that was issued needs to be updates with the current status * [# How to CANCEL an alert message"] Any alert that was issued erroneously must be followed by a message to cancel the previous message * [# How to CLEAR an alert message?] Issue an ALL CLEAR after the authorities have declared to pose no threat any longer == Work Flow == A typical work flow steps for issuing an alert would be: 1. [wiki:UserGuidelines/SAMBRO/Publish#CreateaNewMessage Create a new alert] 2. [wiki:UserGuidelines/SAMBRO/Publish#SelectTemplateandEdittheALERTSegment Select a template and edit the Alert block] 3. [wiki:UserGuidelines/SAMBRO/Publish#EditINFORMATIONsegment Edit the Information block] 4. Define the alerting area; there are two options a. [wiki:UserGuidelines/SAMBRO/Publish#AssigningPredefinedArea Assigning a Predefined Alert Area] b. [wiki:UserGuidelines/SAMBRO/Publish#DrawingAlertAreaPolygon Add a new Alert Area (draw polygon)] 5. Submit the alert for review 6. [wiki:UserGuidelines/SAMBRO/Publish#AuthorizeaCAPMessage Approve or Disapprove alert for dissemination] 7. [wiki:UserGuidelines/SAMBRO/Publish#UpdateCancelorClearaCAPMessage Update or Cancel the alert] 8. Issue an All Clear alert once the threat is no longer active or has passed ==== General Advise ==== * A typical CAP message contains the following segments, which must be completed based on the your standard operating producers: '''''Alert''''', '''''Information''''', '''''Predefined Areas''''', '''''Area''''', '''''Resource Files'''''] * If you see the pair of square bracket, then those are most probably created following [wiki:UserGuidelines/SAMBRO/Implement#CreateMessageTemplate this technique]. These are actually the place holders to replaced with event specific actual information. || [[Image(http://i.imgur.com/BmpOTKi.png, alight right)]] ---- === Create a New Message === ||='''QUICK METHOD''' :: =||=Navigate to http://YOUR-DOMAIN/eden/cap/alert/create =|| [[br]] [[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/UserGuidelines/SAMBRO/Publish/sambro_create_alert.png, align=right, width=480px)]] ==== Select Template and Edit the ALERT Segment ==== 1. With your web browser, navigate to the SAMBRO website hosted by your National or Local NDMO (e.g. SAMBRO demo hosted at http://sambro.geoinfo.ait.ac.th/) 1. To create a new alert message click on the main menu '''Alerting''' and then in the sub menu item Alert select '''Create''' 1. You will be presented with first page with the option to select a '''Template''' and then edit the '''Alert Qualifier''' elements. 1. Once you select the relevant template, from the drop down list at the top, all relevant alert qualifier elements will be populated. You will have very little to edit. '''IMPORTANT''' that the Status is changed from '''''Draft''''' to another value based on your intention: Exercise, Test, System, or Actual. 1. Click the Save and Edit Information button at the bottom of the list, which will navigate you to edit the alert '''INFORMATION''' segment ---- [[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/UserGuidelines/SAMBRO/Publish/sambro_open_info_segment.png, align=right)]] ==== Edit INFORMATION segment ==== [[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/UserGuidelines/SAMBRO/Publish/sambro_info_segment.png, align=right, width=480px)]] 1. Click on the '''OPEN''' button and you will be presented with information segment form to begin editing the alert event specific information. a. Another option is to click on the '''''Information''''' tab and begin to fill the information. a. Anytime you want to view all the information blocks that belong to the particular alert, click on the Information tab a. To add another information block click on the '''Add Alert Information''' button on the top right above the list of Information blocks. a. If you see the Information block in the list, click on the '''Open''' button to begin editing and filling the information. 1. A few shortcuts to filling the information a. Click on the'''Event Type''' drop down list and select the relevant event type. If the [# Warning Priority] for that event type is defined, selecting the event type will trigger the Warning Priority drop down to be populated. Then selecting the relevant warning priority triggers the programmed '''Urgency''', '''Severity''' and '''Certainty''' field to be populated. a. You may also notice the '''Effective''' field to be populated with the current date and time and also the '''Expire''' date and time to be populated based on the [# offset defined in the configuration] 1. Remember to change the elements Headline, Description, Instruction, and any other repopulated content that has square bracket. These are place holders and should be replaced with the appropriate event specific data. [wiki:UserGuidelines/SAMBRO/Implement#CreateMessageTemplate See these instructions]. 1. After filling all the information, click on '''Save''' button at the bottom of the form. You will be redirected to the place where you started. ---- ==== Assigning Predefined Area ==== || 8 a) || Now you can begin to create area. Area can be created in two ways:[[br]]a) You can select from the [# predefined areas] under '''''Predefined Areas''''' tab according to Event and Priority. Location for this area will be the same as defined for this predefined area.[[br]]Click on '''Assign''' button(circled in image) to finish creating the area || [[Image(http://i.imgur.com/Kynjiiu.png)]] || || b) || If you click on '''''Area''''' tab, you can see the area from you just assigned. You can also see that the Information Segment for that area is not given (-). We need to tell for which information segment this area belongs to || [[Image(http://i.imgur.com/t5IXbnU.png)]] || || c) || This can be done by clicking '''Open''' button in the picture above. Then in the '''Information Segment''' field, choose to which this area is for. || [[Image(http://i.imgur.com/0RpktvD.png)]] || ==== Drawing Alert Area Polygon ==== || d) || You can also create area from the '''''Area''''' tab. Click on the '''''Area''''' tab, where you can see '''Add Area''' button on the right side of the screen. Click there and you will see a form to fill the area information for the alert. [[br]]Select for which information segment this area is because an alert can have multiple info segment.[[br]]- If you have [http://eden.sahanafoundation.org/wiki/UserGuidelines/GIS/Data GIS Data] for country, then you can choose from the hierarchy and then click '''Draw on Map''' button. This places the center and zoom of the map according to the selected hierarchy.[[br]]- If you don't have hierarchy data, simply select the Country and then click '''Draw on Map''' button and began drawing on it. || [[Image(http://i.imgur.com/RflGTeg.png)]] || || 8 || In any event, successively click then move the mouse, drawing a polygon with vertices at each click. Double-clicking ends the polygon.[[br]] Click on '''Save''' button at the end of page and area is added to the alert[[br]]To learn more about GIS in Sahana, see [http://eden.sahanafoundation.org/wiki/UserGuidelines/GIS here]|| [[Image(http://i.imgur.com/kggp0Bs.png)]] || ==== Adding Resource Files to Alert ==== 9. You can now add resource (photos, documents, etc) to the alert by going to the '''''Resource Files''''' tab and click on '''Add Resource''' button in the right side of the screen. In the '''Information Segment''' field, choose to which information segment you want to attach file. Then Click '''Choose File''' and browse through your computer to upload the file [[br]] [[Image(http://i.imgur.com/Yjxcu0a.png)]] === Authorizing and Approving a CAP Message === Any CAP Message must be authorize before publishing, posting or dissemination. Normally people with 'Alert Editor' role will create the CAP message and then send for approval to the people with 'Alert Approver' role.[[br]] After you (people with Alert Editor role) [#CreateaCAPMessage Create a CAP Message] , you can see 'Submit for Approval' button at the top. When clicked, it will send Email and SMS to the people with the 'Alert Approver' with a link to approve or reject the message. [[Image(http://i.imgur.com/xfga6VX.png)]] [[Image(http://i.imgur.com/6TRnGkm.jpg)]][[BR]][[BR]] Email and SMS notifications are received by the Approvers.[[BR]] [[Image(http://i.imgur.com/Ewf4MAQ.png)]] ---- === Relaying Alerts === The following alerts can be relayed.[[BR]] 1. External Message (alert coming from in alert hub) and, 1. Internal Message (alert created by other organisation) can be relayed by the CAP Editor from different organisation. NB: External alert are not disseminated to the subscribers unless those alert are relayed. Once you open the alerts that can be relayed, you can see a '''Relay Alert''' at the top. [[Image(http://i.imgur.com/V4yVp12.png)]] ---- === Update, Cancel or Clear a CAP Message === This process follows the state transition and allowable sequences discussed in the [http://eden.sahanafoundation.org/wiki/BluePrint/CAPBroker/GUIDesign#msgType SAMBRO GUI Blueprint for MsgType] [[br]] * Approved alerts that originated from the same organisation as the current user can be updated, canceled or error the previous alerts. * An event (like cyclone) can have different speed, direction etc according to time, and for this purpose the previous alert need to be updated to give the current information on the event. * Or sometimes some parameters may be mistaken in previous alerts which are the error alert and sometime the event may get canceled.[[BR]] [[Image(http://i.imgur.com/gMaY640.png)]]