Konfiguracja

Konfiguracja

Wszystkie opcje konfiguracji systemu dostępne są poprzez menu główne w kilku sekcjach:

  • Autoryzacja - elementy związane z dostępem do systemu, uprawnieniami oraz strukturą organizacyjną

  • Audyt - elementy nadzoru nad historią zmian i dostępem do danych przez interfejsy sieciowe

  • Główne - główne elementy konfiguracyjne systemu - dane początkowe, słowniki i inne

  • Mobilne - urządzenia mobilne pracujące w trybie offline oraz agregatory danych

  • Powiadomienia - obszar zarządzania notyfikacjami, powiadomieniami oraz automatyzacją działań systemu

  • Integracje - dane dotyczące integracji i operacji import/eksport

  • Inne sekcje specyficzne dla wybranej konfiguracji systemu

00 tree 7d649
Rysunek 1. Menu autoryzacji
00 tree 67bd7
Rysunek 2. Menu audytu
00 tree 30de0
Rysunek 3. Menu wymiany danych
00 tree 1a494
Rysunek 4. Menu ustawień głównych
00 tree e749a
Rysunek 5. Menu urządzeń mobilnych
00 tree 3a9a1
Rysunek 6. Menu powiadomień
00 tree 12476
Rysunek 7. Menu narzędzi
Dostęp do sekcji konfiguracji dostępny jest tylko dla użytkowników, którzy posiadają flagę dostępu do tej sekcji (patrz definicja użytkowników). Oprócz tego, dostęp do poszczególnych sekcji konfiguracji definiowany jest za pomocą standardowych uprawnień użytkownika (profili dostępu).

Wstęp

Interfejs konfiguracyjny jest dostępny dla użytkowników, którzy posiadają flagę dostępu do tego interfejsu (zobacz dokumentację definicji użytkowników) lub są super-administratorami.

Po wybraniu opcji w menu systemowym "Konfiguracja" system przeniesie użytkownika do tej wersji systemu. W nim można konfigurować funkcje systemu, automatyzację pracy aplikacji oraz przeglądać inne dane konfiguracyjne/słowniki systemowe.

entry 23674
Rysunek 8. Okno startowe systemu konfiguracyjnego
Założeniem sekcji konfiguracyjnej aplikacji jest zgrupowanie obszarów konfiguracji systemu, które są wykorzystywane sporadycznie, w jeden interfejs. Zwykle do tej części systemu powinien posiadać dostęp tylko wybrany zespół osób, które znają wymagania użytkowników i potrafią skonfigurować system do swoich potrzeb.

Wydziały

Sekcja definicji wydziałów pozwala na uszeregowanie pracowników w strukturze organizacyjnej zakładu/budowy. Za pomocą tego widoku mamy możliwość uporządkowania struktury pracowników w drzewie wydziałów/zespołów.

Po wejściu do widoku wydziałów przedstawiany jest nam widok w formie drzewa.

departments d0d09
Rysunek 9. Lista wydziałów

Akcje kontekstowe pozwalają na edycję wydziału lub dodanie podrzędnego wydziału. Dodanie głównych wydziałów realizujemy poprzez przycisk główny + Dodaj.

Za pomocą przycisku Użytkownicy mamy dostęp do widoku użytkowników przypisanych do danego wydziału.

W widoku działa mechanizm Drag & Drop pozwalający na przeniesienie wydziałów w drzewie i pomiędzy elementami.

Za pomocą pól wyszukiwania oraz filtrów szczegółowych możemy ograniczyć widok do wybranego drzewa/sekcji systemu. W widoku drzewa widzimy również informację o liczbie użytkowników, którzy są przypisani do danego wydziały. Możemy również wywołać listę użytkowników przypisanych do danego wydziału (imiona i nazwiska użytkowników).

Dodanie/edycja wydziału polega na wywołaniu odpowiedniej opcji z widoku głównego lub wejście do edycji aktualnie istniejącego wydziału.

departments 67670
Rysunek 10. Edycja wydziału

Okno wskazuje na jakim poziomie drzewa dodajemy nowy wydział (jeśli na głównym poziomie to nie pojawia się żadna informacja o elemencie nadrzędnym) oraz można wprowadzić informacje dotyczące nazwy wydziału.

Przydzielenie użytkowników do wydziału realizowane jest na poziomie poszczególnych użytkowników w ich widoku.

Użytkownicy

Interfejs zarządzania użytkownikami. Pozwala na określenie uprawnień i danych identyfikacyjnych pracowników uczestniczących w procesie. Domyślna akcja wyświetla listę użytkowników wraz z wszystkimi parametrami podstawowymi użytkowników.

users 29db0
Rysunek 11. Lista użytkowników

W menu kontekstowym widoku głównego dostępne są akcje pozwalające na przedstawienie dodatkowych danych dotyczących użytkownika/ów.

users 8cb31
Rysunek 12. Menu kontekstowe

Dostępne akcje

  • pokaż historię logowania - wyświetla okno z historią logowania użytkownika oraz jego źródłem (aplikacja Web, aplikacja mobilna Fx itp.)

  • raport profili dostępu - raport z listą profili dostępu dla wybranego użytkownika wraz z listą aktywnych funkcji (oraz ich identyfikatorów)

users ba015
Rysunek 13. Historia logowania użytkownika

Właściwości użytkowników

Właściwości dzielą się na sekcje z wydzieloną funkcjonalnością:

  • Ogólne - ogólne dane użytkownika

  • Dostęp - dostęp do poszczególnych sekcji systemu/flagi systemowe

  • Dane - dane identyfikacyjne

  • Identyfikatory - identyfikatory w postaci kodów kreskowych, kart RFID itp.

  • Profile - lista profili dostępu, do których przypisany jest użytkownik

  • Zdjęcie - zdjęcie użytkownika (np. do funkcji kontrolnych)

  • Podpis - podpis użytkownika - do wykorzystania w generatorach dokumentów

users ed992
Rysunek 14. Ogólne

Ogólnie informacje zawierają dale logowania, imię, nazwisko oraz zaszeregowanie do wydziału w organizacji.

users 37c54
Rysunek 15. Flagi dostępu

Flagi dostępu określają uprawnienia użytkownika do dostępu do wydzielonych sekcji aplikacji lub różnych aplikacji systemowych. Flagi:

  • Musi zmienić hasło - użytkownik lokalny przy następnym logowaniu zostanie poproszony o zmianę hasła

  • Użytkownik lokalny - użytkownik autoryzuje się hasłem/pin’em zapisanym lokalnie w systemie (w odróżnieniu od użytkowników korporacyjnych, którzy autoryzują się w zewnętrznych systemach - OAuth/Active Directory/LDAP)

  • Super-Administrator - włączenie tej flagi pomija sprawdzanie uprawnień względem profili dostępu (użytkownik zawsze będzie miał dostęp)

  • WWW - określenie dostępu do sekcji aplikacji WWW (aktualnej)

    • Użytkownik mobilny - tylko dostęp do części mobilnej interfejsu

    • Użytkownik desktop - dostęp do części głównej systemu dla komputerów

    • Administracja - dostęp do sekcji konfiguracyjnej systemu

  • Mobilny (Offline) - określenie dostępu do aplikacji mobilnej umożliwiającej pracę offline

Aktywację/deaktywację użytkownika wykonujemy w widoku listy użytkowników za pomocą dedykowanych przycisków.
users 6dbdd
Rysunek 16. Dane

Dane użytkownika dotyczące jego adresu kontaktowego, adresu email, pracodawcy u którego jest zatrudniony.

users f5951
Rysunek 17. Identyfikatory

Lista identyfikatorów w formie kodów 2D, RFID służących do identyfikacji danego użytkownika. Wykorzystywane w modułach sprawdzających obecności lub innych wymagających identyfikacji użytkownika. Mogą być też wykorzystane do logowania do aplikacji mobilnych w trybie offline.

users ade57
Rysunek 18. Dodaj identyfikator

Dodanie identyfikatora wymaga podania informacji o jego wartości, typie. Można w tym oknie skorzystać z możliwości skanowania kodów RFID/kreskowych w aplikacji AMAGE Shell.

users f2e82
Rysunek 19. Profile dostępu

Profile dostępu pozwalają na określenie listy profili, które posiada dany użytkownik. Profile dodajemy z listy.

Profile dostępu się sumują (są addytywne) tj. uprawnienia użytkownika to suma uprawnień wynikających z profili dostępu. Domyślnie użytkownik (pomijając flagę Super-Administratora) nie posiada dostępu do żadnego obszaru w systemie. Przez profile dostępu otrzymuje dostęp do poszczególnych obszarów oraz akcji (dodanie/usunięcie itp.).
users cfe54
Rysunek 20. Zdjęcie

Możliwość wgrania zdjęcia dla użytkownika. Będzie wykorzystywane w modułach, gdzie np. wymagana jest weryfikacja pracowników. Na aplikacji mobilnej po odczytaniu identyfikatora pracownika pojawi się jego zdjęcie.

users 4a456
Rysunek 21. Podpis

Podpis pozwala wgrać do systemu skan swojego podpisu. Będzie on wykorzystywany (przy zgodzie danego pracownika) podczas realizacji procedur inspekcji, weryfikacji lub sprawdzania dostaw - tam gdzie wymagany jest podpis. W takim przypadku (jeśli użytkownik wyraził zgodę) zostanie przy generacji dokumentów wykorzystany jego podpis zamiast wprowadzanego ręcznie.

Aktywacja/deaktywacja użytkownika

Użytkownik w systemie oprócz wszystkich możliwości definicji dostępu, uprawnień oraz sekcji systemu posiada flagę aktywnego dostępu do systemu. To podstawowa dana sprawdzana na początku procesu logowania. Jeśli użytkownik jest nieaktywny NIE BĘDZIE MÓGŁ zalogować się do systemu bez względu na inne uprawnienia.

Zmianę flagi aktywności użytkownika realizujemy albo przez dedykowane przyciski dostępne w liście użytkowników albo przez menu kontekstowe.

users 4a800
Rysunek 22. Aktywacja/deaktywacja użytkownika
Domyślnie tworzony użytkownik posiada flagę dostępu AKTYWNĄ

Zaproszenia email/wydruk

Za pomocą przycisku Zaproś mamy możliwość wysłania zaproszeń email do dołączenia do systemu. System automatycznie utworzy użytkowników oraz wyśle zaproszenie do nich, aby aktywowali konta i ustawili swoje hasła.

W taki sposób tworzymy jedynie użytkowników lokalnych tj. takich, którzy autoryzują się lokalnym hasłem. Nie dodamy w taki sposób użytkowników do zewnętrznych systemów autoryzacji.

Po wywołaniu akcji wyświetla się okno, w którym możemy wpisać listę adresów email (każdy w nowej linii), do których zostanie wysłane zaproszenie.

Następnie możemy określić sposób tworzenia loginów użytkownika. Może to być login będący tylko nazwą danego adresu email lub cały adres email. Wybieramy to za pomocą dostępnej tam opcji.

Mamy również możliwość modyfikacji/rozszerzenia zaproszenia do systemu. Do tekstu zaproszenia zostaną oczywiście dodane teksty z odnośnikami umożliwiającymi zalogowanie i resetowanie hasła.

users aaa48
Rysunek 23. Okno zaproszenia użytkowników

W przypadku, gdy zaproszenie dla zewnętrznych użytkowników tworzy osoba z uprawnieniami administratora systemu, to w formularzu zaproszenia można wskazać, które uprawnienia powinien posiadać użytkownik. W przypadku, gdy zaproszenie tworzy osoba z uprawnieniami użytkownika, to w formularzu zaproszenia nie ma możliwości wskazania uprawnień dla użytkownika. Uprawnienia wybieramy z dostępnych profili dostępu.

Co więcej, jeśli użytkownik ma uprawnienia super-administratora, to aktywna jest flaga nadania takich samych uprawnień dla zapraszanych użytkowników.

image 2024 03 18 19 43 59 801
Rysunek 24. Widok formularza zaproszenia użytkownika

Dla użytkowników, którzy posiadają uprawnienie do edycji użytkowników pojawia się, podczas zapraszania, dodatkowa zakładka pozwalająca na określenie profili dostępu dla użytkowników. Jeśli użytkownik jest super-administratorem to może też nadać taką flagę nowo zapraszanym użytkownikom.

users e4583
Rysunek 25. Lista uprawnień
Z mechanizmem dostępu należy się odnosić ze zrozumieniem i wiedzą o przypisanych uprawnieniach. W przeciwnym przypadku nowi użytkownicy otrzymają dostęp przekraczający ich domyślne uprawnienia.

Zaprosić użytkowników możemy również z menu systemowego, które w dolnej części posiada wbudowaną akcję Zaproś, która otworzy to samo okno co akcja z sekcji konfiguracyjnej.

users bd8b9
Rysunek 26. Zaproszenie użytkowników z menu systemowego

Profile dostępu

Profile dostępu stanowią centralny punkt nadawania uprawnień do poszczególnych sekcji i funkcji systemu. Każdy użytkownik, który zostanie zalogowany do systemu podlega sprawdzeniu swoich uprawnień przez system profili. Jeśli użytkownik nie otrzymuje dostępu do danej grupy uprawnień to:

  • Poszczególne obszary nie są mu wyświetlane - jeśli nie ma dostępu do funkcji "Listuj dostawy", to nie zostanie mu przedstawiony link w głównym menu dotyczącym dostępu do sekcji Dostawy

  • Akcje w ramach danej sekcji systemu nie są możliwe do uruchomienia. Funkcje się pojawiają tj. jeśli użytkownik ma dostęp do sekcji Dostawy to będzie mógł wyświetlić dokumenty dostaw. Pojawią się mu w menu kontekstowym akcje, przyciski będą aktywne. Natomiast jeśli nie będzie miał uprawnień np. do dodania nowej dostawy, to po wyborze przycisku (+) otrzyma komunikat o braku uprawnień do wykonania takiej czynności.

Powyższe nie dotyczy użytkowników, którzy mają włączoną flagę "Super-Administratora". Z założenia taka flaga pomija sprawdzenie profili dostępu. Pozwala to na bezproblemowy dostęp do pełnego interfejsu systemu np. w celu określenia praw dostępu dla pozostałych użytkowników. Nie należy nadużywać tej flagi użytkownika.

Po wejściu do sekcji profili dostępu wyświetlana jest lista profili oraz informacje o ilości funkcji zdefiniowanych w danym profilu.

profiles b177a
Rysunek 27. Lista profili

Edycja/dostanie profilu pozwala na określenie listy funkcji, które są dozwolone w danym profilu.

Menu kontekstowe listy profili pozwala na dostęp do wybranych funkcji dotyczących wszystkich profili dostępu.

profiles 5335d
Rysunek 28. Menu kontekstowe listy profili
  • Raport - dane profilu - pozwala na wygenerowanie raportu zbiorczego z listą uprawnień nadanych na każdy z profili dostępu (listę funkcji, które dany profil ma aktywne)

Profile dostępu dodają się do siebie tj. funkcje, które są określone w różnych profilach dostępu są sumowane. Każdy użytkownik może posiadać wiele przyznanych profili dostępu i jest uprawnienia będą SUMĄ uprawnień z poszczególnych profili dostępu. Pozwala to na zdefiniowanie profili dostępu określając zestaw czynności np. "Zdarzenia serwisowe - przegląd", "Zdarzenia serwisowe - tworzenie i edycja" a następnie przydzielenie takich profili dostępu do wybranych użytkowników. Pozwala to na łatwe określenie zestawu uprawnień dla użytkowników i ich elastyczną modyfikację.

Dodanie profilu dostępu wyświetla okno edycyjne. We wspólnych danych określamy nazwę oraz opis profilu.

profiles 23514
Rysunek 29. Wspólne dane

W zakładce Moduły i funkcje określamy listę uprawnień z podziałem na poszczególne moduły. Aby określić wybraną funkcję, należy wybrać moduł a następnie za pomocą fiszek określić, które funkcje dopuszcza dany profil dostępu.

profiles 19998
Rysunek 30. Moduły i funkcje

Funkcje są podzielone na moduły. Tylko aktywne moduły w systemie są widoczne dla definiującego profil dostępu. Listy dzielą się zwykle na operacje: podglądu danych, utworzenia nowego rekordu, edycji istniejącego rekordu oraz usunięcia rekordu. Dodatkowo pojawiają się funkcje specyficzne dla poszczególnych modułów, dla których zdecydowano o wydzieleniu uprawnień, tak aby można było lepiej kontrolować dostęp do wykonania tych funkcji.

Aby sprawdzić uprawnienia definiowane w danym profilu najprościej do testów wykorzystać utworzonego użytkownika testowego, który posiada dany profil przydzielony oraz dodatkową sesję przeglądarki w trybie tzw. incognito. W taki sposób możemy za pomocą jednej przeglądarki logować się równocześnie jako dwóch różnych użytkowników.

Zdarzenia i reakcje

Interfejs definicji zdarzeń, które są wynikiem zmian w danych w systemie. Mechanizm pozwala na elastyczne generowanie powiadomień email/notyfikacji w systemie z pełną kontrolą obsługi tych zdarzeń.

Mechanizm zdarzeń pozwala na konfigurowanie reakcji na występujące zdarzenia w systemie. Mechanizm zdarzeń działa na poziomie Obiektów. Operator systemu ma możliwość definicji zdarzeń na podstawowe operacje wykonywane na obiektach: Utworzenie, Modyfikacja, Usunięcie. Na podstawie tych podstawowych operacji może dodatkowo konfigurować czy system zareaguje na dane zdarzenie modyfikując skrypty sprawdzające. Pozwalają one na wprowadzenie dodatkowych warunków bazujących na danych konkretnego obiektu np. stan. Za pomocą skryptów modyfikujących użytkownik ma możliwość zmiany parametrów zdarzenia na podstawie danych pochodzących z obiektu np. wypełnienie listy adresatów email na podstawie parametrów obiektu np. przypisanej osoby do zdarzenia serwisowego.

Lista zdarzeń pozwala na przeglądanie zrealizowanych obsług zdarzeń w systemie. Jeśli zostanie zdefiniowane zdarzenie dla obiektu, to wszystkie operacje na tym obiekcie będą analizowane przez system. Na podstawie konfiguracji zdarzenia system będzie obsługiwał dane zdarzenie (np. wyśle email) lub określi, że zdarzenie jest ignorowane (np. nie spełnia warunków skryptu sprawdzającego).

events 4742e
Rysunek 31. Lista zdarzeń

W liście zdarzeń przedstawiane są wszystkie zdarzenia i reakcję systemu na nie. Filtr pozwala na selektywne wyświetlanie danych. Aby zobaczyć szczegóły przetwarzania zdarzenia należy wybrać dowolne zdarzenie. System przedstawi szczegóły zdarzenia.

events 15bed
Rysunek 32. Szczegóły zdarzenia

Szczegóły zdarzenia przedstawiają informacje dotyczące zdarzenia, daty utworzenia, przetworzenia przez system oraz datę ważności.

Data ważności określa czas przez który system będzie przetwarzał dane zdarzenie np. zdarzenie wysłania komunikatu przez email, gdy serwer email nie jest dostępny. W takim przypadku system będzie ponawiał wykonanie tego zdarzenia aż do czasu ważności. Po tym czasie zdarzenie zostanie określone jako niewykonane.

Po wyborze zakładki 'Dane' wyświetlane są poszczególne reakcje systemu na zdarzenie. Po wyborze poszczególnej akcji przedstawiane są logi w dolnej części okna np. informacje o wysyłce email.

events b6357
Rysunek 33. Historia realizacji obsługi zdarzenia

Za pomocą widoków nowego/starego obiektu możemy przeglądnąć strukturę zapisanych obiektów. Pokazywane są dane w formacie JSON.

events a4943
Rysunek 34. Nowy obiekt
events fe124
Rysunek 35. Stary obiekt

W widoku Różnica pokazywane są różnice pomiędzy rekordami starym i nowym.

Te dane można wykorzystać podczas tworzenia reguł zdarzeń. Rekordy pozwalają na dostęp do tych danych przedstawianych tutaj jako dane JSON. Można to wykorzystać w skryptach sprawdzających (np. sprawdzenie nazwy stanu zdarzenia serwisowego) lub w szablonach powiadomień (tytuł/treść emaila).

Reguły zdarzenia

Aby zdefiniować reakcję systemu na zdarzenia należy wybrać sekcję 'Reguły zdarzeń'. Po jej wybraniu przedstawiana jest lista reguł zdarzeń, które zostały zdefiniowane w systemie. Dodanie nowej reguły następuje po wyborze przycisku (+).

events 7c857
Rysunek 36. Lista reguł zdarzeń

Definicja reguły zdarzenia (lub jego edycja) jest podzielona na kilka sekcji. Definicja ogólna zdarzenia, edytor skryptu przygotowującego oraz edytor skryptu sprawdzającego.

events d519f
Rysunek 37. Definicja reguły zdarzenia

W definicji reguły zdarzenia określamy nazwę widoczną dla operatora systemu, typ obiektu którego dotyczy dane zdarzenie (który obiekt będzie przetwarzany przez daną regułę). Typ zdarzenia określa reakcję systemu na zdarzenie tj. czy akcja ma być wykonana gdy dany obiekt zostanie utworzony, zmieniony czy usunięty. Opcja 'Okresowe' dotyczy specjalnych reakcji zdarzeń okresowych wykorzystywanych przez schedulery.

W polach tekstowych edytora można używać do formatowania specjalnego mechanizmu Markdown. Za jego pomocą można wygenerować klikalne linki, pogrubienia, listy itp. Wyszukaj dokumentację znakowania Markdown na sieci aby poznać jego możliwości.

Dane podstawowe (zakładka 'Email') pozwalają na wprowadzenie informacji dotyczących podstawowych elementów wiadomości email takich jak tytuł, treść oraz stałe pola adresów email (z listy użytkowników lub lista stała dowolnych adresów).

W polach tekstowych można również wykorzystać dane z obiektów, które są przetwarzane. Wykorzystywana jest do tego notacja z podwójnym nawiasem {{}} nazwa_pola_obiektu. Aby poznać dozwolone pola skorzystaj z dokumentacji w portalu dokumentacji dotyczącej sekcji dostępnych zdarzeń i konfigurowania systemu.
Adresy email mogą być modyfikowane przez skrypt przygotowujący więc nie zawsze muszą być wprowadzane. Stałe adresy email mogą dotyczyć powiadomień, które zawsze wysyłane są do stałej listy adresatów.

Skrypt sprawdzający pozwala na dodatkowe wyfiltrowanie zdarzeń nie tylko na podstawie ich typu (utworzenie, edycja, usunięcie). Edytor pozwala na wprowadzenie notacji JavaScript, która może na podstawie własności pól obiektu zdecydować, czy skrypt ma być wykonany czy nie. Szczegółowe dostępne pola opisane są w dokumentacji dostępnej na portalu dokumentacji. Za pomocą tych reguł możemy np. uzależnić wykonanie skryptu od konkretnego stanu zdarzenia serwisowego np. wysłać email tylko jeśli zdarzenie zostanie rozwiązane.

events 3efe6
Rysunek 38. Skrypt sprawdzający
Funkcja sprawdzająca powinna ewaluować do wartości true/false. W przypadku gdy wartość sprawdzenia będzie miała wartość true, to zdarzenie zostanie wykonane.

Skrypt przygotowujący pozwala na dodatkową modyfikację pól wiadomości. Może być wykorzystany do np. aktualizacji listy adresów email na podstawie danych konkretnego obiektu. Np. możemy wysłać email do osoby, która zgłosiła dane zdarzenie serwisowe, albo wysłać email do osoby, która utworzyła zamówienie, jeśli zamówienie zostało zaakceptowane (definiowane w skrypcie sprawdzającym).

events 0cb7a
Rysunek 39. Skrypt przygotowujący
W celu poznania wszystkich możliwości edytorów oraz dostępnych pól obiektów należy odnieść się do dokumentacji szczegółowej na portalu dokumentacji.

Schedulery

Schedulery to sekcja systemu odpowiedzialna za definiowanie działań automatycznych, które realizują czynności bez obecności użytkownika. Przykładem takich działań jest np. automatyczne generowanie raportów, przesyłanie informacji pomiędzy użytkownikami wraz z operacjami na systemie, automatyczne generowanie inspekcji na podstawie wykonanych czynności nadzoru itp.

Każdy z takich schedulerów posiada własną możliwość konfiguracji. Każdy z nich może być również uruchamiany wielokrotnie z różnymi parametrami i o dowolnym okresie powtarzania.

Aby zobaczyć listę wszystkich zdefiniowanych schedulerów w systemie i kontrolować ich działanie wybieramy sekcję konfiguracji Schedulery. W początkowym widoku pojawia się lista wszystkich zdefiniowanych schedulerów.

schedulers 5a15f
Rysunek 40. Lista schedulerów

Lista zawiera informacje o wszystkich schedulerach, które są utworzone. Aby utworzyć nowy automat, należy wybrać przycisk (+). Edycja wybranego schedulera realizowana jest przez dedykowany przycisk edycji schedulera. Przycisk Restart powoduje ponowne wczytanie wszystkich konfiguracji przez koordynatora schedulerów.

Przy każdej zmianie konfiguracji schedulerów należy po zakończeniu wszystkich czynności wybrać przycisk Restart. To pozwoli przekazać informację koordynatorowi schedulerów, który działa cały czas w tle, aby odczytał konfigurację poszczególnych elementów na nowo.

Definicja schedulera/jego edycja polega na otwarciu okna edytora. Pozwala on na określenie najważniejszych informacji o tym automacie. Jest on podzielony na dwie sekcje. Pierwsza z nich określa podstawowe parametry automatu. Druga to konfiguracja specyficzna dla wybranego automatu.

schedulers 9723d
Rysunek 41. Definicja schedulera

Dostępne opcje ogólne:

  • Nazwa - nazwa dostępna dla użytkownika

  • Harmonogram cron - harmonogram, co jaki czas będzie dany automat uruchamiany. Definiowane jest to za pomocą semantyki aplikacji CRON z bardzo szeroką możliwością dostosowania np. co 5 minut, o 6:15 każdego dnia, co drugi dzień tygodnia itp. Szczegóły i przykłady dostępne są po wybraniu przycisku Pomoc przy tej sekcji.

  • Nazwa klasy zadania - wybór automatu. Szkielet działania automatu definiowany jest przez programistów AMAGE. Lista dostępnych automatów i ich pełnej dokumentacji jest dostępna w Portalu Pomocy w sekcji Jak Zrobić. Skrócona dokumentacja dostępna jest poprzez przycisk Pokaż w tej samej linii. Wybór przycisku Kopiuj przeniesie przykładową konfigurację do edytora przyśpieszając pierwsze użycie

  • Początkowe opóźnienie - definiuje ile automat ma zaczekać po restarcie koordynatora schedulerów aby się uruchomić. Przydatne w przypadku, gdy nie chcemy aby dany automat uruchamiał się od razu po starcie aplikacji (np. po restarcie serwera, gdy nie są gotowe inne elementy np. połączenia sieciowe)

  • Aktywne - flaga aktywności schedulera. Jeśli jest wyłączona to automat będzie aktywny i wykonywany. Wyłączenie go deaktywuje. UWAGA. Należy pamiętać o restarcie koordynatora schedulerów !

  • Zadanie współbieżne - włączenie pozwala na wiele równolegle działających automatów tej konfiguracji. Jeśli wykonanie danego automatu trwa np. 1 minutę (długotrwałe operacje, generacja danych itp.) to jeśli mamy wyłączoną tą flagę oraz ustawiony harmonogram działania co 30 sekund to system NIE pozwoli na działania równolegle dwóch instancji i zaczeka na zakończenie jednej nim uruchomi kolejną (czas generacji 1 minuta, okres uruchamiania 30 sekund). Jeśli flaga będzie włączona to system uruchomi równolegle dwie instancje tego schedulera, które mogą (ale nie muszą) na siebie wpływać.

  • Zablokuj od oraz zablokuj do - możliwość określenia godzin, w których automat nie będzie działał. Może to być przydatne gdy w określonych godzinach nocnych systemy do których chcemy się skomunikować są niedostępne (np. kopie bezpieczeństwa, restarty itp.). Taka opcja pozwala uniknąć niepotrzebnych prób komunikacji i pojawiania się błędów połączeń.

Edytor - edytor konfiguracji. W nim definiujemy dodatkowe dane, parametry dla automatu. Po wybraniu odpowiedniego automatu system konfiguruje te dane. Dostępne są one w dwóch formach. Edytora tekstowego z dowolnym sposobem wpisywania wszystkich parametrów.

schedulers 9847c
Rysunek 42. Edytor tekstowy konfiguracji

oraz edytorem wizualnym, w którym każda opcja posiada własny edytor danych.

schedulers 62ba0
Rysunek 43. Edytor wizualny konfiguracji

Przyciski przy każdym elemencie pozwalają na wybranie odpowiedniego pola edycyjnego lub otwarcia edytora z podświetlaniem składni markup oraz podglądem wyniku w formie HTML.

Taka edycja znacznie ułatwia edytowanie pól, które mogą zawierać dużo tekstu oraz znaki nowych linii np. teksty treści email lub podobna opcja automatu. Za pomocą takiego edytora możemy wizualnie edytować parametry i od razu podglądać wynik, jaki system wygeneruje z takiego formatowania.

schedulers a48b1
Rysunek 44. Edytor kodu pojedynczego zapisu z podglądem wygenerowanego widoku

Podgląd działania schedulera

Po uruchomieniu automat działa samodzielnie. W systemie w sekcji konfiguracyjnej dostępny jest zbiorczy podgląd logów z systemów automatyzacji tj. z schedulera, ze zdarzeń oraz z końcówek integracji. Wszystko jest dostępne w dokumentacji sekcji konfiguracyjnej.

Interfejs dostępu do danych historycznych

Interfejs przedstawiający historię zmiany danych w tabelach systemu. Pozwala na analizę wsteczną danych zapisywanych/modyfikowanych w głównych obiektach systemu. Za jego pomocą możemy zobaczyć zrzut informacji o poszczególnych obiektach.

history 3f728
Ze względu na ilość danych i ich retencję tylko kluczowe obiekty posiadają zapis danych historycznych.

Przeglądarka logów systemów wewnętrznych

W systemie dostępna jest przeglądarka logów systemów wewnętrznych aplikacji. Aplikacja posiada kilka systemów, które w tle generują akcje i służą do automatyzacji pracy systemu. Te elementy to:

  • Scheduler/Automaty - czyli zdarzenia generowane zgodnie z ustalonym harmonogramem. Mogą to być integracje do zewnętrznych systemów, automaty przejścia zdarzeń serwisowych, pobieranie danych energetycznych z giełd energii itp.

  • Integracje - Końcówki integracji, które zajmują się przetwarzaniem dokumentów EDI, integrują się z zewnętrznymi bazami danych itp.

  • Zdarzenia - Automat reagujący na zmianę parametrów systemu np. zmianę jednego stanu zdarzenia serwisowego na inny.

Wszystkie w/w elementy można zdefiniować w odpowiednich sekcjach interfejsu konfiguracyjnego. Każdy z tych systemów generuje logi informujące o jego pracy oraz ewentualnych błędach/problemach przy przetwarzaniu.

Za pomocą dostępnej tutaj przeglądarki logów mamy możliwość przeglądania logów, które generują te systemy. Aby do niego przejść należy wywołać akcję Podgląd logów z sekcji Audyt w konfiguracji.

loggers b98e5
Rysunek 45. Menu wywołania

Po przejściu pojawia się lista dostępnych logów, które możemy przeglądać/monitorować.

Lista logów

  • Integracje - dane z systemu integracji

  • Schedulery - dane z automatów harmonogramu

  • Eventy - dane z automatów reagujących na zmiany obiektów

Nie wszystkie logi są dostępne w każdej instancji. W takich, w których niektóre systemy są wyłączone, nie pojawiają się logi z tego obszaru.

Widok logów podzielony jest na dwie sekcje. Wybór strumienia logów oraz podgląd rzeczywisty danych.

loggers 043a9
Rysunek 46. Widok logów

W widoku poszczególnego strumienia logów mamy dostępne akcje:

  • Aktualizuj automatycznie - włączenie powoduje automatyczne odświeżanie strumienia logów

  • Linie - widoczne linie ze strumienia logów. Podajemy liczbę linii.

  • Akcja: odśwież - możliwość ręcznego odświeżenia strumienia logów

  • Akcja: pobierz - pobranie logów w formie pliku tekstowego

Pobranie logów pobiera zawsze pełny dostępny strumień logów. Logi dla każdego strumienia po osiągnięciu określonego rozmiaru (10MB) są automatycznie zastępowane nowym strumieniem.

Interfejs zarządzania kluczami dostępu

Interfejs do zarządzania kluczami do dostępu do interfejsu WebService przez ogólne API programistyczne. Dokumentacja do interfejsu API dostępna jest w sekcji dokumentacji programistycznej. W tym miejscu zarządzamy kluczami API i je generujemy.

Wywołanie akcji przedstawia listę dostępnych kluczy API, informacje o części wartości kluczowych (klucz, UUID) oraz daty aktywności, generacji i ważności danego klucza.

apiaccess f0e0b
Rysunek 47. Lista klucz API
Klucz jest aktywny jeśli data ważności przekracza aktualną datę systemową. Dodatkowo w przypadku urządzeń mobilnych należy zwrócić uwagę na flagę "sparowany", która jest wykorzystywana w niektórych aplikacjach w procedurze parowania tj. po sparowaniu klucza nie ma możliwości ponownej aktywacji tego klucza na innym urządzeniu

Dla każdego klucza API dostępne są akcje kontekstowe, które pozwalają na wykonanie edycji, usunięcia oraz szybkiej aktywacji/deaktywacji klucza.

apiaccess 95687
Rysunek 48. Akcje kontekstowe

W liście dostępne są mechanizmy filtrowania, które pozwolą na wyświetlenie aktywnych lub nieaktywnych kluczy API

apiaccess e9a35
Rysunek 49. Filtr wyszukiwania danych

Dodanie nowego klucza

Klucz można dodać poprzez interfejs Web. Aby to wykonać, należy wybrać akcję przycisku (+). Wywołujemy w tym momencie okno dodawania nowego klucza.

apiaccess 62cc5
Rysunek 50. Dodawanie nowego klucza API

Dane typu UUID urządzenia, klucz API i jego sekret zostaną wygenerowane automatycznie przez system podczas zapisywania nowego klucza. Użytkownik ma możliwość wprowadzenia dat ważności oraz flag informujących o aktywności klucza i jego sparowaniu.

W przypadku edycji istniejącego klucza, po jego wybraniu na głównej liście wyświetla się okno z informacjami dotyczącymi klucza. Sekret API wyświetla się po wybraniu przycisku 'Pokaż'. Dodatkowo poprzez akcję Przełącz mamy możliwość zmiany daty ważności klucza co oznacza zmianę jego aktywności.

apiaccess 02ebb
Rysunek 51. Edycja ważności klucza/parowania
Dokumentacja użycia klucza API oraz generacji podpisów do poszczególnych zapytań WebService zdefiniowana jest w dokumentacji programistycznej przekazywanej w momencie rozpoczęcia prac integracyjnych/wdrożeń systemu.

Auto-logowanie użytkownika

System umożliwia automatyczne zalogowane wybranego użytkownika na określonej przeglądarce. Pozwala to na udostępnienie części interfejsu systemu bez konieczności logowania np. w salach konferencyjnych, wizualizacjach, panelach dyspozytorskich.

Mechanizm bazuje na informacji zapisywanej w pamięci przeglądarki internetowej. Odpowiednio przygotowane dane obejmujące informacje o kluczu API i sekretach zapisywane są w ciasteczkach (cookies) przeglądarki.

Aby umożliwić takie logowanie, należy w widoku definicji wybranego klucza API zdefiniować użytkownika, który zostanie automatycznie zalogowany jeśli przeglądarka będzie posiadała odpowiednie dane autoryzujące. Wybór użytkownika definuje się w widoku klucza API.

apiaccess 907b8
Rysunek 52. Definicja użytkownika do automatycznego logowania
Nie można dodać/wykorzystać do autoryzacji użytkownika, który posiada uprawnienia Super-Administratora ze względu na to, iż taki użytkownik posiada wszystkie możliwe uprawnienia i pomijany jest mechanizm profili dostępu dla takiego użytkownika.

Po wybraniu i zapisaniu tych informacji można na przeglądarce, która będzie docelową przeglądarką internetową do automatycznego logowania, wybrać przycisk Authorize. System automatycznie przejdzie do widoku parowania klucza. Jeśli użytkownik posiada dostęp (jest zalogowany) to system ułatwia parowanie automatycznie przechodząć do okna parowania. Jeśli wykonujemy to ręcznie to należy przejść do adresu (w kontekście aplikacji) config#!apiaccess-token-entry.

apiaccess a6a32
Rysunek 53. Widok parowania klucza

Okno pozwala na wprowadzenie danych identyfikacyjnych klucza API i ich zatwierdzenie. Po zatwierdzeniu danych zostaje zapisane odpowiednio spreparowane ciasteczko w pamięci przeglądarki i od tego momentu aplikacja będzie automatycznie logowała wybranego użytkownika

Lista wszystkich logowań do systemu

Lista wszystkich logowań pozwala przeglądać historię logowania wszystkich użytkowników w systemie. Lista pokazuje logowania do systemu za pomocą aplikacji Web (dowolny interfejs) oraz za pomocą aplikacji Legacy Desktop (instalowanej na komputerach). Kolumna 'źródło' określa za pomocą jakiego systemu użytkownik się logował do aplikacji.

logins 72e6e
Rysunek 54. Lista logowań do systemu

Za pomocą filtru wyszukiwania można określić zakres dat lub określonego użytkownika dla widoku ogólnego.

logins c7b8e
Rysunek 55. Filtr wyszukiwania
Lista logowania nie zawiera logowań do urządzeń mobilnych pracujących w trybie offline. Aplikacja Fx zwrotnie nie synchronizuje tych informacji. Logowania w trybie online natomiast są wyświetlane w tym widoku.

Okno zawiera informacje o dacie logowania, użytkowniku, z jakiego źródła nastąpiło logowanie (aplikacja Web/Mobile, aplikacja instalowana na komputerach lub inne). Dodatkowo w kolumnie Opis pojawia się informacje jakie role posiada użytkownik:

  • ROLE_USER - użytkownik ma uprawnienia do logowania do interfejsu mobilnego

  • ROLE_DESKTOP_USER - użytkownik ma uprawnienia do logowania do interfejsu desktopowego aplikacji Web

  • ROLE_ADMIN - użytkownik ma uprawnienia do logowania do interfejsu konfiguracyjnego

Dedykowane urządzenia mobilne

Definicja dedykowanych urządzeń mobilnych - urządzeń pracujących z aplikacją AMAGE Fx lub AMAGE CE na dedykowanych urządzeniach. Możliwość pracy w trybie offline. Lista urządzeń pozwala na definiowanie urządzeń i ich konfigurację.

Po wejściu do menu głównego konfiguracji Mobilne → Urządzenia przedstawiana jest lista wszystkich zdefiniowanych urządzeń mobilnych. Dodanie nowego urządzenia następuje poprzez wybranie akcji (+).

mobile 76c44
Rysunek 56. Lista urządzeń mobilnych

Definicja nowego urządzenia mobilnego pozwala na określenie jego parametrów oraz ustawień.

  • Nazwa - nazwa ogólna urządzenia widoczna w podsumowaniach

  • Opis - dodatkowy opis urządzenia np. właściciel itp.

  • Model - model urządzenia, który jest obsługiwany. W przypadku aplikacji AMAGE Fx wybieramy Tablet Windows, w przypadku aplikacji PVD wybieramy Agregator danych

  • Aktywny - czy urządzenie jest aktywne tj. czy akceptujemy komunikację z tego urządzenia

  • Ograniczone urządzenie - po włączeniu tej flagi, jedynie zadania mobilne, które jawnie zostały przypisane do tego urządzenia są przez niego widoczne.

mobile ace64
Rysunek 57. Definicja urządzenia mobilnego
Flaga ograniczonego urządzenia ma na celu umożliwienie określenia szczegółowego zadania mobilnego wraz z wycinkiem danych, które są synchronizowane dla tego urządzenia. Ma to sens, w przypadku urządzeń, które są przekazywane np. podwykonawcom lub kontrahentom do realizacji określonych czynności np. inspekcji. W tym przypadku zapewniamy, że dane urządzenie mobilne dostanie tylko te informacje, które mu przydzielimy.

Zakładka informacji techniczne przechowuje informacje z aplikacji PVD dotyczące ostatniej daty komunikacji oraz ostatniej informacji dotyczącej komunikacji z tym urządzeniem. Ułatwia to ewentualną diagnostykę.

mobile c04b0
Rysunek 58. Informacje techniczne urządzenia mobilnego

Po dodaniu urządzenia w menu kontekstowym widoku tabelarycznego pojawiają się dodatkowe opcje:

mobile adc8f
Rysunek 59. Menu kontekstowe
  • Przełącza aktywny/nieaktywny - włącza/wyłącza możliwość komunikacji z urządzeniem

  • Klucz API - wyświetla dane klucza API. Daje to możliwość skopiowania tych danych i wpisania np. do agregatora danych w jego konfiguracji

  • Kod QR - wyświetlenie kodu QR z danymi konfiguracyjnymi tego urządzenia. Aplikacja AMAGE Fx oraz AMAGE CE Lite posiada możliwość zeskanowania tego kodu i automatycznej konfiguracji na podstawie danych tam zawartych.

  • Informacja dot. ostatniej komunikacji - wyświetla w dodatkowym oknie szczegóły komunikacji. Pozwala to na przeglądnięcie danych w większym widoku.

  • Edytuj klucz API - pozwala na przejście do edycji klucza API powiązanego z danym urządzeniem.

Każde urządzenie mobilne w momencie jego utworzenia, automatycznie tworzy również jedną parę danych klucza API, które jest wykorzystywane do autoryzacji zapytań pomiędzy urządzeniem a serwerem. Więcej informacji o kluczach API znajdziesz w dokumentacji konfiguracji.

Zadania dla urządzeń mobilnych

Definicja zadań/zakresów danych dla dedykowanych urządzeń mobilnych pozwala na określenie zakresu danych, tak aby pracowały tylko na wydzielonej ich części. Interfejs pozwala na kontrolę przesyłanych danych z takich urządzeń. W przypadku urządzeń pracujących w trybie offline nie jest możliwa synchronizacja całej głównej bazy ze względu na jej rozmiar. W takim przypadku powstała logika zadań mobilnych. Pełnią one dwie role:

  • Definicji, jakie dane mają być przesłane w tym zadaniu do urządzenia mobilnego

  • Przechowywaniu informacji przesłanych z urządzeń mobilnych przed ich integracją z główną bazą danych (dziennik zmian).

W widoku konfiguracji w sekcji Mobilne mamy dostęp do zadań mobilnych poprzez akcję Zadania. Po jej wybraniu przedstawiamy listę zadań mobilnych i ich statusy.

mobile 62141
Rysunek 60. Lista zadań urządzeń mobilnych

Utworzyć zadanie mobilne możemy za pomocą przycisku +, edycja dostępna jest bezpośrednio z listy zadań. Podczas tworzenia/edycji zadań mamy możliwość określenia danych podstawowych:

mobile d0da8
Rysunek 61. Edycja zadania mobilnego - wspólna sekcja
  • Nazwa - nazwa zadania - będzie wyświetlana na urządzeniach mobilnych

  • Opis - opis szczegółowy zadania

  • Typ - typ zadania - ogólne, inspekcje, obchody

  • Stan - aktualny stan zadania zarejestrowane, dostępne, w urządzeniu, zwrócone, zamknięte, anulowane, stałe

W zależności od typu zadania, jest ono wyświetlane na określonych urządzeniach. Np. aplikacja AMAGE CE Lite obsługuje tylko zadania typu Nadzór.

Dodatkowe flagi dla zadania pozwalają na dodatkową kontrolę:

  • Stałe zadanie - zadanie nie będzie zmieniało swojego stanu po odebraniu z urządzenia mobilnego. Pozwala to na utrzymywanie tego zadania ciągle dostępnego dla urządzeń mobilnych.

  • Automatyczna synchronizacja - automatycznie synchronizuj dane przesyłane z urządzenia mobilnego do centralnej bazy danych

  • Synchronizuj tylko publiczne załączniki - w trakcie synchronizacji, jeśli użytkownik zażyczy sobie przesłania załączników/plików powiązanych z obiektami to tylko pliki z flagą Publiczne zostaną wysłane. Przydatna opcja, w przypadku przekazywania urządzenia do zewnętrznego podwykonawcy/klienta itp.

  • Synchronizuj wyposażenie - w trakcie synchronizacji zadania do urządzenia zostaną wysłane również zasoby o typie Wyposażenie. Przydatne dla wykonywania inspekcji zdalnych w trybie offline. W tym przypadku możemy wybrać również np. urządzenie pomiarowe, którym wykonywana jest inspekcja.

W drugiej zakładce zadania mobilnego dostępne są informacje dotyczące ograniczeń danego zadania mobilnego.

mobile 5cb4b
Rysunek 62. Zadanie mobilne - ograniczenia

Ograniczenia mogą dotyczyć listy użytkowników przesłanych na urządzenie, zasobów z tylko wybranych lokalizacji, tylko określonych zleceń pracy i powiązanych z nimi obiektów oraz inne zgodnie z listą.

  • Użytkownicy

  • Lokalizacje

  • Zlecenia pracy

  • Obchody

  • Magazyny

System stara się inteligentnie dobierać przesyłane dane zgodnie z wybranymi parametrami. Dla przykładu wybranie lokalizacji A pozwoli na wysłanie na urządzenie mobilne wszystkich urządzeń/zasobów w tej lokalizacji ORAZ lokalizacji podrzędnych (miejsc/pomieszczeń).

Dla każdego zadania mamy dostępne menu kontekstowe z akcjami:

mobile 8608e
Rysunek 63. Menu kontekstowe
  • Zmiana stanu - jawna zmiana stanu danego zadania. Zwykle zmiana stanu realizowana jest automatycznie przez proces komunikacji np. po wysłaniu wykonanego zadania urządzenie mobilne automatycznie zmienia stan zadania na gotowe do integracji.

  • Zdarzenia zadania - podgląd zdarzeń zadania

Zdarzenie zadania mobilnego

Każde zadanie jak opisano powyżej spełnia również rolę jako magazyn danych przesyłanych przez urządzenia mobilne. W trakcie pracy offline urządzenia mobilne wykonują prace i tworzą nowe wpisy w całkowitym oddzieleniu od centralnego systemu. Na urządzeniu mobilnym tworzą się tak zwane dzienniki zmian (journal). Określają one co zostało zmienione/utworzone poza centralną bazą danych.

Podczas synchronizacji te dane przesyłane są zwrotnie do centralnego systemu a system zajmuje się aktualizacją danych w centralnej bazie danych na podstawie tego dziennika zmian. Jest to konieczne, gdyż system centralny musi zapewnić jednolitość danych w centralnej bazie. Jednym z przykładów takiego rozwiązywania problemów jest aktualizacja rekordu, który w tracie pracy w trybie offline został usunięty z centralnej bazy danych przez np. inne urządzenie. W takim przypadku dane przesłane z urządzenia mobilnego muszą być odpowiednio przetworzone.

Widok zdarzeń zadania mobilnego wskazuje właśnie te pakiety danych przesyłane przez urządzenia mobilne wraz z szczegółowymi danymi. Lista podzielona jest na dwie sekcje. Pierwsza to poszczególne komunikacje a druga to treść dziennika przesyłanego w każdej komunikacji.

mobile 602d1
Rysunek 64. Lista zdarzeń zadania mobilnego z menu kontekstowym

System automatycznie integruje wszystkie dane, które są możliwe do takiej operacji. Zdarzenia, które mają jakieś problemy możemy samodzielnie zaktualizować za pomocą akcji dostępnej w menu kontekstowym wybranego zdarzenia. Po poprawnie wykonanej integracji system zmienia stan zdarzenia na Zintegrowane.

Lista definicji raportów

Lista raportów w systemie konfiguracji pozwala na określenie widoczności raportów w systemie oraz ich konfigurację wizualną (np. wygląd domyślny szablonu raportu).

Lista dostępnych raportów przedstawia wszystkie raporty aktualnie dostępne w systemie. Raporty te mogą być raportami systemowymi lub definiowanymi przez użytkownika.

reports 52bcb
Rysunek 65. Lista dostępnych raportów
Lista raportów pozwala zdefiniować dowolną liczbę nowych raportów dla definiowalnych typów danych. Ich wykorzystanie i udostępnienie zależy od implementacji poszczególnych modułów.

Po wybraniu raportu przedstawiane jest okno informacji szczegółowej o raporcie.

reports da3c1
Rysunek 66. Szczegóły raportu - ogólne

Przedstawiane tam są informacje ogólne, opis do jakiego obiektu danych raport należy, jego unikalny identyfikator (wykorzystywany w odnoszeniu się do tego raportu w generatorach). W tym widoku możemy określić czy raport jest dostępny dla pojedynczego elementu czy dla grup elementów. Opcja pozwala również ukryć raport przed użytkownikami - w przypadku gdy dla danej instancji dany raport nie jest przydatny lub nie jest wykorzystywany.

Zakładka szablon pozwala na definicję własnego wyglądu raportu. Wgrywamy do tego miejsca archiwum ZIP z raportami, które zostają zastępowane podczas generacji.

reports 271ab
Rysunek 67. Szczegóły raportu - szablon

Takie podejście pozwala na modyfikację wyglądu raportu zastępując domyślny wygląd raportu w systemie. Ze względu na to, iż raporty mogą składać się z pod-raportów do tego miejsca wgrywamy archiwum ZIP z wszystkimi raportami/podraportami które zastępujemy.

Szczegółowe informacje o nazwach raportów, dostępnych polach, wyglądzie i konfiguracji znajduje się w Portalu Pomocy w obszarze "Jak zrobić" oraz "Dla programistów". Tam też jest opisane darmowe narzędzie/projektant raportów.

Zakładki raportu

Każdy raport może posiadać zakładki. Zakładki to dodatkowa możliwość dostosowania wyglądu i ustawień raportu. Raporty domyślnie posiadają swoje parametry konfiguracyjne wyświetlane w oknach filtrów raportu. Zakładki pozwalają zapisać wybrany zestaw konfiguracji i je ponownie uruchamiać bez konieczności wypełniania filtrów po raz kolejny. Dodatkową funkcją zakładki może być definicja wyglądu raportu. Czasami zdarza się, że podczas generacji raportów dla danego typu obiektu (np. Inspekcje/Protokoły serwisowe) chcemy zmienić wygląd raportu i dostosować go do zewnętrznego odbiorcy (klienta, wydziału itp.). Za pomocą zakładek możemy z tego skorzystać.

Po wybraniu przycisku Zakładki wyświetlane są wszystkie zdefiniowane zakładki raportu.

reports 4e9c9
Rysunek 68. Zakładki raportu - lista

W tym oknie można dodać nowe zakładki lub edytować istniejące. Edycja istniejących pozwala na definicję ogólnych informacji w zakładce Ogólne

reports 074e4
Rysunek 69. Zakładka raportu - ogólne

Oraz określenie wyglądu raportu generowanego przy pomocy tej zakładki. Funkcje są tożsame jak w oknie definicji raportu.

reports cbd3d
Rysunek 70. Zakładka raportu - szablon

Konfiguracja - dane ogólne

Ogólne dane konfiguracyjne niezbędne do poprawnego działania systemów. Określenie podstawowych parametrów i ustawień realizowane jest przez ten widok. Dostęp do niego jest poprzez menu główne 'Główne' → 'System'.

system ea0db
Rysunek 71. Menu dostępu do głównych ustawień systemu

Widok ustawień podzielony jest na dwie sekcje 'Wspólne' oraz 'Liczniki'. W sekcji wspólne znajdują się główne ustawienia systemu wpływające na działanie aplikacji.

system a09ff
Rysunek 72. Ogólna konfiguracja aplikacji

Dostępne opcje konfiguracyjne:

  • Tytuł aplikacji - tytuł aplikacji wyświetlany w pasku tytułowym

  • Domyślne widoki startowe - w którym widoku rozpoczynamy sesję w każdym z obszarów

  • Domyślna lokalizacja - wybór domyślnej lokalizacji. Ta lokalizacja będzie pokazywana jako początkowa we wszystkich oknach, w których wymagane jest podanie lokalizacji geograficznej/na planach. Zwykle ustalane jest na widok miejsca pracy, zakładu, budowy. Pozwala to na szybkie określenie dodatkowych miejsc bez konieczności ciągłego wyszukiwania. UWAGA. Domyślnie ustawiana jest lokalizacja (0,0) na Oceanie Atlantyckim.

  • Waluta - wybór waluty wyświetlanej w aplikacji w tych miejscach, w których przechowywana jest informacja o cenach. UWAGA. To ustawienie jest wykorzystywane tylko do formatowania danych. Nie stosowane są żadne przeliczniki walut.

  • Obrazy - możliwość wgrania obrazów/logotypów wykorzystywanych w oknach logowania/informacyjnych oraz osobno obraz wykorzystywany jako logotyp firmy w raportach.

  • Dane instancji - dane instancji wynikające z licencji i ustawień wdrożeniowych. Licencja dotyczy danych ustawianych podczas wdrożenia przez wdrożeniowców AMAGE. Numer instancji nadawany jest przez administratorów systemu.

Za pomocą domyślnych adresów startowych mamy możliwość określenia, w jakim adresie rozpoczynamy sesję dla widoku mobilnego, desktop oraz konfiguracyjnym. Aby zmienić go na inny dowolny, wykorzystajmy końcówkę adresu i wpiszmy ją w dane pole. Np. aby rozpocząć widok konfiguracji od konfiguracji danych systemowych wpiszemy config-desktop-system gdyż adres tego obszaru to: config#!config-desktop-system

system 50692
Rysunek 73. Domyślne adresy startowe
Numer systemu (pochodzący z licencji) oraz numer instancji wykorzystywane są podczas generacji unikalnych kodów 2D/Kreskowych w niektórych modułach. Bardzo istotne jest aby numer instancji był unikalny wśród wszystkich instancji działających dla jednego klienta. Klient ma możliwość określenia tego numeru samodzielnie.

Dane licznikowe

Dane licznikowe służą do wskazania systemowi, których definicji liczników ma używać podczas generacji unikalnych numerów dla dokumentów tworzonych w systemie. W tym obszarze definiujemy, których liczników system ma użyć przy generacji dokumentów z obszaru zamówień/dostaw, jakich przy operacjach magazynowych oraz innych systemach (zdarzeń serwisowych itp.).

system 6f545
Rysunek 74. Wybór liczników
Ustawienia liczników wykorzystywane są w przypadku generacji dokumentów, gdzie użytkownik wybierze automatyczne nadawanie kolejnych numerów dokumentów.

Tabele mobilne

Konfiguracja tabel mobilnych może być dostosowana w każdej instancji osobno. Ze względu na niewielką ilość miejsca w interfejsie mobilnym (zwłaszcza w urządzeniach typu telefon) nie można przedstawić wszystkich danych w listach dostępnych w tym interfejsie. Każda instancja systemu może mieć też inne potrzeby pokazywana danych. Dla przykładu jedna instancja może wykorzystywać numery zamówieniowe typów a druga nie. W tym pierwszym przypadku istotne jest aby pokazywać ten numer w interfejsie (na liście) a w drugim już niekoniecznie.

Domyślnie system, jeśli nie posiada skonfigurowanego widoku tabeli mobilnej przedstawia następująco elementy w takiej tabeli.

system 8436f
Rysunek 75. Tabele bez konfiguracji

W sekcji konfiguracji systemu dostępna jest zakładka Tabele mobilne i w niej można skonfigurować widoki dla poszczególnych list dostępnych w interfejsie mobilnym.

system 34849
Rysunek 76. Konfiguracja danych i informacji

Każda lista posiada dwie linie - główną i dodatkową. Każdą z nich można osobno konfigurować wykorzystując pola do wpisania własnych słów oraz słów kluczowych (eng. placeholder) w których system wpisze odpowiednie parametry danego obiektu. W taki sposób możemy dowolnie konfigurować widoczność informacji.

Przykładowy widok typów już po domyślnej konfiguracji:

system dea89
Rysunek 77. Tabela typów po konfiguracji

Starter mobilny

Aplikacja mobilna ma możliwość włączenia panelu startowego przy uruchomieniu tej aplikacji. System pozwala dowolnie konfigurować dostępne przyciski i akcje tam udostępnione. Za pomocą tego widoku i zakładki możemy skonfigurować dowolny widok.

system b0760
Rysunek 78. Definicja startera mobilnego

Po włączeniu akcji Włączenie startera mobilnego będzie on używany jako punkt startowy dla aplikacji. Po wejściu i po wybraniu nazwy aplikacji w górnym rogu widoku mobilnego system przejdzie do tego widoku i pozwoli na szybkie przejście do wybranych akcji.

Aby zdefiniować dowolne akcje należy dodać nowy element, wpisać tekst, który chcemy wyświetlić, wybrać ikonę oraz określić adres, do którego system zostanie przekierowany po wybraniu tej akcji.

Takie podejście pozwala na dowolną konfigurację widoku uwzględniając nawet dodatkowe filtry i ustawienia tj. nie musimy przechodzić do widoku ogólnego zleceń pracy ale możemy od razu za pomocą takiego przycisku przejść do zleceń pracy, które są w stanie Zaplanowane. Aby to zrobić w przeglądarce internetowej przechodzimy do widoku mobilnego (zobacz ogólną instrukcję początkową jak wymusić widok mobilny), następnie przechodzimy do widoku, który chcemy podpiąć pod przycisk, ustawiamy wszystkie filtry i kopiujemy finalną część adresu jak na przykładzie poniżej.

system 66a56
Rysunek 79. Adres widoku mobilnego z zaznaczoną częścią do wpisania jako akcja poszczególnego kafelka

Za pomocą przycisku Podgląd mamy możliwość wyświetlenia skonfigurowanych przycisków startera tak jak będą prezentowane w aplikacji mobilnej.

system e7de7
Rysunek 80. Podgląd konfiguracji startera

Po uruchomieniu takich opcji starter może prezentować się następująco:

system 57f18
Rysunek 81. Widok startera po konfiguracji

Jeśli włączymy starter, ale nie zdefiniujemy żadnego kafelka to pojawi się domyślny widok z informacją o braku elementów startowych.

system 3f995
Rysunek 82. Domyślny komunikat przy braku kafelków

Bezpieczeństwo

System pozwala zdefiniować politykę haseł dla użytkowników lokalnych. Po przejściu do widoku konfiguracji i wybraniu zakładki Hasła możemy ustalić politykę bezpieczeństwa haseł. Domyślnie polityka jest wyłączona co pozwala na ustalenie dowolnego hasła przez użytkownika.

Dostępne opcje:

  • Długość hasła - minimalna długość hasła

  • Typ hasła - typy znaków, które muszą wystąpić w haśle (duże/małe liter itp.)

  • Interwał zmiany hasła - co ile dni hasło musi być zmienione

  • Blokada hasła - po ilu dniach po zakończeniu interwału zmiany hasła, konto zostanie zablokowane jeśli nie zmieni swojego hasła

  • Przypomnienie o wygaśnięciu hasła - ile dni przed upływem interwału zmiany hasła należy przesłać przypomnienie użytkownikowi o konieczności zmiany hasła.

system c810b
Zablokowane konto może odblokować użytkownik administracyjny, który ustawi nowe hasło i ustawienia logowania w interfejsie konfiguracyjnym.
Polityka haseł odnosi się tylko do użytkowników lokalnych, którzy autoryzowani są za pomocą haseł zapisanych lokalnie w bazie danych AMAGE. Nie dotyczy to użytkowników korporacyjnych, którzy autoryzują się w zewnętrznych systemach typu Active Directory/LDAP.

W przypadku systemów, które posiadają włączoną możliwość logowania za pomocą kont korporacyjnych np. poprzez Azure Entra ID mamy możliwość określenia dodatkowego zachowania w sekcji dotyczącej logowania korporacyjnego.

system 81210
Rysunek 83. Opcje konfiguracji korporacyjnej

Dostępne opcje:

  • automatycznie utwórz użytkowników - tylko dla kont korporacyjnych. Po poprawnym zalogowaniu w zdalnym systemie jest tworzony domyślny użytkownik bez żadnych innych uprawnień oprócz możliwości zalogowania do systemu. Ułatwia to późniejsze konfigurowanie użytkowników.

  • nazwa domeny dla logowań korporacyjnych - gdy podana, to nazwa użytkownika w systemie AMAGE będzie nazwą przesyłaną przez system autoryzacji z pominięciem podanej domeny. Jeśli użytkownik loguje się jako admin.test@domena.com to w przypadku konfiguracji domeny jako @domena.com użytkownik w systemie zostanie wpisany z loginem admin.test.

  • lista profili dostępu. Lista profili dostępu oddzielona przecinkiem. Te profile zostaną przydzielone nowo tworzonemu użytkownikowi.

Flagi konfiguracji

Flagi konfiguracji pozwalają na ustawienie specyficznych zachowań systemu w poszczególnych modułach. Zwykle ustawienia te są włączane podczas początkowego wdrożenia systemu i określają sposób zachowania się funkcji w systemie np. czy w trakcie sprawdzenia dostawy wymagane jest podanie podpisów elektronicznych. Za pomocą tego widoku możemy też określać widoczność niektórych sekcji w systemie (ukryć jeśli np. nie są w danym przypadku używane).

Ustawienia należy traktować jako istotna zmiana zachowania aplikacji i zaleca się podchodzić do zmiany tych ustawień z odpowiednią ostrożnością, gdyż mogą one zmienić zarówno zachowanie aplikacji jak i też zwiększyć/zmniejszyć widoczność danych w systemie dla określonych użytkowników.
system 36da5
Rysunek 84. Dane konfiguracyjne (1/3)
system baecb
Rysunek 85. Dane konfiguracyjne (2/3)
system 1dd0b
Rysunek 86. Dane konfiguracyjne (3/3)

Konfiguracja - dane słownikowe

Dostęp do danych słownikowych otrzymujemy poprzez dedykowane menu główne 'Słowniki'. Po włączeniu tego widoku w formie tabeli przycisków pojawia się lista wszystkich dostępnych konfiguracji słownikowych w systemie.

dictionaries 506a2
Widoczność przycisków jest uzależniona od dostępnych funkcji w systemie wynikających z licencji/uprawnień wdrożeniowych.

Konfiguracja - konta rozliczeniowe

W oknie definiuje konta w systemie. Konta w aplikacji stanowią połączenie pomiędzy systemem AMAGE a zewnętrznymi systemami Finansowo-Księgowymi lub rozliczeniowymi np. z zewnętrznymi dostawcami. Konto stanowi identyfikator za pomocą którego łączymy obiekty w systemie (np. zlecenia pracy, miejsca składowania w magazynie) z odpowiadającym im centrom kosztów lub grupom rozliczeniowym w zewnętrznych systemach.

Lista przedstawia pełną listę kont rozliczeniowych dostępnych i zdefiniowanych w systemie. Konta mogą być tworzone ręcznie lub tworzone automatycznie podczas importu danych z zewnętrznych źródeł (np. plików XLS).

system accounts ff307
Rysunek 87. Lista kont rozliczeniowych

Edytor konta rozliczeniowego pozwala na podanie jego nazwy (identyfikatora) oraz opisu dodatkowego dla konta

system accounts 801af
Rysunek 88. Edytor konta rozliczeniowego

Integracje zewnętrzne

Systemy integracji pozwalają na dodatkową automatyzację. W przypadku dokumentów EDI istotne jest oprócz automatycznego pobrania dokumentów również ich kategoryzacja m.in. do odpowiedniego konta kosztowego. Aby to zrobić system integracji ma możliwość przeszukiwania dokumentów EDI (dostaw, zamówień, zwrotów itp.) w poszukiwaniu słów kluczowych, które jednoznacznie identyfikują dane konto kosztowe.

W sekcji Integracje mamy możliwość zdefiniowania takich elementów. W kolejnych nowych liniach możemy podać zestawy tekstów, które znalezione w opisach, tytułach lub dodatkowych danych dokumentów EDI pozwolą na identyfikację i przypisanie dokumentu do określonego konta kosztowego.

system accounts 6c509
Rysunek 89. Mapowanie nazw w integracjach
Należy upewnić się, że słowa kluczowe są unikalne dla każdego konta. System będzie wybierał pierwsze konto, które będzie odpowiadało danemu słowu kluczowemu.

Konfiguracja - typy kontraktów

Typy kontraktów to definicja słownikowa, która pozwala na kategoryzację kontraktów istniejących w systemie. Użytkownik za pomocą definicji tych danych może podzielić realizowane prace zgodnie z własną nomenklaturą. Lista typów kontraktów przedstawia wszystkie aktywne definicje kontraktu.

system contracttypes e741a
Rysunek 90. Lista typów kontraktów

Edytor typu kontraktu pozwala na nadanie mu nazwy oraz dodatkowego opisu tekstowego.

system contracttypes 6efbd
Rysunek 91. Edytor typów kontraktu

Konfiguracja - liczniki

Liczniki to dana słownikowa, która pozwala systemowi automatycznie numerować dokumenty, zdarzenia, protokoły i wykorzystywać licznik jako źródło unikalnego (kolejnego) numeru o określonym formacie wyglądu. Lista słowników przedstawia wszystkie zdefiniowane w systemie liczniki.

system counters 7d5c5
Rysunek 92. Lista liczników
Liczniki są wykorzystywane również wewnętrznie przez niektóre moduły systemu. W związku z tym mogą w liście liczników pojawić się liczniki oznaczone jako systemowe. Nie można ich edytować/usuwać gdyż są wykorzystywane przez system.

Utworzenie/edycja licznika wyświetla okno edytora, który pozwala na zdefiniowanie informacji niezbędnych do poprawnego działania licznika.

system counters dc344
Rysunek 93. Edytor licznika

Dostępne pola:

  • Nazwa - Nazwa licznika udostępniana dla użytkownika. Może być dowolnym tekstem mającym znaczenie dla użytkownika.

  • Klucz - Identyfikator licznika udostępniany w systemach lub schedulerach. Zwykle jest to klucz typu <nazwa_identyfikatora> który pozwala w łatwiejszy sposób odnosić się do tego licznika w skryptach/automatach.

  • Opis - Opis licznika

  • Wartość - Aktualna wartość licznika. Domyślnie ustawiona na 1. Licznik będzie automatycznie zwiększany po wygenerowaniu. W tym polu można zmienić początkową wartość licznika np. na 100.

  • Wzorzec - Wzorzec, który będzie wykorzystany do generacji tekstowej reprezentacji licznika. Za jego pomocą można umieścić liczbę z pola Wartość w ramach tekstów i dodatkowych pól automatycznych.

Po wybraniu przycisku Info wyświetlane jest okno z informacjami o możliwych opcjach dla wzorca. Pozwala to na wpisanie do tekstowej reprezentacji pól takich jak wartość licznika, aktualny miesiąc, aktualny rok lub dowolny tekst generując np. PZ/1234/04/2020.

system counters a8ab9
Rysunek 94. Opcje wzorca licznika

Konfiguracja - kompetencje pracowników

Interfejs definicji zbioru kompetencji pracowników. Kompetencje mogą być weryfikowane podczas prac kontrolnych np. na budowie lub wykorzystane do określenia/wybrania osób o określonych kompetencjach do wykonania prac w zakładzie.

Za pomocą słownika kompetencji definiujemy listę dostępnych kompetencji w danej organizacji - może to być zestaw uprawnień elektrycznych, mechanicznych, do obsługi maszyn itp. Kompetencje następnie przydzielone do pracownika mogą służyć do odpowiedniego wybierania kompetentnych osób do wykonania danych czynności.

Lista typów kompetencji przedstawia listę wszystkich kompetencji.

system employeecompetencies 1ef3c
Rysunek 95. Lista typów kompetencji

Edytor kompetencji pozwala na wprowadzenie jest nazwy oraz tekstowego opisu.

system employeecompetencies 316df
Rysunek 96. Edytor typów kompetencji
Wszystkie dodatkowe parametry kompetencji np. data ważności dokumentu, czy wymaga okresowego sprawdzania tej kompetencji itp. definiowane są podczas dodawania kompetencji dla poszczególnych użytkowników

Konfiguracja - dane finansowe

Obszar słownika danych finansowych zawiera informacje o parametrach finansowo-księgowych oraz rozliczeniowych wykorzystywanych w mechanizmach raportowania lub generacji danych do zewnętrznych systemów. Dane te są określane dla każdego miesiąca z osobna.

Lista dostępnych danych finansowych przedstawia wszystkie zdefiniowane w systemie dane finansowe ze wskazaniem okresu, którego dotyczą.

system financialdata 5ed2e
Rysunek 97. Lista danych finansowych

Edytor danych finansowych pozwala na wprowadzenie opisowej danej dotyczącej danego okresu finansowego oraz określenie daty FRI.

system financialdata d9e49
Rysunek 98. Edytor danych finansowych
Data FRI to data rozliczeniowa dla finansów danego miesiąca. Do tej daty należy wprowadzić dane finansowe i przekazać je w organizacji do komórek finansowo-księgowych. Data ta zwykle jest datą poprzedzającą koniec miesiąca, więc dane od tej daty do końca miesiąca muszą być wyliczane w inny sposób niż na podstawie dostępnych dokumentów (aproksymowane, prognozowane itp.). System na podstawie tej daty potrafi w niektórych obszarach rozliczeniowych (np. najmy) generować wartości finansowe na koniec danego miesiąca.

Konfiguracja - identyfikatory inwentaryzacji

Identyfikatory inwentaryzacji są zestawami identyfikatorów ułatwiających prace inwentaryzacyjne. System posiada własny mechanizm generowania unikalnych identyfikatorów. Te identyfikatory służą później do jednoznacznego zidentyfikowania urządzeń w zakładzie poprzez skanowanie np. kodów QR/2D z tymi kodami. Identyfikatory generowane w systemie składają się z części wspólnej (identyfikującej system i instancję) oraz części zmiennej automatycznie zwiększanej.

Inwentaryzacje z natury zwykle są realizowane w miejscu, w którym jest trudny dostęp do infrastruktury teleinformatycznej oraz miejsca do wydruku. Istotny jest też czas wykonania takiej inwentaryzacji. Aby przyśpieszyć te operacje użytkownicy w systemie mogą przygotować przed inwentaryzacją pakiet identyfikatorów, wydrukować je w formie kodów 2D i wykorzystać podczas szybkiego oznakowywania urządzeń. W kolejnym kroku następuje odczytanie identyfikatorów i sporządzenie dokumentacji zdjęciowej. Ostatnim krokiem jest uporządkowanie danych w systemie, ale realizowane już w dowolnym czasie przed ekranem komputerów.

Lista identyfikatorów inwentaryzacji przedstawia listę wszystkich wygenerowanych wcześniej pakietów.

system inventoryidentifiers d8ed7
Rysunek 99. Lista identyfikatorów inwentaryzacji

Za pomocą menu kontekstowego mamy możliwość włączenia generacji/wydruku identyfikatorów. Możemy też oznaczyć dany pakiet jako już wydrukowany (aby nie drukować/wykorzystać go ponownie).

system inventoryidentifiers d929c
Rysunek 100. Menu kontekstowe

Aby zarezerwować pakiet identyfikatorów należy utworzyć nowy wpis. W nim podajemy nazwę danego pakietu (dla łatwiejszej późniejszej obsługi) oraz liczbę identyfikatorów, które zostaną zarezerwowane (wygenerowane).

system inventoryidentifiers f3842
Rysunek 101. Utworzenie nowego pakietu identyfikatorów

System umożliwia również oprócz generacji standardowych kodów systemu typu P99901-0000001 również wykorzystać dowolny licznik zdefiniowany w systemie do generacji takich kodów. Może to być przydatne, gdy np. chcemy wygenerować kody dla numerów inwentarzowych danego przedsiębiorstwa. Wtedy wykorzystujemy nowy licznik z odpowiednim wzorcem, który wygeneruje taką listę danych do wydruku.

Konfiguracja - modyfikacje (wstrzymania) dzierżawy

Interfejs definicji wstrzymań dzierżawy pozwala na definicję okresów w czasie, w których dla wybranych zleceń/elementów konstrukcyjnych nie jest naliczana dzierżawa. Wykorzystywane jest to do ograniczeń naliczania zgodnych z umowami z dostawcami.

W przypadku rozliczania najmów/dzierżaw zasobów, które są obsługiwane przez system AMAGE, realizowane jest naliczanie ciągłe tj. za liczbę wszystkich dni, przez które dany zasób (urządzenie, szalunek itp.) jest w posiadaniu, naliczana jest odpowiednia kwota. Istnieją zdarzenia, które powodują przerwy w takim naliczaniu.

Lista wstrzymań dzierżawy przedstawia listę wszystkich zdefiniowanych w systemie wstrzymań dzierżawy. Lista ta jest również dostępna w ramach poszczególnych obiektów (przedstawiająca wstrzymania tylko dla tego obiektu). Lista dostępna w module konfiguracji przedstawia wszystkie zdefiniowane wstrzymania.

system leaseratemodifiers b916c
Rysunek 102. Lista wstrzymań dzierżawy

Utworzenie/edycja nowego wstrzymania dzierżawy definiowana jest za pomocą edytora, w którym określamy parametry.

system leaseratemodifiers ef713
Rysunek 103. Edycja wstrzymania dzierżawy - ogólne dane

W zakładce Wspólne definiujemy nazwę, typ wstrzymania (różna obsługa dla zwykłego wstrzymania lub wstrzymania urządzeń drobnych) oraz okres obowiązywania danego wstrzymania.

system leaseratemodifiers 1ef18
Rysunek 104. Edycja wstrzymania dzierżawy - parametry dzierżawy

W zakładce dzierżawa definiujemy procentowo wartość modyfikacji dzierżawy tj. określenie wartości 0% oznacza że w danym okresie nie będzie naliczana dzierżawa. Określenie wartości 50% oznacza, że naliczana będzie połowa wartości, która jest w danych dniach wymagana (z rozbiciem na poszczególne dni). W tej zakładce definiujemy również, czy wstrzymanie dotyczy wszystkich elementów konstrukcyjnych czy tylko wybranych, które można określić za pomocą listy tych elementów.

system leaseratemodifiers 955a8
Rysunek 105. Edycja wstrzymania dzierżawy - powtarzalność

W zakładce powtarzalność definiujemy czy dane wstrzymanie jest powtarzalne i mamy możliwość określenia typu powtarzania, okresu co jaki będzie to wyliczane, daty końcowej powtarzania i dni tygodnia w jakich będzie aktywne powtarzanie.

Dla przykładu można zdefiniować powtarzanie:

  • Co tydzień

  • Z interwałem 2 - czyli co dwa tygodnie

  • Z terminem końca np. na koniec roku (31. grudnia)

  • W dni tygodnia sob/nd.

Oznacza to, że system zdefiniowane wstrzymanie będzie powtarzał co dwa tygodnie aż do końca roku ale tylko wtedy, gdy po przesunięciu interwału okaże się, że dniami tymi jest sobota lub niedziela (przydatne przy powtarzaniu np. co określoną ilość dni).

Konfiguracja - mapy

Interfejs definicji własnych podkładów map. Definicja pozwala na wgranie do systemu oraz wybór mapy w przeglądarkach map.

Konfiguracja jest dostępna w systemach, które posiadają skonfigurowany własny serwer map, który zastępuje ogólnodostępny serwer map typu OpenStreetMap. Konfiguracja typu serwera realizowana jest podczas konfiguracji wdrożeniowej systemu przez wdrożeniowców AMAGE.
system maps 63a63
Rysunek 106. Lista zdefiniowanych map

Procedura dodawania map wymaga określenia nazwy mapy oraz podstawowych informacji o mapie (minimalne zbliżenie/maksymalne i domyślne). Podczas tworzenia mapy przydzielany jest jej unikalny identyfikator, który będzie wykorzystany do wgrania podkładów mapy w postaci kafelków na serwer.

system maps 78710
Rysunek 107. Edytor map

System umożliwia również dodanie domyślnej mapy poprzez wybranie przycisku Domyślna co automatycznie doda mapę bazującą na podkładach Open Street Map (OSM). System w takim przypadku będzie tworzył lokalną kopię kafelków OSM w celu serwowania ich dla użytkowników jednocześnie przyśpieszając transfer oraz minimalizując komunikację z publicznymi serwerami OSM.

W przypadku definicji własnych map istotne jest określenie maksymalnego/minimalnego poziomu mapy, domyślnego zbliżenia.

Jeśli zaznaczymy mapę jako mapę nałożoną na mapy geograficzne, to pojawi się ona nad wybraną główną warstwą. Za pomocą suwaka "Nieprzeźroczystość" możemy określi jak bardzo przeźroczysta jest warstwa. 0% - w pełni przeźroczysta, 100% - całkowicie maskująca.

Konstrukcja danych mapy oraz jej umieszczenie na serwerze realizowane jest podczas procedury wdrożenia. Źródłem map mogą być pliki DWG lub duże obrazy rastrowe/wektorowe. W każdym przypadku podczas wdrożenia takie obrazy są dostosowane do sposobu dostarczania takich danych do przeglądarek (kafelki - tiles zawierające wycinek widoku całej mapy/planu)
Zachęcamy do aktywnego współtworzenia map OpenStreetMap poprzez edycję obszarów, które są Państwu znane. Zwiększa to dokładność, aktualność tego systemu. Więcej na: Open Street Map

Konfiguracja - szablony parametrów

System posiada możliwość definiowania dowolnych parametrów dla typów/zasobów w systemie. Zwykle pomiędzy urządzeniami/typami część parametrów jest powtarzalna np. parametry elektryczne, parametry środowiskowe itp. Aby ułatwić nadawania takich parametrów w powtarzalny sposób, system wprowadza coś takiego jak szablony parametrów.

Szablony parametrów to definiowalne przez użytkownika grupy parametrów, które można wykorzystywać przy tworzeniu/definiowanych nowych typów zasobów tak aby ułatwić i przyśpieszyć te operacje.

Lista szablonów parametrów przedstawia wszystkie szablony dostępne w systemie.

system parametertemplates 07d0e
Rysunek 108. Lista szablonów parametrów
Wybór szablonu przy tworzeniu nowego typu zasobów możliwy jest w edytorze danego typu.

Dodanie/edycja nowego szablonu realizowana jest albo przez przycisk (+) lub przez wybranie szablonu do edycji.

W edytorze szablonu definiujemy jego nazwę oraz określamy listę parametrów, które składają się na dany szablon parametru. Za pomocą dedykowanego przycisku Kopiuj możemy szybko kopiować parametry i je później w uproszczeniu edytować.

system parametertemplates 4c03f
Rysunek 109. Definicja szablonu parametru

Definicja pojedynczego parametru pozwala na określenie jego wartości i dodatkowych informacji.

system parametertemplates 3e886
Rysunek 110. Definicja pojedynczego parametru w szablonie

Dostępne pola:

  • Nazwa - Nazwa parametru

  • Opis - Dodatkowy, tekstowy opis parametru

  • Jednostka - Jednostka pomiaru. Wyświetlana dla użytkowników.

  • Kategoria - Kategoria parametru. Parametry można grupować w kategorie.

  • Domyślna wartość - Domyślna wartość parametru. Podczas dodawania nowego zasobu otrzymuje on pakiet parametrów. Jeśli będzie wpisana tutaj domyślna wartość, to zostanie ona skopiowana do zasobu (z możliwością późniejszej zmiany).

  • Typ wyświetlany - typ wyświetlania parametru. Od niego zależy dostępny edytor (np. pole tekstowe, pole daty)

  • Wyrażenie - wyrażenie sprawdzające. W dolnej części znajdują się trzy przyciski, które wstępnie określają wyrażenie sprawdzające dla najbardziej popularnych typów danych. Wyrażenie jest wyrażeniem regularnym (RegExp) za pomocą którego system sprawdza, czy dany parametr jest określonego formatu. Pozwala to na wstępną walidację pól podczas wprowadzania danych.

Sekcja Integracje umożliwia definicję danych dla systemów integracji lub rozwiązań typu edge computing. Odnieś się do dokumentacji parametrów po więcej informacji.
Wyrażenia regularne to bardzo rozbudowany mechanizm, który pozwala na definicję praktycznie dowolnych reguł. Więcej informacji na stronach internetowych dotyczących tego mechanizmu np. www.regexpal.com

Konfiguracja - stany zdarzeń serwisowych

Interfejs definicji stanów zdarzeń serwisowych i określenia możliwych przepływów/zmian pomiędzy stanami danego zdarzenia.

system serviceeventstates db983
Rysunek 111. Lista stanów zdarzeń serwisowych
Stany zdarzenia serwisowego odpowiadają kolejnym etapom realizacji danego zdarzenia. Mogą one reprezentować najprostszy przebieg tj. Nowe, W trakcie, Zakończone lub bardziej skomplikowane, odpowiadające rzeczywistemu obiegowi zdarzenia uwzględniającego np. procedurę przyjęcia urządzenia, ocenę uszkodzeń, proces fakturowania itp.

Aby utworzyć lub edytować zdarzenie wybieramy przycisk (+) w górnej części okna lub wybieramy stan, który chcemy edytować a następnie wybieramy przycisk 'Edycja'.

system serviceeventstates 9a48f
Rysunek 112. Edytor zdarzenia serwisowego

Tylko jeden stan zdarzeń serwisowych musi posiadać flagę "Domyślny stan". To będzie stan, który zostanie ustawiony jako pierwszy w momencie utworzenia zdarzenia serwisowego.

Stany publiczne określają mapowania listy stanów zdarzenia serwisowego na stany widoczne w Portalu Klienta.

Zwykle w procesie serwisowym istnieje wiele stanów wewnętrznych, które nie powinny być sygnalizowane zewnętrznemu klientowi np. analiza, naprawa, fakturowanie. Zamiast tego system w Portalu Klienta przestawia tylko trzy stany: Nowy, W trakcie, Rozwiązany. Za pomocą tego mapowania określamy jak przedstawiać wewnętrzne stany w Portalu Klienta

Lista dozwolonych przejść pozwala określić możliwy przepływ pomiędzy stanami. Jeśli zostanie wypełniony, to użytkownik systemu będzie z danego stanu mógł przejść tylko do wybranych stanów z listy

system serviceeventstates cfdcb
Rysunek 113. Edytor stanu zdarzenia serwisowego - wymagane potwierdzenia

Flagi wymaganych potwierdzeń wykorzystywane są podczas realizacji prac serwisowych i wprowadzania danych za pomocą urządzeń mobilnych. Wymóg wprowadzenia podpisów odpowiednich osób będzie skutkował pokazaniem dialogów z koniecznością podpisu (lub wykorzystania podpisów zapisanych w systemie - patrz definicja użytkowników).

Lista wymaganych usług pozwala na określenie jakie usługi muszą być wprowadzone do danego zdarzenia serwisowego aby system pozwolił przejść do tego stanu. Pozwala to na ustalenie, które usługi (np. liczba przepracowanych godzin, kwota wyjazdu itp.) mają być wprowadzone do zdarzenia serwisowego przed przejściem do kolejnego kroku (stanu zdarzenia serwisowego).

Konfiguracja - typy zdarzeń serwisowych

Definicja typów zdarzeń serwisowych. Określanie typu zdarzeń w celu łatwiejszej kategoryzacji zdarzenia.

system serviceeventtypes c4153
Rysunek 114. Lista typów zdarzeń serwisowych
system serviceeventtypes 2e2e4
Rysunek 115. Edytor typu zdarzenia serwisowego

Flagi istotne przy definicji typu zdarzenia:

  • Widoczność publiczna - włączenie tej opcji powoduje wyświetlenie tego typu zdarzenia w Portalu Klienta. Pozwalamy wybrać taki typ zgłoszenia klientowi zewnętrznemu przez w/w portal.

  • Urządzenie niesprawne - włączenie tej flagi spowoduje w przypadku rozliczeń najmu urządzeń traktowanie czasu aktywności danego zdarzenia serwisowego (od momentu zgłoszenia do momentu rozwiązania) jako czas wyłączony z naliczania najmu

Konfiguracja - usługi

Usługi stanowią składową kosztową zdarzeń serwisowych, protokołów serwisowych lub wykonywanych prac kontrolnych. Za jej pomocą można do w/w obiektów zapisać informacje dodatkowe pozwalające oszacować koszty realizacji danego zlecenia. Za pomocą usług można zdefiniować koszty, które nie są kosztami elementów z magazynu (obsługiwanych przez rozchody magazynowe) ale również stanowiące część obciążenia danego zgłoszenia/protokołu/kontroli. W słownikach definiujemy takie rzeczy jak:

  • Przepracowane godziny

  • Faktury zewnętrzne (usługodawcy, podwykonawcy)

  • Dokumenty magazynowe z zewnętrznych systemów (ERP)

Wartości usług mogą być synchronizowane z zewnętrznymi systemami np. systemem Finansowo-Księgowym w celu pobrania kosztów faktur lub systemem magazynowym w oprogramowaniu ERP lub czasem pracy z systemów Rejestracji Czasu Pracy.

Lista dostępnych typów usług pozwala na wyświetlenie wszystkich zdefiniowanych w systemie usług oraz ich edycję/tworzenie nowych.

system serviceitems 83185
Rysunek 116. Lista dostępnych typów usług

Utworzenie nowego typu usługi pozwala na wprowadzenie wszystkich podstawowych danych dotyczących tej usługi

system serviceitems 0497d
Rysunek 117. Edytor typu usługi

Możliwe do wprowadzenia dane:

  • Kod - kod typu usługi. Wykorzystywany np. podczas wymiany danych z zewnętrznymi systemami. Zwykle to wartość kodowa łatwa do wpisania/transferu pomiędzy systemami informatycznymi

  • Nazwa - nazwa usługi. Nazwa przyjazna użytkownikowi.

  • Typ - typ usługi. Usługa może być wyliczeniowa tj. wskazująca dokładną wartość liczbową (koszt, godziny, wartość itp.) lub opisowa tj. określona tylko opisem bez konkretnej wartości liczbowej

  • Opis - opis typu usługi. Dana dla użytkownika.

  • Jednostka - jednostka miar

  • Cena jednostkowa - cena jednostkowa jednej jednostki danej usługi np. cena za km dojazdu, wartość roboczogodziny itp.

Konfiguracja - magazyny

Magazyny stanowią centralny punkt rozliczeniowy gospodarki magazynowej. Każdy magazyn może się dzielić na wiele miejsc składowania (miejsc, w których składowane są elementy w magazynie). Definicja magazynów realizowana jest ręcznie za pomocą poniższego interfejsu lub automatycznie podczas importu struktur projektu/kontraktu lub integracji z zewnętrznymi systemami ERP.

Po wejściu do konfiguracji magazynów użytkownik otrzymuje listę wszystkich zdefiniowanych magazynów oraz ich podstawowych właściwości.

system warehouses 46837
Rysunek 118. Lista magazynów

Dodanie/edycja magazynu jest możliwa poprzez wybranie przycisku (+) lub poprzez wybranie określonego magazynu.

system warehouses b01cb
Rysunek 119. Definicja magazynu

Dostępne parametry dla magazynu:

  • Kod - kodowa nazwa magazynu. Często wykorzystywana jako kod wymiany danych pomiędzy systemem AMAGE a zewnętrznymi systemami informatycznymi.

  • Nazwa - nazwa magazynu, przyjazna dla użytkownika

  • Opis - dodatkowy opis magazynu np. jego lokalizacji i przeznaczenia

  • Miejsca składowania - lista miejsc składowania, które są powiązane z magazynem. Lista możliwa do edycji i modyfikacji.

System wymaga posiadania dla magazynu co najmniej jednego miejsca składowania aby było możliwe wykonywanie operacji magazynowych.
system warehouses c3d4e
Rysunek 120. Definicja miejsc składowania w magazynie

Miejsce składowania definiowane jest jako informacja opisowa miejsca. Do miejsca składowania można również przypisać konto rozliczeniowe oraz lokalizację, która pozwala wyświetlić miejsce składowania na mapie i przesyłać te informacje do użytkowników i dostawców (gdzie mają dostarczyć materiały).

system warehouses 32db3
Rysunek 121. Szczegóły miejsca składowania

Szczegóły miejsca składowania to:

  • Nazwa - nazwa miejsca, przyjazna dla użytkownika

  • Opis - opis miejsca składowania. Informacja dla użytkownika.

  • Konto - konto, które powiązane jest z danym magazynem/miejscem składowania

  • Lokalizacja - lokalizacja miejsca składowania

Parametry — pozwalają na określenie, jakie parametry należy wyświetlać bezpośrednio w widoku danego magazynu w formie dodatkowych kolumn z danymi.

image 2023 11 09 13 26 25 218
Rysunek 122. Definicja magazynu
Aby skorzystać z tej funkcji, należy ją włączyć w opcjach konfiguracyjnych systemu.
image 2023 11 09 13 28 30 975
Rysunek 123. Definicja opcji dotyczących magazynu w sekcji konfiguracyjnej

Konfiguracja — jednostki miar

W systemie istnieje możliwość określenia jednostek miar oraz ich reprezentacji w systemie. Aby przejść do definicji jednostek, należy w konfiguracji słownikowej wybrać opcję Jednostka miar.

image 2023 11 09 12 08 02 011
Rysunek 124. Menu słowników i definicja jednostek miar

Po wybraniu tej opcji pojawia się okno z predefiniowanymi jednostkami w systemie. System podczas pierwszego uruchomienia definiuje jednostki w systemie oraz określa ich parametry. Mamy możliwość zmiany tych parametrów oraz/lub definicję nowych jednostek miar.

image 2023 11 09 12 08 29 902
Rysunek 125. Lista jednostek miar

Jednostka miar cechuje się następującymi parametrami:

  • Kod — kod pozwala na wykorzystanie tego kodu do operacji np. importu/eksportu danych.

  • Nazwa — Nazwa jednostki, która ułatwia zrozumienie jej znaczenia

  • Skrót — skrót, który będzie się pojawiał w systemie np. w nagłówkach kolumn lub opisach pól np. m, kg, szt.

  • Miejsca dziesiętne — liczba miejsc dziesiętnych do reprezentacji w systemie dla danej jednostki. Zależnie od ustaleń lub branżowych specjalizacji dane te mogą być określone w różny sposób. Sztuki domyślnie liczone są jako liczby całkowite. Metry z dwoma miejscami po przecinku. Itd. System pozwala na zmianę lub określenie tej dokładności.

image 2023 11 09 12 08 42 070
Jedyną jednostką, która nie jest możliwa do zmiany jest Sztuka (PIECE). Wynika to z tego, że jest to domyślna jednostka, która wykorzystywana jest przez system w przypadku, gdy nie zostanie zdefiniowana jednostka dla danego typu elementu w systemie.