Wstęp
Zarządzanie parametrami systemowymi odbywa się po wejściu w zakładkę Administracja --> Konfiguracja systemu --> Parametry systemowe. Po wejściu ukaże nam się następujący widok:
Rysunek XXX przedstawia widok z zakładki "Parametry systemowe"
Parametry systemowe dzielimy na kategorie w których zawarte są parametry każdej z kategorii:
- Zadania (Activities) - parametry dotyczące zadań i procesów w których możemy zdefiniować np. użytkownika buforowego, dodać nowy format daty
- Autoryzacja (Authorization) - w tej kategorii możemy zdefiniować wszelkie parametry dotyczące logowania w systemie, np. używanie captcha do logowania, ustawienie automatycznego logowania
- Dokumenty (Docuemnts) - dotyczy ustawień dokumentów w systemie PlusWorkflow. W tym obszarze możemy zdefiniować np. typ połączenia podczas wyświetlania dokumentów (HTTP lub HTTPS)
- Eksport (Export) - parametry dotyczące eksportu do Excel, PDF, np. ustalenie ilości wierszy w paczce (np. za jednym razem eksportujemy 1000 wierszy do pliku, po czym ponawiamy akcję)
- Rozszerzenia (Features) - posiada parametr dotyczący wyświetlania wielu wykonawców jednego zadania oddzielonych przecinkiem w wynikach wyszukiwania
- Ogólne (General) - parametry odpowiedzialne za m. in. hasło uniwersalne do logowania, ustawienie wspieranych języków systemu, widzialność systemu z zewnątrz
- Powiadomienia (Notifications) - ustawienia dotyczące wysyłania powiadomień systemowych, tj. konfiguracja serwera wysyłki maili
- Buforowe wysyłanie powiadomień (Notifications.Buffered) - ustawienia dotyczące buforowego wysyłania wiadomości email
- Dodatkowe uprawnienia systemowe (Rights.optional) - ustawienia aktywujące dodatkowe uprawnienia w systemie, które nie są domyślnie dostępne
- Zadania zaplanowane (ScheduledTasks) - parametry konfiguracyjne mechanizmu uruchamiania zadań zaplanowanych
- Wyszukiwanie (Search) - parametr w którym ustalamy czy wyszukiwana fraza jest częścią wyszukiwanej treści czy jest dokładnie taką treścią jaką szukamy
- Zastępstwa (Substitutions) - parametry dotyczące zastępstw m.in. akcji wywoływanej po pomyślnym przypisaniu zastępstwa
Ikonka wykrzyknika przy kluczu parametru mówi o tym, iż parametr oprócz tego, iż jest określony w bazie danych, jest również zdefiniowany w pliku konfiguracyjnym systemu.
Zarządzanie
Parametry systemowe są zmiennymi wykorzystywanymi przez system lub przez konkretne wdrożenie posiadającymi konkretny typ:
- tekstowy
- całkowity
- zmiennoprzecinkowy
- hasło
- lista wartości
- logiczny
- datowy
Parametry decydują o określonych aspektach działania systemu np. wysyłaniu powiadomień, kwestie autoryzacji oraz bardziej technicznych aspektów jak cacheowania skryptów itp. Każdy z parametrów posiada opis jego wpływu na działanie systemu, który pokazuje się po najechaniu kursorem. Niektóre z parametrów ładowane są tylko i wyłącznie przy starcie systemu. Oznacza to, iż po zmianie takiego parametru należy zrestartować system, aby zmiana w działaniu systemu była widoczna.
Każda zmiana wartości parametrów powinna być zamierzona i świadoma. Nadanie nieprawidłowych wartości parametrów może spowodować nieprawidłowe działanie systemu.
Eksport i import
Parametry systemowe można wyeksportować klikając w przycisk Eksport znajdujący się w prawym górnym rogu zakładki. Zostanie ściągnięty plik w formacie JSON zawierający strukturę wszystkich parametrów pogrupowanych względem kategorii. Przykładowy fragment wyeksportowanego pliku:
[ { "key" : "Activities", "parameters" : [ { "key" : "ActivateDeadlineNotifications", "value" : "false", "removable" : false, "type" : "BOOLEAN", "comboValues" : [ ] }, { "key" : "activityform.livevalidation", "value" : "true", "removable" : false, "type" : "BOOLEAN", "comboValues" : [ ] }, { "key" : "activityform.thousandseparator", "value" : null, "removable" : false, "type" : "TEXT", "comboValues" : [ ] } ] } ]
Parametry można zaimportować do systemu otwierając okno importu po kliknięciu w przycisk Import.
Po wybraniu wyeksportowanego pliku .json możliwy jest import parametrów. Dla każdej kategorii:
- jeżeli kategoria nie istnieje, zostanie utworzona
Dla każdego parametru:
- jeżeli parametr istnieje, jego wartość zostanie nadpisana. Nie zostania zmieniona jego obecna kategoria.
- jeżeli parametr nie istnieje, zostanie utworzony w kategorii określonej w importowanym pliku
Tak samo jak w przypadku zmiany wartości parametrów - każdy import parametrów powinien być zamierzony i świadomy.
Dodawanie i usuwanie parametrów
Usuwanie parametrów jest realizowane przez kliknięcie przycisku Usuń umieszczonym obok parametru. Niektóre z parametrów są niemożliwe do usunięcia, gdyż są używane wewnętrznie przez system.
Dodawanie nowego parametru do systemu powinno wiązać się z implementacją jego obsługi w systemie. Dodawanie parametru odbywa się przez kliknięcie w przycisk Nowy parametr. Zostanie wyświetlone okienko:
Należy podać klucz parametru (unikatowy), klucz kategorii oraz typ parametru. Dla parametru typu Lista wartości należy określić również przynajmniej jedną wartość możliwą do wybrania.