Create a control

To create a control object:

  1. Go to Menu> Control > Control. A list of existing controls is displayed.
  2. Click on the Add button icon green plus sign to create a new Control. A new document opens and the Description tab displays.
  3. Enter values for the following fields:
  4. Field Description
    Name A unique identifier for the Control object.
    Description A user-friendly label for your Control that is displayed across the GUI. The description can be internationalized (translated into the language defined for each user) using the Internationalization tab.
    Report

    The report on which to monitor the values of a data field. The email is sent based on these values.

    This report can also be attached to the email in PDF or Excel format.

    Field Name The name of the field in the report used as the condition for triggering the email. This must be a numeric field.
    Entity Owning entity (see User access managment), a container with which the Control is associated. This choice will impact the access rights for this Control.
    Thresholds Choose a type of threshold with a certain color code by clicking the threshold icon. The different colors are associated with different types of messages: green for information, yellow for warning, and red for alert. The horizontal lines on the colored arrow represent the thresholds for which you can specify values in the associated text fields to the right of the arrow.
    Comments Add a comment to the control. This comment is visible to users of the control.
    Remove information lines If this option is checked, the information lines from the threshold (the values that in the green interval) are removed from the report, whether exported in PDF or Excel format.
    Version The version number of the Control object. Sentinel increments this number when the object is saved. This value is used during XML export and import. See Import and export objects.
  5. Click the Schedule tab.
  6. Specify whether the task associated with the control execution is a Master task or a Child task.
    • Master task- has an execution defined (CRON or frequency).
    • Child task - The execution of a Child task depends on another task. In the task manager, the Child task is displayed under the Master task.
    • For a Child task, two fields must be completed:
      • Parent task: The reference task
      • Run when: Use the selection list to choose the execution condition from the following:
        • Parent Task OK
        • Parent Task Ok/Warning
        • Parent Task Ok/Warning/Error
        • Parent Task Warning
        • Parent Task Warning/Error
        • Parent Task Error
  7. Fill in the fields to establish a schedule for when the control is executed.
  8. Field Description
    Task group Select a task group for this Control object. If you do not have one, you can create one in the Task group section in Main menu > Task.
    Cron expression

    Use a standard cron expression to specify the schedule for this Control. Cron is an operating system utility used to execute commands at scheduled times.

    For example, the cron expression can be0 30 1 * * ? and it means launch at 1h30 every day.

    Available for a master task only.

    Time zone Select the time zone for the Start date and End date fields.
    Start date and End date

    The start date and end date for the execution of this Control.

    Available for a master task only.

    Frequency and Time unit

    The periodicity and the unit of measure for the execution of this Control. This is an alternative to the Cron expression. One of the following time units can be associated to the frequency: day, hour, minute, month, week.

    Available for a master task only.

  9. Select the Message tab and compose the message to be sent. Specify the users to receive the message. Specify values for the following fields:
  10. Field Description
    Send to users with access to this control If you check this option, then all the users with access to this Control will receive the message.
    Send to additional users Select specific message recipients out of the Web Dashboard existing users.
    Send to additional email addresses

    Use this option in order to send emails to addresses that do not correspond to Web Dashboard users. Once you check this, two other fields will get enabled and you will need to:

    • add the email addresses in the "Additional email addresses (separated by new line)" box
    • select a Message Type. This is mandatory, as the message type object is keeping all the message provider information.
    Note   This option is available starting with 4.2.0 Service Pack 9.
    Subject

    Displays as the subject of your email or SMS. This information can be contextualized. For details, see the following field, Message.

    Message

    The body of the email or SMS.

    This information can be contextualized when you:

    • Create personalized fields for system information. The value of a personalized field, or default value (if the value is not set), should be the desired system variable (for example, {s:now}). See Sentinel Web Dashboard User Guide, Advanced Setup for a list of the system variables.
    • Add each personalized field in the body of the email. Choose it from the drop list found to the right of the Message box or type it ({p:pers_field_name}).

    Attachment Specify whether you want to have the the Report selected in Description tab attached to the email as PDF or Excel file.
    Attachment name

    The custom name of the attachment.

    If nothing is written in this edit-box, the default name will be used: <report name><timestamp>.<type of the file>.

    This information can be contextualized. For details, see the Message field.

    Note   This field is available starting with 4.2.0 Service Pack 8.
    Message sending policy Use this matrix to set the conditions under which your message will be sent. If you select a check box, your message will be sent if that condition is met. Each condition evaluates both the initial and the final state of the report. If you do not select any check boxes, no message will be sent. If you select all the check boxes, a message will be sent each time the Control is executed.
  11. Optionally, go to the Internationalization tab and specify an international value for the object description, message subject and message body. The values you specify here will be used throughout the GUI.
  12. Select the Save button to save your object.

Related Links