Working with Incident Communications

Incident-specific messages enable agency staff maintain correspondence regarding the progress of incidents.

Agency users can send emails and notifications associated with a specific incident on the Communication page. Agency staff can view the incident communication record. Responsible parties can access and respond to web forms sent to them by using the link in the communication.

You can configure the Business Rules Framework to trigger the generation of a communication to the designated users. For more details, see Business Rules Framework Overview and Setting Up Business Rules.

Sending Incident Communication

  1. From the Permitting and Licensing homepage, click the Incidents tile to view all the incidents in the system.

  2. Select an incident on the Incidents list page.

  3. Click Communication in the left navigation bar.

  4. On the Communication page, click Add.

  5. On the New ad hoc message page, enter values for the following fields:

    Page Elements

    Definition

    Channel Type

    Specify what type of ad hoc message you want to send. Values are:

    • Email: Generates an email that is sent to users.

    • Emails and Notifications: Generates both an email and a notification with the same message.

    • Notification: Generates a notification that appears when users click the notification icon in the application.

    Note:

    The fields that are available to define on this page vary depending on the channel type and display format that you select.

    Visibility

    Select which users can see the message. All communications can be viewed by agency staff. Values are:

    • Agency staff only

    • Primary responsible party

    • All responsible parties

    Display Format

    Select the format of the message. Values are:

    • HTML

    • Text

    Note:

    This field does not appear for the Text channel type.

    Create Web Form

    Click to open the Web Form drawer where you create a questionnaire that you can insert into your message.

    To

    Click the + button to view the Insert into the To field drawer from which you can search for and select recipients. The display shows the options and the count of values available, which are determined by the transaction you are working with and the channel type you selected in the Message Attributes section.

    For example, when you select a value here for the email channel type, the email ID is inserted into the field. You can delete the ID using the X icon, but you cannot edit it.

    Enter the email address, user ID, or phone number of the person or organization to whom you want to send the message.

    Note:

    Enter email addresses for emails, user IDs for notifications, and phone numbers for texts.

    Cc and Bcc

    Enter or click + and select the email addresses of the people or organizations that you want to receive a copy or blind copy of the message.

    Note:

    These fields appear only for the Email and Emails and Notifications channel types.

    From

    Enter or click + and select the email address, user ID, or phone number of the person or organization who is sending the generated message.

    For text messages, select the phone number of the person or organization who is sending the generated text message from the drop-down list. The available numbers come from a third-party messaging service.

    Note:

    Enter email addresses for the Email and Emails and Notifications channel types, user IDs for the Alert, Emails and Notifications, and Notification channel types, and phone numbers for the Text channel type.

    Subject

    Enter a brief description of the purpose and content of the message or click + to select attributes to include.

    Note:

    This field does not appear for the Text channel type.

    Message Body

    Enter the main body text of the message.

    For the Text channel type and emails and notifications with the Text display format, you can enter only plain, unformatted text.

    For the HTML display format, you can enter rich text, links, and images.

  6. Click Send.

Communicating Using a Web Form

You can create and send emails or notifications that contain an online form with questions for the responsible party or other agency staff. The correspondence contains a link that the recipient can use to access and respond to the questionnaire. A recipient must sign in before opening the web form. The application validates access using the recipient identity and the communication visibility.

Here’s how to create a web form:

  1. On the Communication page, click Add.

  2. Enter values for the channel type, visibility, and the To, From, and Subject fields. Select a visibility value that corresponds to the intended recipient: All responsible parties, Primary responsible party, or Agency staff only.

  3. Click Create Web Form.

  4. Select a Reply-To address.

  5. For each row of the web form, enter the Question Text and the Answer Type you expect from the recipient. You can select from these answer types:

    Answer Type

    Description

    Attachment

    Enables the recipient to attach one file per question.

    After the recipient uploads the file and submits the form, attachments are available in the web form response and on the incident Attachments page.

    Date

    Enables the recipient to answer the question using a calendar to indicate the date.

    Text

    Enables the recipient to enter text in response to a question.

    Number

    Enables the recipient to enter a numeric value of up to 13 digits and three decimal places.

  6. From the Action column, click the check mark to add the question. Use the x mark to clear the Question Text and Answer Type fields. You can also use the button to remove a question row.

  7. Click OK to save the questionnaire and return to the ad hoc message page. The Create Web Form button displays the number of questions in the web form.

  8. Click Send.

When the recipient opens the link, the recipient can respond to the questions and upload files. A responsible party can respond only when the person is associated with the incident and is included by the selected visibility. Agency staff can respond to a web form sent with Agency staff only visibility. A web form is read-only for users who are not eligible to respond. After submission, the response appears on the Communication page and attachments are listed on the Attachments page.

Viewing Incident Communications

The Communication page displays a list of all messages that are associated with the incident, including emails, notifications, and web form responses.

  1. On the Communication page, you can view the message reference ID, date and time the message was sent, message subject, channel type, and status, such as Sent.

  2. For each row on the Communication page, click the Actions icon to resend, forward, or view details of the message.

    • Select the Resend action to access the message in the Message details page in the display-only mode. Click Resend to send the message another time to the same list of recipients.

    • Select the Forward action to access the message in the Message details page. Enter the new recipient email addresses, update the message, if necessary, and click Forward to send the updated message to the new recipients.

    • Click the View More Details button to access the message in the Message details page and view detailed information about the message.