Funkcje obliczeń

W edytorze obliczeń dostępne są następujące funkcje:

Funkcje obiektu środowiska

GetBusinessTime( DataGodzina1 , DataGodzina2 ) — Zwraca liczbę godzin pracy między dwoma wartościami daty i godziny na podstawie kalendarza powiązanego z poziomem reakcji określonym dla danego procesu.
Na przykład TimeSinceResolved = Incident.GetBusinessTime(Resolution.CreationDate, DateTime.UtcNow) powoduje ustawienie zmiennej TimeSinceResolved na wartość równą liczbie godzin pracy między datą utworzenia ostatniego rozwiązania (Resolution.CreationDate) i bieżącą godziną w czasie UTC (funkcja obiektu DateTime DateTime.UtcNow) w oparciu o kalendarz używany na poziomie reakcji incydentu.

GetNamedObject("ObiektDanych", wartość) — zwraca wartość obiektu, gdzie ObiektDanych jest pełną nazwą obiektu, a wartość jest wartością atrybutu Czy nazwa?.
Na przykład return GetNamedObject("IncidentManagement._Przyklad", 123) zwraca obiekt Przykład o nazwie 123 znajdujący się w module Zarządzanie incydentami.

GetObjectByAttribute("ObiektDanych", "atrybut", wartość) — zwraca wartość obiektu, gdzie ObiektDanych jest pełną nazwą obiektu, a wartość jest wartością wybranego atrybutu.
Na przykład return Incident.GetObjectByAttribute("System.User", "Phone", 1234) zwraca użytkownika posiadającego telefon 1234.

Zarówno funkcja GetNamedObject(), jak i GetObjectByAttribute() zwracają pierwszy obiekt zgodny z podaną wartością. Zaleca się używanie tych funkcji tylko wtedy, gdy podana wartość jest unikalna.

GetNamedObject("ObiektDanych", ranga) — Zwraca wartość obiektu o określonej randze, gdzie ObiektDanych jest w pełni kwalifikowaną nazwą obiektu, a ranga jest numerem w uporządkowanej sekwencji.
Na przykład return Incident.GetRankedObject("IncidentManagement._Priorytet", 2 ) zwraca drugą wartość znajdującą się na liście uporządkowanej Priorytet znajdującej się w module Zarządzanie incydentami.

GetReferencedObject("ZgodnyObiekt") — zwraca obiekt odwołania do obiektu, gdzie ZgodnyObiekt jest odwołaniem do obiektu. Jest szczególnie przydatna w przypadku kolekcji Dopasowania wyszukiwania wygenerowanej przez zachowanie Wyszukiwanie automatyczne. Więcej informacji na ten temat oraz przykład użycia można znaleźć w dokumencie Podręcznik zarządzania wiedzą.

MinutesToBreach() — Zwraca liczbę minut do wystąpienia w obiekcie naruszenia, wyrażoną liczbą całkowitą z uwzględnieniem godzin pracy.
Na przykład return Incident.MinutesToBreach() zwraca liczbę minut do wystąpienia naruszenia w incydencie.

TimeToBreach() — Zwraca czas do wystąpienia w obiekcie naruszenia, wyrażony w postaci ciągu znaków w formacie gggg:mm:ss z uwzględnieniem godzin pracy. Należy zwrócić uwagę, że zwracany jest ciąg, co oznacza, że według tej wartości nie można sortować.
Na przykład return Incident.TimeToBreach() zwraca czas do wystąpienia naruszenia w incydencie.

Funkcje kolekcji środowiska

First() — Zwraca wartość określonego atrybutu o najwcześniejszej dacie utworzenia.
Na przykład item = Incident.Assignments.First() powoduje wybranie pierwszego z przypisań utworzonych dla incydentu. Następnie można użyć wyrażenia return item.Title, aby zwrócić tytuł pierwszego przypisania.

Latest() — Zwraca wartość określonego atrybutu o najnowszej dacie utworzenia.
Na przykład item = Incident.Assignments.Latest() powoduje wybranie ostatniego z przypisań utworzonych dla incydentu.

Max("atrybut") — Zwraca wartość maksymalną określonego atrybutu.
Na przykład Value = Incident.Assignments.Max("_CzasTrwania") powoduje ustawienie zmiennej Value na wartość równą największej wartości atrybutu o nazwie _CzasTrwania wśród przypisań danego incydentu.

Min("atrybut") — Zwraca wartość minimalną określonego atrybutu.
Na przykład Value = Incident.Assignments.Min("_CzasTrwania") powoduje ustawienie zmiennej Value na wartość równą najmniejszej wartości atrybutu o nazwie _CzasTrwania wśród przypisań danego incydentu.

Count — Zwraca liczbę elementów w określonej kolekcji.
Na przykład return Incident.Assignments.Count zwraca liczbę przypisań danego incydentu.

Funkcje daty i godziny

DateTime.Now — Zwraca bieżącą lokalną datę i godzinę w formacie daty i godziny. Korzystając z odpowiednich podopcji, można zwrócić bieżącą wartość sekund, minut, godziny, dnia, miesiąca lub roku.

DateTime.Today — Zwraca bieżącą datę w formacie daty i godziny. W polach godziny zwracana jest północ.

DateTime.Now — Zwraca bieżącą datę i godzinę czasu UTC w formacie daty i godziny. Korzystając z odpowiednich podopcji, można zwrócić bieżącą wartość sekund, minut, godziny, dnia, miesiąca lub roku.

Funkcje środowiska uruchomieniowego

GetCurrentGroupName() — Zwraca Nazwę bieżącej grupy zalogowanego użytkownika.

GetCurrentUserName() — Zwraca Nazwę zalogowanego użytkownika.