General Information on Triggers in HelpDesk for SharePoint¶

Triggers List¶

Location

Navigate to the settings using navbar.

Then click the Triggers tab. Here you can find the list of the pre-defined notification triggers. All of them are active but you can uncheck this option in trigger’s configuration menu.

Manage the List

As on any SharePoint list, you can create new items (a new item link) and get access to a quick edit mode (an edit link) to change some of triggers properties without opening each one separately. For example, you can deactivate some of the triggers that you don’t need. When you have done with editing, just click a Stop link.

Configuration Menu¶

To get to the configuration menu, create a new trigger or open an existing one. Let’s look over a built-in trigger called “Notification: Requester – Ticket resolved”. It sends a notification to a requester when the ticket status is changed to “Solved”.

In the configuration menu, you can find the following elements:

Checkboxes

In this example, the trigger is active and all its runs will be logged into history tab of the tickets which are affected by it.

Trigger Name

The name you choose for a trigger. You can implement some pattern in naming of them. In this case, the one can be described as: “Type of Action: Object of Action - Case”.

Execute when

The event that raises the actions.

Order

This field helps to control triggers execution order which is ascending.

If the condition is true

The condition block that determines whether the actions have to be executed. You can add conditions or groups of them using “And”/”Or” logical operators. After configuring the condition block, it can be checked by clicking a “Validate” button that allows to avoid syntax mistakes.

Actions to perform

The list of actions that have to be executed on the specified event if the result of condition checking meets “true”. You can set several actions of different types there.

Save

Clicking the button saves all changes you made and leave you on the same page of current trigger configuration menu.

Close

Clicking the button redirects you to the triggers list without saving any changes.

Show logs

Clicking the button displays a field with logs which contain the information about runs of the trigger.

Events¶

Events determine not only when to run triggers but also what properties (field values) are available for usage in the condition block and what actions are accessible to perform.

Ticket has been created

This event gives you access to the current version of ticket.

Ticket has been changed

On this event, you can access the current and previous versions of ticket.

Comment has been created

Here you can refer to properties of the created comment and of the current version of ticket. Also, you can use action “Change comment type to private” only on this event.

Conditions¶

Conditions determine whether the actions have to be executed. They support references to fields of the current item (ticket or comment) by their internal names. For example, [Ticket.Title] returns the value of the Title field that a current version of ticket has. So you can access field values of the ticket or comment using syntax: [Item.InternalFieldName]. There is a number of operators and functions available in conditions. You can make sure that your condition is valid by clicking “Validate” button. If it is not, you will notice an alert message.

Let’s take a look on the condition from the screenshot above:

The condition literally says: InternalStatus is changed and InternalStatus is equal to “Solved”. InternalStatus is an internal name of a column on the “Tickets” list.

Note

You may notice that we have used InternalStatus column instead of Status column in this example. There is actually a separate list of ticket statuses with display names and internal names. We recommend to use InternalStatus in conditions, as it is internal ticket status name, which should not be changed in future. To get more information about it read this article.

For more details see condition syntax.

Actions¶

To add a new action click the “Add new action” link.

There are following types of actions:

1. Send Email

2. Start Workflow

3. Set Field

4. Change Comment Type to Private

The list of actions may contain multiple actions which will be executed sequentially one by one starting from the top. To reorder actions, drag the action header and drop it to desired place.

In the block of actions, you can enter arbitrary values without quotes or use context tokens. The tokens allow you to get values that already exist, and they have the same syntax as the properties in the condition block, but instead of brackets, double braces are used. So the token syntax looks like {{Item.InternalFieldName}}.

Find the complete description of the context tokens and snippets.

Logs¶

You can unfold logs about each trigger run by ckicking the “Show logs” button. They contain results of condition checking and action performing. Logs are useful to control triggers and can be exported as a text file. It will contain not only the infromation about trigger runs but also its configuration. So if you are going to contact support on any issues related to triggers, it has sense to attach the file with logs. Here is an example of unfolded logs in the trigger configuration menu.