ChangeDeadline

Zastosowanie

Funkcja ChangeDeadline ustawia termin realizacji sprawy dla wskazanego użytkownika. Jeżeli sprawa ma już termin wynikający z ustawień etapu, funkcja nadpisuje go tylko dla tego użytkownika. Możesz też podać listę użytkowników, którzy dostaną powiadomienie, gdy termin zostanie przekroczony.

Nowy termin jest liczony od daty przekazania sprawy na bieżący etap.

Składnia

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

Argumenty

Argument	Typ	Wymagany	Opis
`TimeUnits`	tekst	Tak	Określa, jak funkcja ma traktować drugi argument: jako liczbę dni, liczbę godzin albo bezpośrednio jako datę (np. z pola daty i godziny na formularzu). Dozwolone wartości: `hours`, `days`, `date`.
`TimeUnitsCount`	liczba	Tak	Liczba jednostek czasu dodawana do daty przekazania sprawy, z której powstaje nowy termin realizacji.
`RemindHoursBefore`	liczba	Tak	Ile godzin przed terminem użytkownik dostanie przypomnienie.
`RemindOnDayAndAfter`	wartość logiczna	Tak	Czy użytkownik ma dostawać przypomnienie na początku dnia roboczego, w którym mija termin, i w każdy kolejny dzień.
`EscalateHoursBefore`	liczba	Tak	Ile godzin przed terminem użytkownicy dostaną powiadomienie, że sprawa nadal nie została obsłużona.
`EscalateOnDay`	wartość logiczna	Tak	Czy użytkownicy mają dostać powiadomienie o terminie na początku dnia roboczego, w którym mija termin.
`EscalateAfter`	wartość logiczna	Tak	Czy użytkownicy mają dostawać powiadomienie o terminie w każdy dzień po jego przekroczeniu.
`ReminderUser`	tekst	Nie	Użytkownik, którego dotyczy termin. Jeżeli go nie podasz, nowy termin zostanie ustawiony dla wszystkich użytkowników sprawy.
`EscalateToUsers`	tekst	Nie	Lista użytkowników oddzielonych średnikiem (`;`), którzy dostaną powiadomienie, gdy wymagają tego ustawienia eskalacji (`Escalate…`).

Zwracana wartość

Funkcja zwraca wartość logiczną: true, jeżeli nowy termin został poprawnie ustawiony, w przeciwnym razie false.

Przykłady

Przykład 1: termin w dniach dla wybranego użytkownika

Funkcja ustawia termin na koniec 2 pełnych dni roboczych od daty przekazania sprawy dla użytkownika o loginie some_user i powiadamia kierowników o loginach manager1 i manager2.

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

Przykład 2: termin z pola formularza

Funkcja ustawia termin na datę z pola formularza [deadline date] dla użytkownika o loginie some_user i powiadamia kierowników o loginach manager1 i manager2.

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

Dobre praktyki

Sprawdź, czy argument TimeUnits ma właściwą wartość. Od niego zależy, jak zostanie policzony termin.
W argumentach ReminderUser i EscalateToUsers podawaj loginy istniejących użytkowników, żeby powiadomienia trafiły do właściwych osób.
Sprawdź działanie funkcji w kilku scenariuszach, zanim użyjesz jej w procesie produkcyjnym, i zweryfikuj ustawione terminy oraz powiadomienia.

Typowe błędy

Nieprawidłowa wartość TimeUnits. Funkcja zgłasza wyjątek i nie ustawia terminu. Użyj jednej z dozwolonych wartości: hours, days albo date.
Termin w przeszłości. Funkcja zwraca false i nie ustawia terminu. Upewnij się, że obliczony termin wypada w przyszłości.