ChangeDeadline

This function sets a deadline for some case processing for specified user. If the case has already its deadline set as a result of stage settings it is overriden for that user only. List of users who are to be notified if deadline is exceeded may also be provided. To calculate a new deadline the date of the case being forwarded to the current stage is used as a starting point.

Syntax

ChangeDeadline(TimeUnits,TimeUnitsCount,RemindHoursBefore,RemindOnDayAndAfter,EscalateHoursBefore,
EscalateOnDay, EscalateAfter, ReminderUser, EscalateToUsers);

Function arguments

• TimeUnits – (String) specifies whether the second function parameter should be interpreted as day count, or hour count, or as date value directly (i.e. from date/time field on a form). ALLOWED VALUES: [ hours | days | date ];
• TimeUnitsCount – (Decimal) specifies how many units of time are to be added to the case forwarded date to calculate new case deadline;
• RemindHoursBefore – (Decimal) specifies how many hours before the deadline a user is to be notified about it;
• RemindOnDayAndAfter – (Boolean) specifies if a user should be reminded about the case deadline on the begining of workday when the deadline exceeds and every following day;
• EscalateHoursBefore – (Decimal) specifies how many hours before users should be notified about the fact that the case is still not processed;
• EscalateOnDay – (Boolean) specifies if users should be notified about the case deadline on the begining of the workday when the deadline exceeds;
• EscalateAfter – (Boolean) specifies if users should be notified about the case deadline on every day after the deadline exceeded;
• ReminderUser – (String) [optional] specifies which user this deadline applies to. If not specified the new deadline will be set for all case users;
• EscalateToUsers – (String) [optional] specifies list of users (separated with ’;’) who are to be notified when any of 'Escalate’ settings specify so.

Return value

This function returns Boolean.
Returns true if the new deadline was set correctly, false otherwise.

Examples

Example 1

This will set deadline to the end of 2 full business days since the case forwarded date for user with login 'some_user’ and notify managers with logins 'manager1′ and 'manager2′.

ChangeDeadline("days", 2, 3, true, 1, false, false, "some_user", "manger1;manager2");

Example 2

This will set a deadline to the date specified in the [deadline date] form field for user with login 'some_user’ and notify managers with logins 'manager1′ and 'manager2′.

ChangeDeadline("date", [deadline date], 3, true, 1, false, false, "some_user", "manger1;manager2");