Wskaźniki dynamiczne

Wprowadzenie

Za pomocą wskaźników można pobierać dane dotyczące parametrów technicznych (np. liczby sesji dialogowych lub liczby aktywnych połączeń z bazą danych) oraz wskaźników biznesowych. W artykule przedstawiono informacje dotyczące aplikacji Wskaźniki dynamiczne.

Grupa docelowa

  • Użytkownicy
  • Konsultanci techniczni

Opis aplikacji

Aplikacja Wskaźniki dynamiczne służy do rejestrowania, edytowania i przeglądania wskaźników dynamicznych. Aplikacja składa się z nagłówka i obszaru roboczego. Wskaźniki mogą być tworzone w bazie OLTP lub w bazie repozytorium, w tym celu na standardowym pasku narzędzi należy wybrać odpowiednią opcję:

  • Dane OLTP
  • Dane repozytorium

Nagłówek

Nagłówek zawiera pola identyfikujące wskaźnik dynamiczny:

Wskaźnik – nazwa wskaźnika bez przestrzeni nazw. Wszystkie dynamiczne wskaźniki są rejestrowane w przestrzeni nazw com.dynamic. Pełna nazwa dynamicznego wskaźnika, na przykład o nazwie MyIndicator w bazie danych MYSEM01, to com.dynamic.MYSEM01.MyIndicator.

Oznaczenie – opis wskaźnika służy jako dodatkowy element identyfikujący. Może składać się z dowolnie wybranego tekstu. Zaleca się wprowadzenie jednoznacznego i możliwie najbardziej opisowego oznaczenia, aby ułatwić jego wyszukiwanie.

Obszar roboczy

W obszarze roboczym dostępne są poniższe pola:

Typ – typ wskaźnika dynamicznego. Możliwe wartości:

  • Wskaźnik agregacyjny
  • Wskaźnik licznikowy
  • Wskaźnik liczbowy
  • Wskaźnik statusu

Jednostka – jednostka monitorowanego parametru. Wprowadzenie jednostki dotyczy wyłącznie następujących typów:

  • Wskaźnik agregacyjny
  • Wskaźnik liczbowy

Definicja działania – służy do obliczenia wartości monitorowanego parametru. To pole jest obowiązkowe dla następujących typów:

  • Wskaźnik liczbowy
  • Wskaźnik statusu

Należy pamiętać, że podana definicja działania musi spełniać określone warunki. Szczegółowe informacje znajdują się w poniższych rozdziałach:

W zależności od typu wskaźnika, definicja działań musi spełniać różne warunki.

Wskaźniki licznikowy i agregacyjny

W przypadku wskaźników licznikowych i agregacyjnych definicja działań nie jest przypisywana bezpośrednio do samego wskaźnika. Jednak każda definicja działania może wyzwolić zdarzenie dla wskaźnika licznika lub agregacji, jeśli wystąpi określone zdarzenie, np. zdarzenie biznesowe. Zazwyczaj taka definicja aktywności ma wyłącznie za zadanie wywołać zdarzenie dla danego wskaźnika.

Do wywołania zdarzenia należy użyć poleceń fireAggregatorIndicator oraz fireCounterIndicator w skryptach definicji działań.

W przypadku fireAggregatorIndicator należy podać nazwę wskaźnika oraz wartość do agregacji jako parametry.

Polecenie fireCounterIndicator wymaga jedynie nazwy wskaźnika jako parametru.

Uwaga
Nazwa wskaźnika podawana jest bez przestrzeni nazw.

Przykład
Wywołanie zdarzenia dla dynamicznego wskaźnika licznika myCounter:

fireCounterIndicator(“myCounter“);

Wywołanie zdarzenia dla dynamicznego wskaźnika agregacji myAggregation z kwotą brutto faktury sprzedaży:

fireAggregatorIndicator(

"myAggregation",

parameters.object:grossAmount.amount);

Wskaźnik liczbowy

Dla wskaźników liczbowych należy przypisać do wskaźnika odpowiednią definicję działań. Definicja ta powinna mieć typ działania: Wywołanie funkcji.

Ponadto, definicja musi zawierać następujące parametry:

Nazwa Typ Typ danych Opis
VALUE Wartość zwracana Liczba

Wartość zwracana VALUE jest wartością zwracaną wskaźnika.

Definicja działań jest wywoływana w momencie odczytu wskaźnika, aby obliczyć wartość zwracaną VALUE.

Na zakładce Deklaracje definicji działań należy obliczyć wartość zwracaną VALUE.

Przykład
result.VALUE:=second(now());

Wskaźnik statusu

Dla wskaźników statusu należy przypisać do wskaźnika odpowiednią definicję działań. Definicja ta powinna mieć typ działania: Wywołanie funkcji.

Ponadto, definicja musi zawierać następujące parametry:

Nazwa Typ Typ danych Opis
STATE Wartość zwracana Ciąg znaków Wartość zwracana STATE jest jedną z wartości zwracanych przez wskaźnik. Powinna stanowić techniczny identyfikator statusu.
DESCRIPTION Wartość zwracana Ciąg znaków Wartość zwracana DESCRIPTION jest jedną z wartości zwracanych przez wskaźnik. Powinna zawierać przejrzysty opis statusu.

Definicja działań jest wywoływana w momencie odczytu wskaźnika, aby obliczyć wartości zwracane STATE i DESCRIPTION. Obie wartości powinny opisywać ten sam status.

Na zakładce Deklaracje definicji działań należy obliczyć te wartości zwracane.

Przykład
If (hour(now())<12) {

result.STATE:=”AM”;

result.DESCRIPTION:=”przed południem”;

} else {

result.STATE:=”PM”;

result.DESCRIPTION:= „po południu”;

}

Konfiguracja

W aplikacji Wskaźniki dynamiczne nie występują dedykowane parametry dla aplikacji Indywidualne weryfikacje.

Jednostki biznesowe

Aplikacja Wskaźniki dynamiczne jest powiązana z jednostką biznesową: com.cisag.sys.services.indicator.obj.DynamicIndicator która może być używana do:

  • przydzielania uprawnień

  • konfigurowania definicji działań

  • importowania lub eksportowania danych

Uprawnienia

Uprawnienia mogą być nadawane za pomocą ról uprawnień lub przypisania do organizacji. Szczegółowe informacje znajdują się w artykule Uprawnienia.

Uprawnienia specjalne

Aplikacja Wskaźniki dynamiczne nie posiada żadnych specjalnych uprawnień.

Przyporządkowania organizacji

Aplikacja Wskaźniki dynamiczne  nie wymaga przypisania do organizacji.

Specjalne możliwości

Aplikacja Wskaźniki dynamiczne  nie posiada specjalnych możliwości.

Uprawnienia dla partnerów biznesowych

Aplikacja Wskaźniki dynamiczne nie jest dostępna dla partnerów biznesowych.

Czy ten artykuł był pomocny?