Create a Policy Notification

Complete the task Create a Destination Notification before you complete these steps.

  1. Click [System] → [Notification] → [Policies]

  1. In the Policy tab, click [Add].

  2. Enter the name of the policy. The name must not be a duplicate of the existing policy notification.

  3. Select the Definition Type. Select one of the following types:

    • Polling – Configure discovery notification settings for when to send notifications and how they are sent.
    • Discovery – Configure polling notification settings for when to send notifications and how they are sent.
  1. Select the destination you created with Service Now URL as type.

  2. Click Save. Clicking save will create the policy notification. You can find the notification properties on the tabs.

  3. Go to the Triggers tab and select the triggers for this notification.

    Items

    Triggers

    Errors

    Select from the following the type of errors you want to specify as Simple Criteria:

    • [Select All] – Checks all errors.

    • [No Toner/Ink]

    • [Paper Misfeed]

    • [Call Service]

    • [Cover Open]

    • [Device Access Violation]

    • [No Paper]

    • [No Response]

    • [Original Misfeed: ADF]

    • [Fax Transmission Error]

    • [Error]

    Warnings

    Select from the following the type of warnings you want to specify as Simple Criteria:

    • [Select All] – Checks all warnings

    • [Offline]

    • [Toner/Ink Almost Empty]

    • [Alert]

    • [Replace/Supply]

    • [Maintenance]

    • [Busy]

    • [Almost Out of Paper]

    • [Energy Saver Mode]

    • [Warming Up...]

    Advanced Criteria checkbox

    When is checked, the simple criteria screen changes to the advanced criteria screen. By using variables on the Advanced Criteria screen, you can configure more detailed notification criteria. You can only configure either Advanced Criteria or Simple Criteria.

    All selections made in Simple Criteria will be removed if you choose to use Advanced Criteria.

When the devices in the Monitored Devices tab experience at least one of the selected errors or warnings and the conditions are met, a notification is sent to the recipients.

  1. Click the Conditions tab to specify the conditions.

    Conditions

    Triggers

    Block if not Settled

    If checked, it disables repeated notifications in the specified period. Specify the interval using the following units:

    [Time Interval]: [day(s)], [hour(s)], [minute(s)], [month(s)], [second(s)], [year(s)]

    Notify only if criteria is repeated within specified time interval

    If checked, a notification is sent only when the specified status occurs for the specified number of times during the specified period.

     

    Required settings:

    [Repeat Count]: Specify the number of repetitions.

    [Time Interval]: [day(s)], [hour(s)], [minute(s)], [month(s)], [second(s)], [year(s)]

    Notify only if criteria is sustained for

    If checked, a notification is sent only when the specified status continues for the specified duration.

    Required settings:

    [Time Interval]: [day(s)], [hour(s)], [minute(s)], [month(s)], [second(s)], [year(s)]

    Resend Notification

    If checked, a notification is sent again after the specified time has passed.

    Required settings:

    [Time Interval]: [day(s)], [hour(s)], [minute(s)], [month(s)], [second(s)], [year(s)]

    Notify on cleared conditions

    A notification is sent when the notified status is resolved.

  1. Click the Message tab and define how the Incident is created in ServiceNow.

    1. By default, a message is created, click the message to edit it. You can also create a new message item if you want.
    2. Specify the Subject of the message. The subject will be stored as short_description in ServiceNow incident table.
    3. Specify the Body of the message. The body will be stored as comments in ServiceNow incident table.

      Message body cannot be greater than 1024 characters. Returns, extra spaces, tabs count as characters. Removing additional characters will not affect the application.

  1. Add the <servicenow>….</servicenow> xml structure to the Body. All data outside of the XML structure will be stored as comments in ServiceNow incident table, while data inside the <servicenow>….</servicenow> xml structure will populate the other fields in the ServiceNow incident table.

    An example is shown below:

    Add the following string at the end of the body.

    <servicenow>

        <param>

            <impact>1</impact>

            <urgency>1</urgency>

            <priority>1</priority>

        </param>

    </servicenow>

     

    A screenshot of a computer

Description automatically generated with medium confidence

    In the above example, the ServiceNow fields: impact, urgency, and priority are set to value = 1.

    The above tags inside the <param> … </param> are the ServiceNow field names, not the display names on the form.  To determine the proper field name, go to the ServiceNow interface and under “System Definition” click Tables. Search for the word “Incident”.  Click on the field name, use the value in the “Column Name” Field.

    This is another example:

  2. <servicenow>

        <param>

            2    <requested_by>Ricoh</requested_by>

            3    <requested_for>Ricoh</requested_for>

            4    <u_business_unit>ABC Corporation</u_business_unit>

            5    <description>Error Notification ($[device.dev_status_printer]$ : $[device.displayname]$)</description>

            6    <impact>1</impact>

            7    <urgency>1</urgency>

            8    <priority>1</priority>

            9    <cmdb_ci>Enterprise Print Services</cmdb_ci>

            10    <u_subtype>Hardware Failure</u_subtype>

            11    <assignment_group>Service Desk/MPS</assignment_group>

            12    <u_alert>true</u_alert>

            13    <contact_type>event</contact_type>

        </param>

    </servicenow>

    When the incident is created, the following will be displayed in the incident table.

    A screenshot of a computer

Description automatically generated with medium confidence

    The Subject of the message is treated as 1 Short description. The above screenshot is for example only, your actual ServiceNow format may differ from the example provided.

  1. After modifying the message, click Save.

  2. Click Monitored Devices tab and the devices or group you want to keep track.

If the device or groups selected in this step encounters the triggers set in Step 7 and conditions in Step 8 are met, an incident will be created based on the field value specified in the message setting in Step 9.

  1. After making all necessary changes, click Save.