Wstęp
Zarządzanie parametrami systemowymi znajduje się w zakładce "Administracja" -> "Parametry systemu". Po wejściu pojawi się widok:
Wyświetlane podłużne prostokąty reprezentują kategorię parametrów systemowych (Activities, Authorization itd.). Kliknięcie w prostokąt lub ikonkę rozwijania po prawej stronie powoduje wyświetlenie wszystkich parametrów dla wybranej kategorii.
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.