Właściwości ERP

Wprowadzenie

Specyfikacje Java przewidują, że parametry programów mogą być konfigurowane za pomocą plików tekstowych. Pliki te nazywane są plikami właściwości, mają rozszerzenie .properties i zawierają informacje wiersz po wierszu w postaci Name=Value.

Właściwości te są używane w systemie do przypisywania wartości do ustawień, które nie znajdują się w konfiguracji systemu lub mogą zostać wprowadzone do konfiguracji systemu dopiero w kolejnych wersjach. Ustawienia można wprowadzać dla systemu lub dla poszczególnych serwerów aplikacji systemu ERP (SAS).

W artykule opisano użycie plików właściwości oraz ich skutki. Znajduje się tutaj również lista nazw wszystkich zdefiniowanych właściwości, możliwe wartości i opis.

Można także użyć polecenia dspprphlp, aby wyświetlić bezpośrednią pomoc dotyczącą właściwości w toolshell. Warunkiem wstępnym jest istnienie logicznego typu danych i odpowiedniego opisu danych dla odpowiedniej właściwości oraz to, że logiczny typ danych jest oparty na logicznym typie danych com.cisag.pgm.datatype.Property. Dotyczy to prawie wszystkich poniższych właściwości.

Grupa docelowa

  • Programiści aplikacji
  • Administratorzy systemu
  • Konsultanci techniczni

Definicje

Właściwość ERP to właściwość Java dostarczona przez producenta w celu kontrolowania systemu ERP. Nazwy właściwości ERP zazwyczaj zaczynają się od com.cisag. Istnieje logiczny typ danych dla prawie każdej właściwości, który jest oparty na logicznym typie danych com.cisag.pgm.datatype.Property. Właściwość serwera ERP i właściwość systemu ERP również należą do właściwości ERP. Odpowiednie właściwości są zapisywane w plikach, które są dostępne ze ścieżki klasy po uruchomieniu serwera aplikacji systemu ERP (SAS), takich jak plik server.properties.

Serwer aplikacji systemu ERP (SAS) przetwarza żądania wysyłane za pośrednictwem różnych kanałów komunikacji. W czasie wykonywania serwer aplikacji systemu ERP jest realizowany przez proces maszyny wirtualnej Java, który wykonuje silnik systemu. Definicja parametrów wymaganych do uruchomienia (nazwa, połączenia z bazą danych, podstawowy adres URL) odbywa się w bazie danych konfiguracji systemu.

Właściwość Java to nazwa klucza w obiekcie klasy java.util.Properties, dla którego jako wartość można przechowywać ciąg znaków. Właściwości Java są używane do przekazywania parametrów do JVM (wirtualnej maszyny Java), a tym samym kontrolowania zachowania wykonywanego programu Java. Wartość właściwości Java można określić bezpośrednio podczas uruchamiania wirtualnej maszyny Java za pomocą opcji -DName=Value lub odczytać z pliku tekstowego z rozszerzeniem .properties.

Plik właściwości jest plikiem tekstowym w formacie uniksowym z rozszerzeniem .properties, w którym wartości właściwości Java są przechowywane linia po linii w postaci Name=value.

Narzędzie jest specjalną formą aplikacji, którą można uruchomić z powłoki narzędzi.

Toolshell – środowisko oparte na powłoce MS-DOS, które każdy serwer aplikacji systemu ERP zapewnia do wykonywania podstawowych, długotrwałych i krytycznych dla systemu funkcji. Zwłaszcza, gdy na przykład serwer WWW nie jest dostępny. Przykłady: Zmiany w tabelach bazy danych, importowanie aktualizacji oprogramowania.

Opis

Podczas uruchamiania serwera aplikacji systemu ERP (SAS) brane są pod uwagę ustawienia z dwóch źródeł. Przy czym, niektóre parametry mogą być jawnie określone w wierszu poleceń toolshell systemu operacyjnego. Więcej informacji można znaleźć w artykule Serwer aplikacji systemu ERP.

Ponadto SAS ładuje niektóre pliki właściwości i ustawienia z systemu plików podczas uruchamiania. Dostępne tam wpisy są zapisywane w obiekcie właściwości klasy java.lang.System.

Wartości dostępne po uruchomieniu można wyświetlić w Toolshell za pomocą polecenia set. Kolejność źródeł, w których SAS wyszukuje wartości właściwości, jest następująca:

  1. system.properties – od pierwszego wystąpienia w ścieżce klas, zwykle SEMIRAMIS_HOME/classes.
  1. server.properties – z katalogu classes względem bieżącego katalogu roboczego WORK_DIRECTORY/classes.
  1. ustawienia systemowe – z bazy konfiguracyjnej, np. połączenie z bazą danych repozytorium w kokpicie systemu.
  1. ustawienia serwera – z bazy konfiguracyjnej, np. parametry JVM i katalog serwera plików w Panel System
Uwaga
Położenie katalogu roboczego zależy od typu uruchomienia SAS. W przypadku SAS, który został uruchomiony jako usługa, katalogiem roboczym jest katalog, w którym znajduje się program wykonywalny usługi. Szczegóły w artykule Instalacja: Comarch ERP Enterprise jako usługa w systemie Linux lub Windows.

Ustawienia dokonywane są w pliku system.properties i dotyczą wszystkich SAS w systemie. Brak pliku system.properties jest identyfikowany jako błąd.

Plik server.properties dla indywidualnego serwera aplikacji i specjalnych ustawień serwera w konfiguracji systemu jest opcjonalny. Wartości określone w pliku server.properties zastępują wartości określone w pliku system.properties, jeśli specyfikacja jest dozwolona na poziomie pliku server.properties. Nie jest wymagane, aby serwer aplikacji posiadał plik server.properties.

Poniższe rozdziały zawierają definicje różnych właściwości i opisy ich zastosowania.

Właściwości Java

Dla Java Runtime Environment dostępne są również ustawienia, które mogą być konfigurowane poprzez wpisy w plikach właściwości (property). W systemie wykorzystywane są niektóre z tych nazw ustawień:

Właściwość Opis
mail.protocol Używany protokół mail, obecnie obsługiwany jest tylko smtp (wartość domyślna). Ta właściwość może być używana w pliku system.properties.
mail.smtp.host Nazwa hosta serwera SMTP używanego do wysyłania wiadomości mail. Ta właściwość może być użyta w pliku system.properties.
mail.user.name Użytkownik na serwerze mail skonfigurowanym w mail.smtp.host. Ta właściwość może być użyta w pliku system.properties.
mail.user.password Hasło użytkownika serwera mail skonfigurowanego w mail.user.name. Wartością domyślną jest hasło SMTP, które mogło zostać wprowadzone dla systemu w aplikacji Panel System. Tej właściwości można użyć w pliku system.properties.
mail.smtp.ssl.enable Wartość true aktywuje szyfrowanie połączenia przez SSL/TLS. Wartość domyślna: false. Ta właściwość może być użyta w pliku system.properties.
mail.smtp.ssl.trust Właściwość pozwalająca na określenie nazwy hosta serwera SMTP, w tym przypadku certyfikat serwera nie będzie sprawdzany z certyfikatami zainstalowanymi w systemie operacyjnym podczas nawiązywania połączenia. Połączenie jest nadal możliwe. Bez szyfrowania połączenia właściwość ta nie ma znaczenia. Właściwość może być użyta w pliku system.properties.
mail.addReceiptRequestHeaders Ta właściwość może być używana do określenia, które dodatkowe nagłówki powinny być dodawane do wszystkich wychodzących wiadomości e-mail. Możliwe wartości to Disposition-Notification-To, X-Confirm-Reading-To i Return-Receipt-To. Wartości muszą być oddzielone przecinkami. Potwierdzenie odbioru może być wyłączone w wielu serwerach e-mail, aby zapobiec otrzymywaniu maili typu SPAM. Użytkownik musi zaakceptować potwierdzenie odczytu, aby zostało ono wysłane. Właściwość może być użyta w pliku system.properties.

Właściwości ERP

Poniżej wymieniono właściwości, które można skonfigurować dla systemu, podzielone są na kategorie według ich zastosowania.

Uruchamianie serwera aplikacji

Wszystkie informacje o systemie i bazie konfiguracyjnej są zapisywane w bazie konfiguracyjnej oraz w pliku system.properties lub server.properties. Jest to konieczne, aby serwer aplikacji mógł otworzyć połączenie z bazą konfiguracyjną podczas uruchamiania.

Właściwość Wyjaśnienie
com.cisag.sys.kernel.SystemName Nazwa systemu. Ta właściwość musi być podana w pliku system.properties.
com.cisag.sys.kernel.ConfigurationName Nazwa bazy konfiguracyjnej. Ta właściwość może być podana w pliku system.properties.
com.cisag.sys.kernel.ConfigurationType Sterownik używany dla bazy danych. Sterownik zależy od używanego systemu zarządzania bazą danych (DBMS) i określa m.in. mapowanie typów danych systemu ERP na natywne typy danych DBMS. Dostępne są następujące wartości:

  • 2 – DB2 UDB for iSeries
  • 5 – Oracle
  • 6 – SQL-Server

Ta właściwość może być używana w pliku system.properties.

com.cisag.sys.kernel.ConfigurationDriver Sterownik JDBC dla bazy danych. Sterownik JDBC musi pasować do sterownika bazy danych dla Comarch ERP Enterprise. Używany sterownik decyduje m.in. o protokole, za pomocą którego odbywa się komunikacja między serwerami aplikacji systemu ERP (SAS) a bazą danych. Biblioteki Java sterowników są, w zależności od licencji producenta, dostarczane z systemem instalacyjnym dla danej platformy bazy danych albo muszą zostać pozyskane bezpośrednio od producenta. Biblioteki sterowników są otwierane przez system z folderu semiramis/lib. Dostępne są następujące wartości:

  • 3 – DB2 UDB for iSeries (native) – biblioteka: brak
  • 2 – DB2 UDB for iSeries (remote) – biblioteka: jt400.jar
  • 12 – jTDS SQL-Server – biblioteka: jtds.jar
  • 1 – Oracle – biblioteka: ojdbc14.jar lub ojdbc6.jar
  • 5 = Microsoft SQL-Server – biblioteka: sqljdbc4.jar.
com.cisag.sys.configuration.log.DatabaseDataValidation.
EnableMicrosoftJDBCDriver
Ta właściwość umożliwia użycie sterownika Microsoft JDBC. Właściwość może być ustawiana wyłącznie w systemach testowych. Zalecane jest, aby nie ustawiać tej właściwości w innych systemach.
com.cisag.sys.kernel.sql.CisDatabaseGeneric.ReadWrite Ta właściwość wspiera funkcję tylko do odczytu sterowników JDBC. Właściwość może być ustawiana wyłącznie w systemach testowych. Zalecane jest, aby nie ustawiać tej właściwości w innych systemach.
com.cisag.sys.kernel.ConfigurationDriverAccessPath Ścieżka sterownika JDBC, pod którą dostępna jest baza  konfiguracyjna. Przykłady składni ścieżki sterownika JDBC znajdują się w artykule Panel System: Baza danych. Ta właściwość musi być podana w pliku system.properties.
com.cisag.sys.kernel.InstallationModeJDBCDriverAccessPath Ta właściwość określa źródło ścieżki sterownika JDBC, pod którą dostępna jest baza danych konfiguracyjna. Możliwe wartości:

  • true – wszystkie połączenia bazodanowe używają dla ścieżki sterownika JDBC wartości z właściwości com.cisag.sys.kernel.ConfigurationDriverAccessPath
  • false (wartość domyślna) – wszystkie połączenia bazodanowe używają dla ścieżki sterownika JDBC wartości z bazy konfiguracyjnej. Ta właściwość musi być podana w pliku system.properties.
com.cisag.sys.kernel.ConfigurationUser Nazwa użytkownika używana do logowania do bazy konfiguracyjnej. Podana wartość jest zawsze konwertowana na wielkie litery. Ta właściwość musi być podana w pliku system.properties.
com.cisag.sys.kernel.ConfigurationPassword Hasło użytkownika używane do logowania do bazy konfiguracyjnej. Podana wartość jest zawsze konwertowana na wielkie litery. Wartość proponowana: nazwa użytkownika. Ta właściwość może być podana w pliku system.properties. Domyślnie hasło podawane jest w postaci jawnej. System może zapisać hasło w postaci zaszyfrowanej, zgodnie z opisem we właściwości com.cisag.sys.kernel.EncryptConfigurationPassword. W takim przypadku wartość rozpoczyna się od ENCRYPTED, po czym następuje zaszyfrowane hasło.
com.cisag.sys.kernel.EncryptConfigurationPassword Hasło używane do logowania do bazy konfiguracyjnej jest podane we właściwości com.cisag.sys.kernel.ConfigurationPassword w pliku system.properties. Ta właściwość (EncryptConfigurationPassword) określa, czy hasło ma zostać zapisane w tym miejscu w postaci zaszyfrowanej przy następnym odczycie pliku. Nie steruje ona tym, czy aktualnie wpisane hasło jest zaszyfrowane. Możliwe wartości:

  • true – hasło ma zostać zaszyfrowane
  • false (wartość domyślna) – hasło nie ma zostać zaszyfrowane. Jeżeli właściwość jest ustawiona na true, podczas następnego wczytania pliku zostanie on zmodyfikowany, a hasło zostanie zaszyfrowane, jeżeli dotąd nie było zaszyfrowane. Odwrotność nie obowiązuje, tzn. zaszyfrowane hasło nie zostanie odszyfrowane. W takim przypadku właściwość nie ma wpływu. Ta właściwość może być podana w pliku system.properties.
com.cisag.sys.kernel.ConfigurationVersion Krótka informacja o bazie konfiguracyjnej. Wartość ma wyłącznie charakter informacyjny. Ta właściwość może być podana w pliku system.properties.
com.cisag.sys.kernel.ConfigurationTimeout Czas w sekundach, po którym połączenie z bazami danych jest rozłączane w przypadku braku aktywności. 0 oznacza nieskończoność. Wartość proponowana: 60. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.kernel.ConfigurationCatalog Katalog używany do dostępu do bazy konfiguracyjnej. Podana wartość jest zawsze konwertowana na wielkie litery. Wartość proponowana: nazwa użytkownika. Ta właściwość może być podana w pliku system.properties.
com.cisag.sys.kernel.ConfigurationSchema Schemat dostępu do bazy konfiguracyjnej. Podana wartość jest zawsze konwertowana na wielkie litery. Wartość proponowana: nazwa użytkownika. Ta właściwość może być podana w pliku system.properties.
com.cisag.sys.kernel.ConfigurationContentLanguage Język podstawowy bazy  konfiguracyjnej. Wartość proponowana: de. Ta właściwość może być podana w pliku system.properties.
com.cisag.sys.kernel.ConfigurationConnectionDriver Specyficzny dla serwera aplikacji, odmienny sterownik JDBC do dostępu do bazy konfiguracyjnej. Możliwe wartości:

  • 1 – Oracle
  • 2 – DB2/400
  • 3 – DB2/400 native
  • 5 – SQL-Server

Ta właściwość może być podana w pliku server.properties.

com.cisag.sys.kernel.ConfigurationConnectionDriverAccessPath Specyficzna dla serwera aplikacji, odmienna ścieżka sterownika JDBC, pod którą dostępna jest baza konfiguracyjna. Ta właściwość jest ustawiana, jeżeli we właściwości com.cisag.sys.kernel.ConfigurationConnectionDriver wskazano odmienny sterownik.
Przykład
jdbc:oracle:thin:@:1521:orcl.
Ta właściwość może być podana w pliku server.properties.
com.cisag.sys.kernel.ConfigurationConnectionReadOnlyConnections Liczba połączeń z bazą danych używanych do odczytu danych bazy konfiguracyjnej. Wartość proponowana: 0, tj. obliczanie automatyczne. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.configuration.obj.Database..<ŚcieżkaAtrybutu> Zmienia atrybut konfiguracji bazy danych. Dodatkowe informacje znajdują się w artykule Właściwości bazy danych. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.configuration.obj.SVMDBConnection..<ŚcieżkaAtrybutu> Zmienia atrybut konfiguracji połączenia z bazą danych serwera aplikacji. Dodatkowe informacje znajdują się w artykule Właściwości bazy danych. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.kernel.ConfigurationConnectionTransactionalConnections Liczba połączeń z bazą danych używanych do zapisu danych bazy konfiguracyjnej. Wartość proponowana: 5. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.kernel.ConsoleCodePage Strona kodowa, z jaką teksty są wyprowadzane na konsolę. Parametr jest wymagany, aby znaki diakrytyczne były wyświetlane poprawnie. Ta właściwość działa tylko wtedy, gdy parametr -consoleCodePage nie został jawnie podany podczas uruchamiania SAS. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.kernel.webserver.TrustMode Tryb sprawdzania zaufanych urzędów certyfikacji przez serwer WWW. Możliwe wartości:

  • trustmanager
  • truststore
  • automatic (wartość domyślna)

Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.

com.cisag.sys.kernel.messaging.MaximumTimeDifferenceMillis Maksymalnie dopuszczalna różnica zegarów systemowych podczas logowania serwera aplikacji do serwera komunikatów systemu. Wartość podawana jest w milisekundach. Wartość jest dodatnia i obejmuje również opóźnienie transmisji wiadomości w jedną stronę, które wynosi średnio ok. 100 ms. W systemie produkcyjnym wartość powinna być możliwie mała, aby zapewnić poprawne działanie wszystkich serwerów aplikacji . Jeżeli wartość jest zbyt duża (na przykład większa niż 1 sekunda), do bazy danych mogą trafić błędne znaczniki czasu, a kolejność czasowa rekordów nie będzie zagwarantowana. Wartość domyślna: 1000 ms. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.workflow.WorkflowEngine Aktywacja silnika workflow. W trybie deweloperskim można zablokować uruchamianie silnika workflow poprzez ustawienie wartości false. To samo można osiągnąć, używając parametru -noWorkflowEngine podczas uruchamiania SAS. Silnik workflow nie może zostać uruchomiony później. Możliwe wartości:

  • true (wartość domyślna) – silnik workflow jest uruchamiany
  • false = silnik workflow nie jest uruchamiany.

Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.

com.cisag.sys.kernel.debug.DebugClass Właściwość służąca do włączenia debugowania dla klasy podczas uruchamiania serwera aplikacji systemu ERP (SAS). Włączenie debugowania dla klasy odbywa się zwykle przy użyciu polecenia dbgcls. Aby włączyć debugowanie już podczas uruchamiania SAS, zanim możliwe będzie wprowadzanie poleceń, można użyć tej właściwości. Użycie dla klasy o w pełni kwalifikowanej nazwie : com.cisag.sys.kernel.debug.DebugClass.=. odpowiada wartości parametru -level polecenia dbgcls. Możliwe wartości :

  • 1 – wyłączone
  • 2 – wiersz statusu
  • 5 – informacja
  • 15 – ostrzeżenie
  • 25 – błąd
  • 100 – wszystkie

Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.

com.cisag.sys.kernel.debug.DebugSystemOut Debugowanie wyjścia tekstowego. Jeżeli właściwość zostanie ustawiona na true, w pliku log po każdej linii zostanie dopisany stacktrace miejsca w programie, które spowodowało wyjście. Możliwe wartości:

  • true – generuj stacktrace
  • false (wartość domyślna) – nie generuj stacktrace.
Uwaga
Ponieważ debugowanie wyjścia tekstowego bardzo mocno wpływa na wydajność, właściwość powinna być ustawiana na true wyłącznie do faktycznego wyszukiwania błędów w pliku server.properties konkretnego serwera aplikacji systemu ERP.

Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.

com.cisag.sys.kernel.AutoUpgradeEnabled Aktywacja uruchamia serwer aplikacji systemu ERP (SAS) w trybie upgrade. Za pomocą tej właściwości można uniemożliwić uruchamianie SAS w trybie upgrade, ustawiając wartość false. Możliwe wartości:

  • true (wartość domyślna) =  tryb auto-upgrade jest możliwy
  • false = tryb auto-upgrade nie jest możliwy.

Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.

com.cisag.sys.kernel.CisPatchClassLogic. Właściwość służąca do sterowania automatycznym sprawdzaniem poprawek (patch) podczas uruchamiania serwera aplikacji systemu ERP (SAS). Szczegółowe informacje znajdują się w dokumentacji ERP-System-Application-Server. Sprawdzanie może zostać włączone lub wyłączone dla poszczególnych pakietów. Użycie dla pakietu o w pełni kwalifikowanej nazwie : com.cisag.sys.kernel.CisPatchClassLogic.=<Wartość>. Możliwe wartości: · true – aktywuj sprawdzanie dla tego pakietu · false – wyłącz sprawdzanie. Domyślnie wybrane pakiety są włączone, a ich lista znajduje się w artykule Serwer aplikacji systemu ERP. Dla wszystkich pozostałych wartość domyślna wynosi false. Ustawiona wartość dla pakietu obowiązuje automatycznie również dla wszystkich zawartych podpakietów, które mogą być dodatkowo konfigurowane osobnymi właściwościami. Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.kernel.IgnoreGenerateTime Podczas uruchamiania serwera sprawdzane jest, czy czasy generowania tabel bazy danych w repozytorium oraz w bazach OLTP są zgodne. Jeżeli czasy nie są zgodne, serwer WWW oraz zadania przetwarzania w tle nie są uruchamiane w celu uniknięcia błędów danych. Za pomocą właściwości com.cisag.sys.kernel.IgnoreGenerateTime można zapobiec temu sprawdzeniu. Możliwe wartości:

  • true – sprawdzenie nie jest wykonywane; mogą powstać błędy danych
  • false – sprawdzenie jest wykonywane

Ta właściwość może być używana w pliku system.properties.

Konfiguracja
Właściwość Objaśnienie
com.cisag.sys.kernel.caching.CaseSensitivityMode Za pomocą tej właściwości można wpływać na obsługę wielkości liter. Możliwe wartości:

  • 1 – we wszystkich polach tekstowych można wprowadzać i wyszukiwać z rozróżnianiem wielkich/małych liter
  • 2 – wyszukiwanie opisów jest niezależne od wielkości liter
  • 3 – wyszukiwanie identyfikacji i oznaczeń jest niezależne od wielkości liter
  • 4 (wartość domyślna:) – w polach identyfikacyjnych można wprowadzać wyłącznie wielkie litery;

Wyszukiwanie identyfikacji i oznaczeń jest niezależne od wielkości liter; jest to najbardziej wydajne ustawienie wyszukiwania niezależnego od wielkości liter; warunkiem jest, aby w bazie danych zawartości wszystkich pól identyfikacyjnych były już zapisane wielkimi literami. We wszystkich polach identyfikacyjnych można wprowadzać i wyszukiwać wyłącznie wielkie litery. Ta właściwość może być używana w pliku system.properties.

com.cisag.sys.kernel.login.CisLoginManagerLogMode Za pomocą tej właściwości można sterować, czy logowania użytkowników są rejestrowane. Możliwe wartości:

  • 1 – wszystko jest rejestrowane
  • 2 ( wartość zalecana) – logowania użytkowników typu Server (np. SOM, WebServices, CORBA) nie są rejestrowane
  • 3 – żadne logowania nie są rejestrowane.

Ta właściwość może być używana w pliku system.properties oraz w pliku server.properties.

com.cisag.sys.gui.jobcontrol.StatusBarMinimumUpdateDelaySeconds Minimalny czas w sekundach pomiędzy dwiema aktualizacjami ikon statusu w obszarze informacyjnym dla zadań wydruku i zleceń przetwarzania. Zwiększenie wartości powoduje rzadszą aktualizację ikon statusu, co sprawia, że zapytania do bazy danych o status otwartych zadań są wykonywane rzadziej. Jest to istotne zwłaszcza w testach obciążeniowych, gdy dla jednego użytkownika aktywnych jest znacznie więcej niż 3 logowania dialogowe i wykonywanych jest wiele roundtripów w krótkich odstępach. Przy wartości 0 ikony statusu logowania dialogowego są aktualizowane przy każdym roundtripie, w którym zmienił się status zadania wydruku lub przetwarzania. Przy wartości 30 aktualizacja ikon statusu następuje najwcześniej co 30 sekund. Jeżeli użytkownik ustawił powiadomienie o zakończeniu zlecenia przetwarzania w formie okna dialogowego, aktualizacja ikon statusu następuje niezależnie od tej właściwości przed otwarciem okna dialogowego. Wartość proponowana: 10. Ta właściwość może być używana w pliku system.properties oraz w pliku server.properties.
com.cisag.sys.kernel.CisSessionManager.checkSeconds Interwał sprawdzania timeoutu dla sesji interaktywnych. Wartość proponowana: 30 sekund.
Uwaga
Tej właściwości nie należy zmieniać.
Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.kernel.CisSessionManager.timeoutSeconds Czas timeoutu dla sesji interaktywnych. Wartość proponowana: 60 sekund.
Uwaga
Tej właściwości nie należy zmieniać.
Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.kernel.CisSessionManager.actionTimeoutMinutes Czas, po którym sesja staje się nieważna, jeżeli użytkownik nie wykonuje żadnej akcji. Wartość podawana jest w minutach. Najmniejsza wartość wynosi 15 minut. Przy wartości -1 sesje nie stają się nieważne. Wartość domyślna: 240 minut. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.kernel.CisSessionControlBlock.debugging Aktywacja stacktrace’ów dla tworzenia sesji.
Uwaga
Tej właściwości nie należy zmieniać.
Może ona wpływać na wydajność systemu i jest przeznaczona do diagnostyki przez Asystę Techniczną. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.kernel.messaging.CommunicationTimeout Timeout komunikacji określa, jak długo serwer aplikacji czeka na odpowiedź innego serwera aplikacji. Jeżeli serwer aplikacji nie odpowie w czasie timeoutu, przyjmuje się, że nie może już odpowiadać i połączenie jest przerywane. W komunikacji pomiędzy serwerem aplikacji a serwerem komunikatów po przekroczeniu timeoutu serwer aplikacji jest kończony. Jeżeli serwer komunikatów przez długi czas nie odpowiada, na przykład z powodu garbage collection, timeout komunikacji może zostać przekroczony. W takim przypadku należy lepiej skonfigurować garbage collection serwera komunikatów lub zwiększyć timeout komunikacji. Wartość domyślna: 300000 ms, czyli 5 minut. Wartość należy podać jako liczbę całkowitą w milisekundach. Ta właściwość może być używana w pliku system.properties.
com.cisag.sys.kernel.locking.LockTimeout Czas timeoutu dla żądania blokady. Po upływie tego czasu żądanie blokady jest przerywane, jeżeli blokada nie mogła zostać przyznana. Wartość domyślna: 60000 ms, czyli 1 minuta. Wartość należy podać jako liczbę całkowitą w milisekundach. Ta właściwość może być używana w pliku system.properties.
com.cisag.sys.kernel.locking.SynchronizationInterval Czas pomiędzy dwiema synchronizacjami współdzielonych cache wszystkich serwerów aplikacji systemu. Określa on, jak długo współdzielone cache mogą zawierać nieaktualne dane, zanim zostaną one odświeżone przez następną synchronizację. Podczas synchronizacji wszystkie nieaktualne dane są usuwane ze współdzielonych cache. Wartość domyślna: 30 s. Wartość należy podać jako liczbę całkowitą w sekundach. Ta właściwość może być używana w pliku system.properties.
com.cisag.sys.kernel.locking.SynchronizationQueueSize Maksymalny rozmiar bufora synchronizacji podawany jako liczba obiektów. Wartość ta jest istotna dla systemów z więcej niż jednym serwerem aplikacji i wpływa na skuteczność współdzielonych cache przy operacjach zapisu na obiektach biznesowych. Jeżeli bufor synchronizacji jest zbyt mały, obiekty biznesowe są częściej odczytywane z bazy danych podczas operacji zapisu. Wartość domyślna: 5000 obiektów. Wartość należy podać jako liczbę całkowitą. Ta właściwość może być używana w pliku system.properties.
com.cisag.sys.kernel.ExceptedFromIdentityValiditySystems Lista systemów deweloperskich wyłączonych z weryfikacji ustawień listy identyfikatorów. Należy podać jedną lub kilka nazw systemów rozdzielonych przecinkami. Jeżeli właściwość nie jest ustawiona i podczas uruchamiania serwera komunikatów systemu deweloperskiego zostaną znalezione inne systemy deweloperskie o tym samym prefiksie deweloperskim, ale z różnymi ustawieniami listy identyfikatorów, serwer komunikatów zostanie wyłączony z komunikatem błędu.
Uwaga
Jeżeli obiekty deweloperskie o tej samej nazwie i typie są tworzone lub edytowane w różnych systemach, to ich wewnętrzne identyfikatory muszą zostać zsynchronizowane za pomocą listy identyfikatorów. Może to mieć miejsce wyłącznie w systemach o tym samym prefiksie deweloperskim. Jeżeli istnieje jednak równoległy system deweloperski o tym samym prefiksie deweloperskim, a synchronizacja przez listę identyfikatorów nie jest skonfigurowana, wówczas albo ten dodatkowy system, albo bieżący system musi zostać wpisany do właściwości. W takim przypadku obiekty deweloperskie mogą być przenoszone pomiędzy systemami wyłącznie poprzez import/eksport XML. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.workflow.ShowExtendedWorkflowPane Rozszerza dokowane okno Wyszukiwanie zadań o dodatkowe pola kryteriów wyszukiwania Klasyfikacja 1 do Klasyfikacja 5. Pola służą do dalszego ograniczania wyświetlanych zadań. Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.
com.cisag.app.inventory.disposition.ReservedItemsIngoreBlockedInventory Za pomocą tej właściwości ponownie aktywowane jest stare zachowanie, zgodnie z którym zablokowane stany, jeżeli zostały już zarezerwowane, są mimo to przydzielane: com.cisag.app.inventory.disposition.ReservedItemsIngnoreBlockedInventory=true. Konfiguracja standardowa odpowiada braku właściwości lub ustawieniu właściwości na false. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.pgm.appserver.UserPasswordRetries Liczba dozwolonych prób po błędnym wprowadzeniu hasła użytkownika. Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.
Uwaga
Liczba prób jest liczona między sesjami. Po osiągnięciu liczby prób bez podania poprawnego hasła użytkownik zostaje zablokowany na określony czas. W tym czasie logowanie nie jest możliwe nawet przy poprawnym haśle. Czas blokady zależy od liczby nieudanych prób.
com.cisag.pgm.appserver.UserPasswordLength Za pomocą tej właściwości określana jest długość hasła użytkownika oraz włączane lub wyłączane są kontrole złożoności hasła. Przy wartości 0 złożoność hasła nie jest sprawdzana. Przy wartości większej niż 1 sprawdzana jest długość hasła oraz złożoność hasła. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.pgm.appserver.UserPasswordRegEx<1…9> Jeżeli kontrola złożoności hasła użytkownika jest aktywna, reguły złożoności mogą być modyfikowane poprzez zdefiniowanie ich w następujących właściwościach:

  • com.cisag.pgm.appserver.UserPasswordRegEx1 do
  • com.cisag.pgm.appserver.UserPasswordRegEx9.

Należy pamiętać, że składnia musi spełniać reguły składni wyrażeń regularnych języka Java. Jeżeli kontrole złożoności są aktywne, domyślnie obowiązują następujące reguły:

  • hasło musi zawierać co najmniej jedną małą literę, jedną wielką literę oraz jedną cyfrę
  • długość hasła musi być co najmniej równa długości określonej we właściwości Długość.

W takim przypadku wartości dla następujących właściwości są już ustawione:

  • com.cisag.pgm.appserver.UserPasswordRegEx1
  • com.cisag.pgm.appserver.UserPasswordRegEx2
  • com.cisag.pgm.appserver.UserPasswordRegEx3

Należy dostosować treść komunikatu SYS-03987, jeżeli kontrola zostanie rozszerzona o nowe lub zmienione reguły. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.

com.cisag.sys.kstore.log.KnowledgeStoreUserFolder Ta właściwość określa foldery, w których mają znajdować się foldery prywatne. Do folderu prywatnego dostęp ma wyłącznie właściciel oraz administratorzy folderu. Folder prywatny ma taką samą nazwę jak nazwa użytkownika właściciela. Można podać kilka folderów w liście rozdzielonej przecinkami. Jeżeli nazwa folderu zaczyna się od „//” oraz nazwy bazy danych, ustawienie dotyczy folderu tylko na tej bazie danych. Jeżeli nazwa folderu nie zaczyna się od „//”, ustawienie dotyczy wszystkich baz danych. Wartość proponowana dla tej właściwości systemowej jest pusta. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
Monitorowanie
Właściwość Wyjaśnienie
com.cisag.sys.kernel.MonitoringMode Włączenie lub wyłączenie rejestrowania danych przez monitory wydajności. Możliwe wartości:

  • 1 (wartość domyślna) – aktywowane – wartość 1 włącza monitorowanie, wszystkie aktywne monitory wydajności rejestrują dane
  • 0 – dezaktywowane – wartość 0 wyłącza monitorowanie, standardowy monitor wydajności oraz wszystkie inne aktywne monitory wydajności nie rejestrują danych.

Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.

Wskazówka
Wartość 2 włącza monitoring, ale dodatkowo umożliwia włączanie i wyłączanie standardowego monitora wydajności.
com.cisag.sys.kernel.ThreadManagerThreadCpuTimeMode Monitorowanie czasu CPU dla wątków. Możliwe wartości:

  • 1 – wartość domyślna JVM – używana jest wartość domyślna JVM, system nie zmienia ustawienia monitorowania
  • 2 – aktywowane – jeżeli JVM wspiera monitorowanie, zostaje ono włączone niezależnie od wartości domyślnej JVM; może to powodować spadki wydajności zależnie od JVM; jeżeli JVM nie wspiera monitorowania, podczas uruchamiania serwera aplikacji wyświetlany jest komunikat błędu
  • 3 – dezaktywowane – jeżeli JVM wspiera monitorowanie, zostaje ono wyłączone niezależnie od wartości domyślnej JVM; może to powodować wzrost wydajności zależnie od JVM; jeżeli JVM nie wspiera monitorowania, podczas uruchamiania serwera aplikacyjnego wyświetlany jest komunikat błędu.

Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.

com.cisag.sys.kernel.ThreadManagerThreadContentionMonitoringMode Monitorowanie współbieżności wątków. Możliwe wartości:

  • 1 – wartość domyślna JVM – używana jest wartość domyślna JVM, system nie zmienia ustawienia monitorowania
  • 2 – aktywowane – jeżeli JVM wspiera monitorowanie, zostaje ono włączone niezależnie od wartości domyślnej JVM; może to powodować spadki wydajności zależnie od JVM; jeżeli JVM nie wspiera monitorowania, podczas uruchamiania serwera aplikacyjnego wyświetlany jest komunikat błędu
  • 3 – dezaktywowane – jeżeli JVM zasadniczo wspiera monitorowanie, zostaje ono wyłączone niezależnie od wartości domyślnej JVM; może to powodować wzrost wydajności zależnie od JVM; jeżeli JVM nie wspiera monitorowania, podczas uruchamiania serwera aplikacji wyświetlany jest komunikat błędu.

Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.

com.cisag.sys.util.LogFileCount Maksymalna liczba archiwizowanych plików logów. Jeżeli bieżący plik log osiągnie maksymalny rozmiar, zostaje przemianowany na pierwszy plik archiwalny. Następnie pierwszy plik archiwalny staje się drugim itd. Zmiana nazw jest wykonywana aż do maksymalnej liczby. Ostatni plik archiwalny jest usuwany. Wartość domyślna: 5. Wartość podawana jest jako liczba całkowita. Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.util.LogFileSize Maksymalny rozmiar pliku log w kilobajtach (kB). 1 kilobajt odpowiada 1024 bajtom. Wartość domyślna: 1024 kB. Wartość podawana jest jako liczba całkowita. Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.
Organizacja deweloperska
Właściwość Wyjaśnienie
com.cisag.app.internal.log.AdministrativeUserList Następujące aplikacje wspierają tryb administracyjny:

  • Paczki instalacyjne
  • Zapytania supportowe
  • Zlecenia deweloperskie

W trybie administracyjnym możliwa jest zmiana statusu zleceń oraz modyfikowanie relacji. W relacjach można również rejestrować takie typy, które normalnie są tworzone wyłącznie automatycznie. W tej właściwości można zapisać listę partnerów uprawnionych do włączenia w widoku wewnętrznym trybu administracyjnego za pomocą przełącznika na standardowym pasku narzędzi. Wartości listy są rozdzielane przecinkami. Niezależnie od tych partnerów, standardowy koordynator zdefiniowany w aplikacji Konfiguracja jest uprawniony do wykonywania powyższych zmian. Ta właściwość może być używana w pliku system.properties.

com.cisag.app.internal.log.SupportDefaultTargetRelease Wersja (release), dla której rejestrowane są zlecenia deweloperskie, paczki instalacyjne oraz zapytania supportowe. Wartość musi zostać podana jako liczba całkowita. Jeżeli jako wartość proponowana ma zostać ustawiona wartość poprzez właściwość ERP, prawidłowe są wyłącznie wartości z tego zestawu wartości: com.cisag.app.internal.SystemVRM. Wartość proponowana to release zdefiniowany dla systemu w aplikacji Panel System. Ta właściwość może być używana w pliku system.properties.
com.cisag.sys.services.supportrequest.log.MailSender Adres e-mail, z którego usługa zleceń deweloperskich wysyła wiadomości e-mail. Ta właściwość może być używana w pliku system.properties.
com.cisag.app.internal.SupportDeliveryMaxDownloadSize Maksymalny rozmiar w megabajtach, który w aplikacji Zapytanie o paczki instalacyjne może zostać wybrany do pobrania. Jeżeli właściwość nie zostanie podana, wartość domyślna wynosi 500. Liczba musi zostać podana jako liczba całkowita. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
com.cisag.sys.services.batch.MaximumOnlineBatchThreads Maksymalna liczba aplikacji w tle, które na serwerze aplikacji systemu ERP mogą być jednocześnie uruchamiane interaktywnie w ramach logowań dialogowych. Ograniczenie tej liczby zapewnia, że złożone, długo trwające zadania są wykonywane w tle na przeznaczonym do tego serwerze aplikacji , a nie na serwerze używanym interaktywnie. Tylko w ten sposób możliwe jest uzyskanie równomiernie dobrych czasów odpowiedzi. Wartość domyślna: 1.

  • Jeżeli zostanie podana wartość 0 i wykonanie w tle jest możliwe, odpowiednie przyciski Natychmiast lub Wyświetl w oknie dialogowym wydruku zostają ukryte.
  • Jeżeli zostanie podana wartość większa od 0, liczba aplikacji w tle uruchomionych przez użytkownika jest monitorowana, a użytkownik jest informowany, gdy uruchomienie aplikacji w tle nie jest możliwe z powodu ograniczenia.
  • Wartości większe niż 1 powinny być używane tylko wtedy, gdy serwer aplikacji faktycznie dysponuje wystarczającymi zasobami, tj. CPU i pamięcią, aby obsłużyć dodatkowe obciążenie.
  • Wartości mniejsze od 0 są ignorowane.

Ta właściwość może być używana w pliku system.properties lub w pliku server.properties.

com.cisag.sys.repository.tools.EclipseGenerationUseSystemName Za pomocą tej właściwości, ustawiając wartości true lub false, można określić, czy dla projektów Eclipse ma być używana nazwa systemu czy nazwa licencji. Wartość domyślna: false, co oznacza użycie nazwy licencji. Ta właściwość może być podana w pliku system.properties lub w pliku server.properties.
Obiekty deweloperskie
Właściwość Wyjaśnienie
com.cisag.sys.kernel.tools.ImportCheckCopyRight Linia informacji o prawach autorskich dla komentarza klas Java, wykorzystywana podczas kroku Import-Check w trakcie check-in klas Java. Ta właściwość może być używana w pliku system.properties.
com.cisag.sys.repository.SOMAccessEnabled Aktywuje dostęp do menedżera wydruków systemu ERP (SOM) podczas sprawdzania i zapisywania obiektów rozwojowych. Możliwe wartości:

  • true (wartość domyślna)
  • false

Ta właściwość jest przeznaczona wyłącznie do użytku przez Asystę Techniczną. Użycie jej w systemie nieobsługiwanym przez Comarch może zagrozić spójności obiektów deweloperskich, takich jak raporty.

com.cisag.sys.repository.RemoveRepositoryElements W przypadku atrybutów wieloelementowych Application (Action), Event, String table, OQL Search oraz ValueSet, atrybuty mogą być usuwane tylko wtedy, gdy obiekt deweloperski został utworzony w danym systemie albo atrybut rozpoczyna się prefiksem deweloperskim systemu. Po wyłączeniu tej kontroli możliwe jest usuwanie atrybutów bez tego prefiksu. Kontrola prefiksu dla adaptacji została wprowadzona później, dlatego mogą istnieć elementy bez prefiksu, które można usunąć za pomocą tej właściwości. Właściwość może być podana w pliku system.properties lub server.properties.
com.cisag.sys.repository.AdditionalTexts Umożliwia wprowadzanie modyfikowanie tekstów. Możliwe wartości:

  • true (wartość domyślna)
  • false

Właściwość powinna być używana, jeżeli w systemie nie ma być możliwe dostosowywanie tekstów. Aby w systemie nieobsługiwanym przez Comarch  możliwe było tłumaczenie kodu systemu przy użyciu Panel Redakcja, właściwość musi być ustawiona. Właściwość może być podana w pliku system.properties lub server.properties.

com.cisag.sys.repository.AdditionalNameSpaces Określa, które podprzestrzenie nazw mają zostać utworzone przez akcję Utwórz dodatkowe obiekty. Jeżeli właściwość nie jest podana, dla otwartej przestrzeni nazw tworzone są następujące podprzestrzenie: obj, ui, gui, log, model, reorg, hook, hook.ui, hook.log. Użycie następuje poprzez podanie wartości rozdzielonych przecinkami, np. com.cisag.sys.repository.AdditionalNameSpaces=obj,ui,gui. Właściwość może być używana w pliku system.properties.
com.cisag.sys.repository.CompileModeStrict Określa, czy katalog lib/ext ma być uwzględniany podczas kompilacji. Możliwe wartości:

  • true (wartość domyślna) – katalog lib/ext nie jest uwzględniany
  • false – katalog lib/ext jest uwzględniany.
Uwaga
Przed kolejną aktualizacją systemów wymagane biblioteki muszą być dostępne w systemie przed aktualizacją oprogramowania. Serwery aplikacji ERP muszą zostać ponownie uruchomione, aby katalog lib/ext został uwzględniony w ścieżce. Dopiero potem możliwa jest aktualizacja systemu.

Właściwość może być podana w pliku system.properties lub server.properties.

com.cisag.pgm.appserver.SourceEncoding Określa kodowanie, w jakim źródła Java są zapisywane w systemie plików. Możliwe wartości:

  • UTF16LE (wartość domyślna) – źródła zapisywane w kodowaniu UTF-16 little endian z BOM
  • UTF16BE – źródła zapisywane w kodowaniu UTF-16 big endian z BOM UTF16LE.

Właściwość może być podana w pliku system.properties lub server.properties.

com.cisag.sys.development.repository.businessobject.log.CanDeleteBusinessObject Określa, czy w systemie dozwolone jest usuwanie obiektów biznesowych. Możliwe wartości:

  • true
  • false (wartość domyślna)
Uwaga
Właściwość powinna być zmieniana wyłącznie po konsultacji z Asystą Techniczną. Jeżeli zostanie usunięty obiekt biznesowy, dla którego na systemach następczych istnieje rozszerzenie, wówczas wgrywanie aktualizacji oprogramowania na tych systemach nie będzie już możliwe.

Właściwość może być podana w pliku system.properties lub server.properties.

Licencjonowanie
Właściwość Wyjaśnienie
com.cisag.sys.kernel.customizing.Function Funkcja w aplikacji Konfiguracja służąca do aktywowania lub dezaktywowania serwera aplikacji systemu ERP (SAS). Jest to pomocne podczas testów w trakcie rozwoju nowych funkcji. Sposób użycia dla funkcji o nazwie <Nazwa>: com.cisag.sys.kernel.customizing.Function.<Nazwa>=true/false. Ta właściwość może być używana w pliku server.properties.
com.cisag.sys.kernel.licencing.LicenceKey Klucz licencyjny służący do włączania lub wyłączania serwera aplikacji systemu ERP (SAS). Włączenie jest możliwe wyłącznie w systemie deweloperskim i tylko dla kluczy licencyjnych, które są oryginalne w danym systemie. Sposób użycia dla klucza licencyjnego o nazwie <Nazwa>: com.cisag.sys.kernel.licencing.LicenceKey.<Nazwa>=true/false. Ta właściwość może być używana w pliku system.properties lub server.properties.
Logistyka oprogramowania
Właściwość Wyjaśnienie
com.cisag.sys.sis.AutomaticFileDeliveryCorrectionMode Tryb automatycznej korekty wydania plików. Jeżeli właściwość jest ustawiona, zainstalowane pliki aktywnych wydań plików są po aktualizacji systemu automatycznie sprawdzane pod kątem poprawności i w razie potrzeby przywracane z katalogów archiwalnych. Ustawienie domyślne (1) dotyczy automatycznej korekty wszystkich wydań plików z typem instalacji Automatyczna, które zostały wgrane w ramach aktualizacji oprogramowania. Automatyczna korekta może zostać wyłączona poprzez ustawienie wartości 2. Ta właściwość może być używana w pliku system.properties.
com.cisag.sys.sis.AutomaticFileDeliveryDeletionMode Tryb automatycznej reorganizacji wydań plików. Jeżeli właściwość jest aktywna (wartość 1), wydania plików są automatycznie reorganizowane w następujący sposób: w archiwum przechowywana jest wyłącznie najnowsza wersja wydania plików, natomiast wszystkie pliki wcześniejszych wersji są usuwane z archiwum w celu oszczędzania miejsca. Automatyczna reorganizacja jest wykonywana każdorazowo po aktualizacji systemu. Ustawienie domyślne dla tej właściwości to dezaktywowane (wartość 2). Właściwość może być aktywowana wyłącznie w systemach, które nigdy nie będą eksportować aktualizacji oprogramowania, ponieważ w przeciwnym razie mogą brakować plików niezbędnych do eksportu aktualizacji. Zazwyczaj są to wyłącznie systemy produkcyjne. Ta właściwość może być używana w pliku system.properties.
Wymiana danych
Właściwość Wyjaśnienie
com.cisag.sys.tools.bi.log.xml.AsynchParserCacheSize Za pomocą tej właściwości określana jest liczba wątków, które mają być utrzymywane w puli do parsowania plików XML. Jeżeli realizowana jest szczególnie duża liczba importów przez usługi zewnętrzne (np. CORBA lub WebService), może to ograniczyć liczbę tworzonych i usuwanych sesji. Jako wartość właściwości należy podać liczbę całkowitą. Ustawienie wartości 0 powoduje przywrócenie dotychczasowego zachowania. Wartość domyślna wynosi 3. Właściwość może być podana w pliku system.properties lub w pliku server.properties.
CORBA
Właściwość Wyjaśnienie
com.cisag.sys.kernel.corba.CorbaServerAutostart Automatyczne uruchamianie serwera CORBA systemu ERP. Jeżeli podczas uruchamiania serwera aplikacji wartość tej właściwości wynosi true, serwer CORBA jest uruchamiany automatycznie. Właściwości com.cisag.sys.kernel.corba.CorbaServerHost oraz com.cisag.sys.kernel.corba.CorbaServerPort określają adres, pod którym serwer CORBA jest dostępny. Właściwość może być używana w pliku server.properties.
com.cisag.sys.kernel.corba.CorbaServerHost Host, na którym dostępny jest serwer CORBA systemu ERP. Właściwość może być używana w pliku server.properties.
com.cisag.sys.kernel.corba.CorbaServerPort Port, na którym dostępny jest serwer CORBA systemu ERP. Właściwość może być używana w pliku server.properties.
com.cisag.sys.kernel.corba.CorbaServerTimeoutIntervalSeconds Liczba sekund, po których serwer przy braku aktywności klienta wykonuje wywołanie zwrotne (ping). Jeżeli wywołanie to zakończy się niepowodzeniem, logowanie do dostępu CORBA zostaje zakończone, ponieważ połączenie z klientem nie istnieje. Właściwość może być używana w pliku server.properties.
Przetwarzanie w tle i przetwarzanie wydruków
Właściwość Wyjaśnienie
com.cisag.sys.preferences.JobQueueOutputBatchTimeoutSeconds Czas oczekiwania (timeout) na zakończenie wszystkich zleceń wydruku utworzonych przez zlecenie przetwarzania. Po przekroczeniu czasu oczekiwania:

  • w protokole komunikatów tworzony jest wpis informujący, że nadal istnieją oczekujące wydruki, oraz
  • wątek przetwarzania w tle zostaje zwolniony i może obsłużyć kolejne zlecenie przetwarzania.

Wartość musi być podana jako liczba całkowita w sekundach. Wartość domyślna to 600 s, czyli 10 minut. Właściwość może być używana w pliku system.properties.

com.cisag.sys.preferences.JobQueueOutputOnlineTimeoutSeconds Czas oczekiwania (timeout) na zakończenie wszystkich zleceń wydruku utworzonych przez aplikację uruchomioną synchronicznie. Po przekroczeniu czasu oczekiwania użytkownik otrzymuje komunikat, że nadal istnieją oczekujące wydruki, po czym może kontynuować pracę. Wartość musi być podana jako liczba całkowita w sekundach. Wartość domyślna to 120 s, czyli 2 minuty. Właściwość może być używana w pliku system.properties.
com.cisag.sys.services.output.ODBCServerAddress Adres w postaci https://<baseurl>:<port>, pod którym możliwy jest dostęp do serwera aplikacji systemu ERP (SAS) lub na którym menedżer wydruków systemu ERP (SOM) wykonuje zapytanie ODBC. Serwer SAS dostępny pod tym adresem musi zezwalać na dostęp ODBC. Jeżeli ta właściwość jest ustawiona, konfiguracja we wszystkich połączeniach serwerów wydruku w konfiguracji systemu (dla wszystkich lub wybranego SAS) nie jest już brana pod uwagę. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.sys.services.output.ui.PrintServiceSearchIteratorRefresh Za pomocą tej właściwości można włączyć lub wyłączyć automatyczne wyszukiwanie fizycznych urządzeń wyjściowych w menedżerze wydruków systemu ERP. Ustawienie com.cisag.sys.services.output.ui.PrintServiceSearchIteratorRefresh=false wyłącza automatyczne wyszukiwanie. Wyłączenie może być zasadne, gdy wiele urządzeń wyjściowych jest dodawanych jedno po drugim. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.pgm.base.CisUpdateSubJobWorker Liczba wątków do równoległych aktualizacji danych. Wartość musi być podana jako liczba całkowita. W bardzo wydajnych systemach wyższa wartość może skrócić czas wykonywania równoległych aktualizacji danych. Wartość domyślna to 4. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.sys.gui.PrintSupport.defaultFormat = xlsx Przy eksporcie z niemodyfikowalnych tabel i list standardowo nie jest oferowany wybór formatu Excela, lecz stosowany jest format „xls”. Za pomocą tej właściwości format można zmienić na „xlsx”. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.pgm.gui.List.showExportDialog = true Przy eksporcie z niemodyfikowalnych tabel i list standardowo nie jest oferowany wybór formatu Excela, lecz stosowany jest format „xls”. Za pomocą tej właściwości można wyświetlić okno dialogowe wyboru formatu. Właściwość ta nie ma wpływu na tabele modyfikowalne ani listy wyników aplikacji typu Lista lub Zapytania — w ich przypadku okno dialogowe wyboru formatu jest zawsze wyświetlane. Właściwość może być używana w pliku system.properties lub server.properties.
Persistence service
Właściwość Objaśnienie
com.cisag.sys.kernel.sql.MaxTotalColumns Maksymalna dopuszczalna liczba kolumn w zapytaniu OQL. Wartość domyślna wynosi 1000. Wartość musi być podana jako liczba całkowita. Właściwość może być używana w pliku system.properties.
com.cisag.sys.kernel.sql.PreparedStatementCache Rozmiar pamięci podręcznej Prepared Statement na jedno połączenie z bazą danych. Wartość domyślna wynosi 20. Wartość musi być podana jako liczba całkowita. Właściwość może być używana w pliku server.properties.
com.cisag.sys.kernel.sql.WarningTotalColumns Liczba kolumn w zapytaniu OQL, od której ma zostać wyświetlone ostrzeżenie. Wartość domyślna wynosi 1000. Wartość musi być podana jako liczba całkowita. Właściwość może być używana w pliku system.properties.
com.cisag.sys.kernel.sql.DynamicObjectMinimumQuality Jakość schematu dynamicznego obiektu biznesowego określa liczbę tabel bazy danych potrzebnych do jego zapisu oraz stopień fragmentacji atrybutów z klasyfikacjami. Jakość jest optymalna, gdy nie jest możliwy lepszy rozkład atrybutów na tabele. Minimalna jakość określa, jaki procent jakości optymalnej musi zostać osiągnięty. Jeżeli po wygenerowaniu schematu jakość jest niższa niż określony procent, tabele bazy danych są generowane ponownie w jakości optymalnej. Odbudowa tabel w jakości optymalnej trwa dłużej niż standardowe generowanie schematu. Im wyższa minimalna jakość, tym częściej tabele muszą być ponownie budowane. Wartość domyślna wynosi 90. Wartość musi być liczbą całkowitą z zakresu od 1 do 100. Właściwość może być używana w pliku system.properties.
com.cisag.sys.kernel.sql.DynamicObjectUseBlobTableCount Określa, od ilu tabel bazy danych dynamiczny obiekt biznesowy ma być dodatkowo zapisywany redundantnie jako BLOB. Redundantny zapis w postaci BLOB przyspiesza ładowanie instancji dynamicznych obiektów biznesowych, lecz zwiększa zużycie miejsca w bazie danych i czas zapisu. Z tego względu ma to sens dopiero przy odpowiednio dużej liczbie tabel schematu. Wartość domyślna wynosi 5. Wartość musi być liczbą całkowitą większą niż 1. Właściwość może być używana w pliku system.properties.
com.cisag.sys.kernel.TransactionSizeLimit Maksymalny rozmiar transakcji określa wielkość bufora transakcji usługi persystencji. Przetwarzanie danych masowych może uwzględniać tę wartość przy doborze wielkości bloków. Maksymalny rozmiar transakcji podawany jest w bajtach. Wartość domyślna wynosi 2097152. Wartość musi być liczbą całkowitą większą niż 1. Właściwość może być używana w pliku system.properties.
com.cisag.sys.objsearch.SearchResultSize Maksymalna liczba rekordów wyświetlanych jako wynik pomocy wartości lub w dokowanym oknie wyszukiwania aplikacji. Definicja wpisu ma postać NazwaWyszukiwania#Liczba. W przypadku konfiguracji wielu wyszukiwań definicje należy oddzielić przecinkami. Domyślna liczba rekordów wynosi 500. Jeżeli podana zostanie wartość mniejsza niż 100, używana jest wartość domyślna. Wartości większe niż 500 powinny być stosowane wyłącznie wtedy, gdy serwer aplikacji dysponuje wystarczającymi zasobami (CPU i pamięcią). Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.pgm.search.gui.GridSearchSupport.defaultBufferSize Maksymalna liczba rekordów wyświetlanych jako wynik w aplikacji typu Cockpit. Wartość domyślna wynosi 1000. Wartości większe niż 1000 powinny być stosowane wyłącznie przy wystarczających zasobach serwera aplikacyjnego. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.pgm.search.gui.GridSearchSupport.asynchBufferSize Maksymalna liczba rekordów otwieranych podczas operacji Aktualizuj (w tle). Wartość domyślna wynosi 100000. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.pgm.search.gui.GridSearchSupport.maximumDetailRows Maksymalna liczba rekordów szczegółowych otwieranych dla jednego rekordu głównego. Wartość domyślna wynosi 10. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.sys.kernel.tools.ObjectUpdateConvertWorkerNumber Liczba wątków konwersji wykorzystywanych podczas konwertowania danych obiektu biznesowego w trakcie zmiany modelu danych. Konwersja danych odbywa się równolegle, co przy dużym wolumenie danych może skrócić czas wykonania. Właściwość dotyczy wyłącznie konwersji instancyjnej danych obiektów biznesowych przez serwer aplikacyjny. Wartość domyślna wynosi 3. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.sys.objsearch.ui.MaxVisibleSelectionFields Określa liczbę widocznych pól wyszukiwania w obszarze zapytań. Liczba ta musi być podzielna przez dwa i nie mniejsza niż dwa. Pozostałe pola wyszukiwania są wyświetlane w obszarze rozwijanym. Wartość domyślna wynosi 4. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.sys.objsearch.SearchDialogSize Zmienia rozmiar okna dialogowego wyszukiwania dla poszczególnych wyszukiwań OQL. Do nazwy właściwości należy dodać w pełni kwalifikowaną nazwę wyszukiwania OQL, oddzieloną kropką. Jako wartości podawana jest szerokość i wysokość okna w jednostce em, oddzielone znakiem x. Domyślny rozmiar okna dialogowego wynosi 90×70. Jeżeli w jednym oknie dialogowym wyświetlanych jest kilka wyszukiwań z różnymi rozmiarami, stosowane są największe z podanych wartości. Rozmiary mniejsze niż 90×70 są możliwe w ograniczonym zakresie i mogą być nadpisane przez minimalne rozmiary elementów interfejsu. Właściwość musi być zdefiniowana osobno dla każdego wyszukiwania. Może być używana w pliku system.properties lub server.properties.
com.cisag.sys.kernel.server.CisTransactionmanager.CheckMaximumOpenResultSets Umożliwia zapis komunikatu do pliku logów w przypadku, gdy dla jednej bazy danych istnieje więcej niż 10 otwartych zbiorów wyników (ResultSet). Ustawienie false powoduje wyłączenie komunikatu, true – jego włączenie. Wartość domyślna wynosi false w systemach testowych i produkcyjnych oraz true w pozostałych systemach. Właściwość może być używana w pliku system.properties lub server.properties.
Web server/GUI
Właściwość Objaśnienie
com.cisag.sys.dialog.web.javascript.encode Aktywacja kodowania plików JavaScript przesyłanych do przeglądarki. Możliwe wartości:

  • true
  • false (wartość domyślna)

Właściwość jest przeznaczona do celów diagnostycznych przez Asystę Techniczną.

com.cisag.sys.dialog.web.server-timeout Czas oczekiwania (timeout) w sekundach dla automatycznego zamykania połączeń serwera WWW przez przeglądarkę. Właściwość może być używana w pliku system.properties.
com.cisag.sys.www.daemon.secureRandom Służy do bezpiecznej inicjalizacji połączeń SSL serwera WWW. Ustawienie wartości DEVELOPMENT powoduje wyłączenie bezpiecznej inicjalizacji. Ze względów bezpieczeństwa zalecane jest to wyłącznie dla systemów rozwojowych. Właściwość może być używana w pliku system.properties lub server.properties.
com.cisag.sys.gui.jobcontrol.ui.EntityPopupMenuMaxSingleEntriesLimit Właściwość określa liczbę pozycji w menu kontekstowym wyświetlanych w formie liniowej. Jeżeli liczba pozycji jest większa, są one wyświetlane hierarchicznie. Właściwość nie wpływa na hierarchiczne wyświetlanie podmenu kontekstowych. Wartość domyślna to 7. Właściwość może być używana w pliku system.properties lub server.properties.
Serwer ODBC
Właściwość Objaśnienie
com.cisag.sys.odbc.MultipleRelationWarning Do dziennika systemowego zapisywane jest ostrzeżenie, jeżeli w raporcie używana jest kolumna _BK lub _text, której nie można jednoznacznie przypisać do relacji zdefiniowanej w obiekcie biznesowym. Możliwe wartości:

  • 1 – ostrzeżenie jest wyświetlane. Wartość domyślna wynosi1 dla systemów z poziomem wersjonowania 1–6
  • 0 – ostrzeżenie nie jest wyświetlane. Wartość domyślna wynosi 0 dla systemów z poziomem wersjonowania 7

Właściwość może być ustawiona w pliku system.properties lub server.properties.

Testy automatyczne
Właściwość Objaśnienie
com.cisag.sys.gui.jobcontrol.AutoTestMode Właściwość określa, czy w serwerze aplikacji systemu ERP dozwolone jest wsparcie testów automatycznych. Możliwe wartości:

  • true
  • false (wartość domyślna).

Właściwość może być ustawiona w pliku system.properties lub server.properties.

com.cisag.sys.dialog.web.WebDocumentWindow.testtool.keystroke Właściwość określa skrót klawiaturowy dla akcji umożliwiającej skopiowanie informacji o wybranym elemencie graficznego interfejsu użytkownika do schowka. Wartość: CTRL+ALT+SHIFT+F. Należy pamiętać, że ustawienie innej kombinacji klawiszy nie jest obecnie obsługiwane. Właściwość może być ustawiona w pliku system.properties lub server.properties.
Pozostałe pola
Właściwość Wyjaśnienie
com.cisag.app.general.extension.gui.MultiValueFieldDialogHeight Pozostałe pola z właściwością lista wartości udostępniają, za pomocą przycisku w kształcie rombu, okno dialogowe z akcjami umożliwiającymi wprowadzanie, usuwanie oraz sortowanie wartości. Za pomocą tej właściwości można dostosować domyślną wysokość okna dialogowego. Wartość domyślna wysokości wynosi 250. Właściwość może być ustawiona w pliku system.properties lub server.properties.
Zmiana kombinacji waluty krajowej
Właściwość Wyjaśnienie
com.cisag.app.tools.DomesticAmountConverter Za pomocą tej właściwości można umożliwić w aplikacji Konfiguracja zmianę już zdefiniowanych kombinacji waluty krajowej. Jeżeli właściwość jest aktywna, w aplikacji Konfiguracja w standardowym pasku narzędzi wyświetlany jest przycisk, za pomocą którego można otworzyć aplikację działającą w tle Konwersja waluty krajowej. Możliwe wartości:

  • true
  • false (wartość domyślna)

Właściwość może być ustawiona w pliku system.properties lub server.properties.

Uwzględnianie stopnia wydajności z danych podstawowych zasobów podczas obciążania
Właściwość Wyjaśnienie
com.cisag.app.production.bom.log.
PlanQuantitiesCalculator_UseResourcePerformanceRate
Za pomocą tej właściwości można ustawić, aby przy obciążaniu zleceń produkcyjnych, oprócz stopni wydajności zapisanych w pozycjach operacji i planu produkcji, do obliczeń uwzględniany był również stopień wydajności z danych podstawowych zasobów. Możliwe wartości:

  • true – stopień wydajności z danych podstawowych zasobów jest uwzględniany w obliczaniu stopnia wydajności podczas obciążania,
  • false – stopień wydajności z danych podstawowych zasobów jest ignorowany przy obliczeniach. Wartość domyślna to false.

Właściwość może być ustawiona w pliku system.properties lub server.properties.

Zmiana długości numeru konta
Właściwość Wyjaśnienie
com.cisag.app.customizing.financials.CustomizableMaxAccountNumberLength Za pomocą tej właściwości określane jest, czy w aplikacji Konfiguracja można zdefiniować maksymalną długość numerów kont. Możliwe wartości:

  • true – maksymalna długość numeru konta (od 1 do 50 znaków) może zostać zdefiniowana w aplikacji Konfiguracja
  • false – maksymalna długość numeru konta nie może zostać zdefiniowana w aplikacji Konfiguracja; numery kont mogą mieć maksymalnie 15 znaków. Wartość domyślna to false.

Właściwość może być ustawiona w pliku system.properties lub server.properties.

Zmiana długości rodzajów kosztów
Właściwość Wyjaśnienie
com.cisag.app.customizing.FinancialsMaxCostTypeCodeLength Za pomocą tej właściwości określane jest, czy w aplikacji Konfiguracja można zdefiniować maksymalną długość rodzajów kosztów. Możliwe wartości:

  • true – maksymalna długość rodzajów kosztów (od 1 do 55 znaków) może zostać zdefiniowana w aplikacji Konfiguracja
  • false (wartość domyślna)– maksymalna długość rodzajów kosztów nie może zostać zdefiniowana w aplikacji Konfiguracja; rodzaje kosztów mogą mieć maksymalnie 20 znaków.

Właściwość może być ustawiona w pliku system.properties lub server.properties.

Czy ten artykuł był pomocny?