Fieldcode Manual

Tip: You can use filters for better results

What is the difference between conditions and indications?
  • Conditions are mainly used for time-based events of tickets.
    Example: Display a warning condition, when the due date is coming closer.
  • Indications are mainly used for identifying duplicated ticket events.
    Example: Display an info indication on new tickets with the same CNE.

Conditions can be set up and determined according to the project’s requirements. When a ticket reaches a defined condition (status) that you have configured with the help of the monitored field, warning signs and/or critical signs can be triggered for the ticket inside Work place. To decide when a condition should trigger, you configure so-called thresholds.

Inside the Admin panel go to Automations → Conditions.

Conditions are used for highlighting tickets. Therefore they are displayed as warnings and critical alerts inside the Ticket Pool in the Info/Alert/Part column. Configured conditions are also visible in the header of Ticket details, in the Condition tab (under the Overview tab in the Ticket details). 

What is the basis for calculating the date/time for conditions?

If user-defined work hours are configured for the calculation (Users -> Working Hours tab) the user-defined work hours will be the basis for calculations.
Example: User John McNeill works from 09:30 to 17:30 from Monday to Friday. The condition (eg. warning/critical) is set to 720 minutes (12 hours). The ticket is placed at 10:00. 17:30 is the "cut-off" time. The pre-calculations continue from the next day on to reach the 12 hours. The ticket displays the condition (eg. warning/critical) at 10:30 the next day. Bank holidays are considered in the calculation (if configured), and so are the weekend days (if configured).

If the admin has an SLA Profile configured (Process -> SLA Profiles) the SLA Profile will be the basis for calculations.
Example: Warning timer 15 minutes, Critical timer 30 minutes. The warning is due on Friday at 14:50 and the Critical is due at 15:05. As the Critical timer exceeds the SLA Profile operational time, the critical warning will be displayed on Monday at 07:05 instead of 15:05.

  • Active toggle: Gives you the option if your new condition should be already active in the system after creation or not.

  • Name field: Enter a name for your new condition.

  • Description field: Try to enter a description which describes what your condition will do. Try to be as precise as possible.

  • Project name dropdown: Select the project for which this condition should be active.

  • Monitored field dropdown: The condition time frame starts from this selected time event. The “Understanding the monitored fields” section explains all the time events.

  • Warning timer field: Insert a time frame after which the warning alert should trigger.

  • Time unit dropdown: Gives you the option to switch between minutes, hours, and days.

  • Critical timer field: Insert a time frame after which the critical alert should trigger.

  • Time unit field: Gives you the option to switch between minutes, hours, and days.

  • Enable SLA Profiles toggle: If enabled, the warning and critical timer are calculated based on the business hours of the SLA Profile. By default calendar das are used.

  • Ticket status dropdown: Gives you the option to make your newly created condition dependent on ticket status.

Monitored field nameExplanation
Fixed appointment end timeEg. 24th Dec. 2020 17:00 - Time stamp of fixed ending appointment time. (Agreement with the customer!)
Fixed appointment start timeEg. 24th Dec. 2020 08:00 - Time stamp of fixed beginning appointment time. (Agreement with the customer!)
Due dateEg. 24th Dec. 2020 23:59 - Time stamp of ticket's due date. The ticket should be solved before this time.
Ticket creation timeEg. 24th Dec. 2020 10:01 - Time stamp of when the ticket was created
Ticket status entry timeEg. 24th Dec. 2020 10:03 - Time stamp of when a ticket has entered a selected status
Dispatch appointment end timeEg. 24th Dec. 2020 13:15 - Time stamp of dispatch appointment end time. (Agreement with the engineer!)
Dispatch appointment start timeEg. 24th Dec. 2020 12:15 - Time stamp of dispatch appointment start time. (Agreement with the engineer!)
Monitored fieldIllustrationExplanation
Ticket creation timeCounts outgoing from the creation time. To make the warning condition appear first, set the critical time higher than the warning time.
Ticket status entry timeCounts outgoing from the status time. To make the warning condition appear first, set the critical time higher than the warning time.
Fixed appointment start timeCounts outgoing from the fixed appointment start time. To make the warning condition appear first, set the critical time higher than the warning time.
Fixed appointment end timeCounts towards the fixed appointment end time. To make the warning condition appear first, set the warning time higher than the critical time.
Dispatch appointment start timeCounts outgoing from the dispatch appointment start time. To make the warning condition appear first, set the critical time higher than the warning time.
Dispatch appointment end timeCounts towards the dispatch appointment end time. To make the warning condition appear first, set the warning time higher than the critical time.
Due dateCounts towards the due date. To make the warning condition appear first, set the warning higher than critical.
  1. Click on the Plus button to open the New Condition form (or click on an item in the list to edit it).
  2. Decide if your new or existing condition should be set to active in the system.
  3. Enter a name for your new or existing condition.
  4. (Optional) – Enter a description for your new or existing condition.
  5. Select a project from the drop-down for which the condition should be applied.
  6. Enter a time in minutes, hours, or days in the Warning timer field.
  7. Enter a time in minutes, hours, or days in the Critical timer field.
  8. Decide if you want to apply the SLA Profile calculation for your condition.
    Please note that you can apply the SLA Profile calculation for each condition individually.
  9. Select a Monitored Field from the drop-down. The timers will use this field as a reference.
    Please understand the monitored fields first and how conditions behave, before configuring your condition.
  10. (Optional) – You can make your condition dependent on ticket status by selecting a status in the Ticket status field.
  11. Click Save.
Creating a new condition

You can extend conditions with additional checks by using the Advanced tab inside the Condition editing form. Extending a condition means giving it more/other triggers to actually initiate. For example, you can run additional checks to monitor the SLA field and/or Subcategory field with personalized warnings and critical timers.

  1. Open an existing condition from the list by clicking on the condition itself.
  2. Go to the Advanced tab.
  3. Add one or more extensions according to your use case.
    You can use minutes, hours, or days as timer values.
    Please attend the condition behavior rules when configuring the values.
Benefits of extending conditions

You have a condition that gives out warning and critical alerts in Work Place when a ticket sits too long in Appointment status. You now want to extend that condition for tickets of a certain project to also consider Service Level Agreements like being worked on after one business day at the latest. Therefore you would add that condition by toggling the SLA switch on and selecting 1BH. Then you set the warning timer and the critical time to your wished thresholds. You could also narrow that particular condition down to also consider only a certain subcategory. With this precise configuration, your condition would trigger with the settings in the Basic as a base always and also in case the conditions of the Advanced tab are met.

Extending existing conditions
Was this topic helpful?
5 out of 5 stars

1 rating

5 Stars 100%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
5
How can we further improve this topic?
Please provide the reason for your vote. This will help us improve this topic.
Navigation