Parametry globalne - ustawienia instalacji i granica między parametrem a skorowidzem
Ustawienia całej instalacji Studio VSS.net zebrano w panelu Administratora, w widoku Parametry programu. Dotyczą reguł haseł, załączników, aplikacji mobilnej oraz modułów agencji celnej, rozpoznawania tablic i powiadomień YMS. Strona podaje kody parametrów z opisem dla wdrożeniowca, pokazuje, które z nich kierownik zmienia sam na ekranie Parametry, i wyznacza granicę między parametrem a skorowidzem. Długość okna i godziny pracy parametrami nie są.
Po lewej stronie widać menu panelu: Użytkownicy, Skorowidze, Numeracja, Parametry i Multilanguage, a niżej kolejne grupy. Na środku otwarte jest okno zmiany hasła dla wybranego konta, z dwoma polami i przyciskami Anuluj oraz Zapisz. Samego widoku parametrów nie pokazujemy na zrzutach, ponieważ wartości części parametrów są danymi dostępowymi instalacji.
Na tej stronie
- Jak wygląda edytor parametrów
- Co jest parametrem, a co nie
- Parametry modułów awizacji
- Ekran Parametry dla kierownika
- Parametry wspólne instalacji
- Reguły haseł
- Załączniki i komunikaty
- Typowe sytuacje przy pracy z parametrami
- Wartości dostępowe
- Ćwiczenie: rozstrzygnij, gdzie ustawia się dane zachowanie awizacji
- Najczęstsze pytania
- Słownik pojęć
Jak wygląda edytor parametrów
Widok Parametry programu układa parametry w karty według grup. Nad listą stoi wyszukiwarka przeszukująca opis, kod i wartość, a przyciski Pokaż nieaktywne i Pokaż ukryte odsłaniają wpisy domyślnie niewidoczne. Przy każdym parametrze widać opis, zasięg i typ danych.
Edytor dobiera pole do typu danych: tekst jednowierszowy i wielowierszowy, liczba, wybór tak lub nie, data, lista wyboru oraz pola na adres e-mail, adres strony i hasło. Maska parametru określa zakres liczb albo listę dozwolonych opcji, a edytor jej pilnuje. Wartość typu hasło jest daną dostępową, dlatego zmienia się ją tylko w panelu Administratora.
Co jest parametrem, a co nie
Bywa, że długość okna, godziny pracy magazynu i powiadomienia zalicza się do parametrów. W Studio VSS.net tak nie jest: te zachowania mają własne miejsca ustawień. Tabela wskazuje, gdzie szukać każdego z nich.
| Zachowanie | Gdzie się je ustawia | Opis w instrukcji |
|---|---|---|
| Reguły złożoności hasła i jego długość | Parametry, grupa Administracja | Sekcja Reguły haseł na tej stronie |
| Dozwolone rozszerzenia załączników | Parametr systemowy albo kategoria załączników | Sekcja Załączniki i komunikaty |
| Pytanie przy wyjściu z transakcji w aplikacji mobilnej | Parametr z grupy aplikacji mobilnej | Sekcja Załączniki i komunikaty |
| Interwał komunikatów | Parametr | Sekcja Załączniki i komunikaty |
| Długość okna czasowego | Skorowidze Algorytmy i Rodzaje transportów oraz pole Czas /min/ w kartotece kontrahenta | Skorowidze w panelu Administratora |
| Godziny okien | Skorowidz Okienka czasowe | Skorowidze awizacyjne w roli logistyki |
| Pojemność okna, minimum 20 minut, 30 dni naprzód, 99 palet | Stałe programu | Skorowidze w panelu Administratora, sekcja o stałych programu |
| Widoki i uprawnienia kalendarza | Konfiguracja kalendarza w kartotece Kalendarze | Kalendarze w kartotekach |
| Format numeru dokumentu | Maska zapisana w programie; liczniki w panelu Numeracja | Numeracja dokumentów |
| Czas sesji | Konfiguracja serwera aplikacji; w konfiguracji standardowej sesja wygasa po 120 minutach bezczynności | Logowanie do Studio VSS.net |
| Poczta wychodząca i bramka SMS | Ustawienia zespołu wdrożeniowego | Sekcja Wartości dostępowe |
Reguła podziału. Jeśli zachowanie dotyczy okna, rampy, rodzaju transportu albo statusu, szukaj go w skorowidzu lub w kartotece kalendarzy. Parametr obowiązuje całą instalację i dotyczy kont, załączników, komunikatów, aplikacji mobilnej oraz reguł modułów: agencji celnej, rozpoznawania tablic i powiadomień YMS.
Parametry modułów awizacji
Tabela zbiera parametry, które sterują modułami agencji celnej, rozpoznawania tablic (LPR) i powiadomień YMS. Kod parametru wpisuje się w wyszukiwarkę widoku Parametry programu. Kolumna „Kto zmienia” mówi, czy wartość ustawia kierownik na ekranie Parametry, ekran modułu, czy wyłącznie administrator.
| Kod | Do czego służy | Wartości | Kto zmienia |
|---|---|---|---|
AC_BLOKADA_RAMPY | Blokada wezwania na rampę pojazdu z towarem pod dozorem celnym, dopóki agencja nie wyda zgody. Obejście ma tylko kierownik agencji. | 1 - blokada, 0 - tylko ostrzeżenie | Kierownik (ekran Parametry) |
AC_ZGODA_CZ | Kierownik agencji może wydać zgodę na rozładunek części ładunku. | 1 - tak, 0 - nie | Kierownik (ekran Parametry) |
AC_TOL_WAGA | Dopuszczalna różnica masy brutto z dokumentu celnego i z wagi; większa daje ostrzeżenie. | 0-50 % | Kierownik (ekran Parametry) |
AC_PROG_ZOLTY | Po tylu minutach oczekiwania na decyzję agencji awizacja na pulpicie robi się żółta. | 1-480 min, mniej niż próg czerwony | Kierownik (ekran Parametry) |
AC_PROG_CZERW | Po tylu minutach oczekiwania na decyzję agencji awizacja robi się czerwona. | 1-480 min | Kierownik (ekran Parametry) |
AC_AWAR_UZUP_DNI | Dni na dołączenie dokumentu po zgodzie wydanej w trybie awaryjnym; potem awizacja trafia na listę braków. | 1-30 dni | Kierownik (ekran Parametry) |
AC_MCS_ALARMY | Na ile dni przed końcem terminu składowania pod dozorem idzie e-mail do agencji i klienta. | liczby dni po przecinku, np. 30,15,7 | Kierownik (ekran Parametry) |
AC_POW_KMAG_EML | Adres kierownika magazynu, który dostaje powiadomienie o decyzji agencji. | jeden adres e-mail; puste - bez powiadomienia | Kierownik (ekran Parametry) |
AC_TEL_AGENCJI | Telefon agencji wstawiany w SMS do kierowcy, gdy odprawa jest wstrzymana. | numer, 7-15 cyfr | Kierownik (ekran Parametry) |
AC_POW_JEZYK | Język SMS do kierowcy, którego numer nie ma rozpoznanego prefiksu kraju. | pl-PL, en-GB, de-DE, uk-UA, ru-RU | Kierownik (ekran Parametry) |
AC_URL_PUESC | Link do portalu celnego PUESC przy dokumencie na pulpicie agencji. | adres https:// | Kierownik (ekran Parametry) |
LPR_TOL_PRZED | Odczyt tablicy wcześniej niż tyle minut przed oknem awizacji nie zostanie do niej dopasowany. | 0-720 min | Kierownik (ekran Parametry) |
LPR_TOL_PO | Odczyt tablicy później niż tyle minut po końcu okna awizacji nie zostanie do niej dopasowany. | 0-720 min | Kierownik (ekran Parametry) |
YMS_POW_TRYB | Tryb wysyłki powiadomień YMS: PROBA - nic nie wychodzi, TEST - wszystko na adres i numer testowy, PROD - do odbiorców. | PROBA, TEST, PROD | Ekran Powiadomienia YMS |
YMS_POW_TEST_EML, YMS_POW_TEST_SMS | Adres e-mail i numer, na które w trybie TEST trafiają wszystkie powiadomienia. | e-mail, telefon | Ekran Powiadomienia YMS |
YMS_POW_DYSP_EML, YMS_POW_DYSP_SMS, YMS_POW_DYSP_TEAMS | Dane dyspozytora placu - odbiorcy powiadomień z regułą „dyspozytor”. | e-mail, telefon, kanał Teams | Ekran Powiadomienia YMS |
MODUL_AC, MODUL_YMS_PLUS, MODUL_YMS_GA | Włączniki modułów: agencja celna, YMS+ (zadania placu, etapy, powiadomienia), Gate Assistant. | 1 - włączony, 0 - wyłączony | Administrator |
AC_KIEROWNICY | Kierownicy agencji: obejście blokady rampy i zgoda częściowa. | role albo loginy po przecinku | Administrator |
AC_ROLE_PLOMBY | Kto potwierdza plomby celne na bramie i rampie. | role albo loginy po przecinku | Administrator |
AC_MAGAZYN_WMS | Magazyn WMS, do którego trafiają dokumenty celne utworzone w VSS. | kod magazynu; puste - magazyn VSS | Administrator |
PAR_KIER_ROLE_VSS | Kto oprócz SuperVisora i Administratora otwiera ekran Parametry. | role albo loginy; domyślnie MAW | Administrator |
Gdy parametru nie ma w bazie. Parametry modułu pojawiają się w bazie przy jego instalacji. Brak parametru oznacza, że moduł nie jest wdrożony - program działa wtedy na wartościach domyślnych, a ekran Parametry pokazuje komunikat „Brak parametru w bazie - moduł niewdrożony”.
Ekran Parametry dla kierownika
Kierownik awizacji nie musi prosić administratora o zmianę progów czy tolerancji. W menu Kartoteki, pozycja Parametry, ma ekran z parametrami modułów awizacji: przy każdym widzi nazwę, kod, opis, zakres i bieżącą wartość. Parametry oznaczone „Zmieniasz tutaj” mają pole do edycji, a przycisk Zapisz zmiany zapisuje wszystkie zmiany naraz albo żadną, gdy któraś wartość jest błędna.
- Otwórz Kartoteki, pozycja Parametry.
- Zmień wartości w polach sekcji Agencja celna albo Rozpoznawanie tablic (LPR). Zakres liczby jest podany pod opisem parametru.
- Kliknij Zapisz zmiany. Komunikat podaje liczbę zapisanych parametrów; Cofnij zmiany przywraca wartości z bazy.
- Parametry powiadomień YMS zmienisz przyciskiem Otwórz ekran modułu - okno Powiadomień YMS otwiera się nad listą, a po jego zamknięciu wartości odświeżają się same.
Program pilnuje zakresów w przeglądarce i drugi raz przy zapisie, a próg żółty czasu reakcji agencji musi być mniejszy od czerwonego. Każda zmiana trafia do historii zmian z loginem i poprzednią wartością. Ekran otwiera SuperVisor, Administrator i role wpisane w parametrze PAR_KIER_ROLE_VSS (domyślnie rola kierownika awizacji). Włączniki modułów i listy uprawnionych zostają u administratora, a hasła i dane dostępowe nie są na tym ekranie pokazywane.
Parametry wspólne instalacji
Te parametry dotyczą całej instalacji, nie samego modułu awizacji, i zmienia je administrator w widoku Parametry programu. Wartości danych dostępowych nie są podawane w instrukcji.
| Kod | Do czego służy |
|---|---|
PASS_MIN_LENGTH, PASS_MAX_LENGTH, PASS_NUMBER, PASS_SPECIAL_SIGNS, PASS_SMALL_LETTERS, PASS_BIG_LETTERS | Reguły złożoności hasła (grupa Administracja). |
ZALEXT | Dozwolone rozszerzenia załączników. |
ROZSZERZENIA_FOTO | Dozwolone rozszerzenia zdjęć. |
ConfirmExitAndroid | Aplikacja mobilna pyta przed wyjściem z transakcji (False - nie pyta). |
NotifyInterwal | Co ile sekund odświeżane są komunikaty dla użytkownika. |
DefMonth | Domyślny zakres dni wstecz w rejestrach. |
LANGUAGE | Wybór języka interfejsu dla użytkowników. |
KNKONOdb, KNKONDost, KNKONPrac i pozostałe KNKON*, KNASO* | Które zakładki mają kartoteki kontrahentów i asortymentu. |
WWWQrCode, WWWPictures, StudioSystemWww | Adresy witryn: kodów QR, zdjęć i zakładki StudioSystem. |
DefMail, EmailHost, EmailUser, EmailPassword | Poczta wychodząca - dane dostępowe, ustawiane przy wdrożeniu. |
SMSAPIURL, SMSAPILOG, SMSAPIPAS | Bramka SMS - dane dostępowe. |
SQLReportServer, SQLReportServerPath, SQLUser, SQLPassword i pozostałe SQL* | Serwer raportów (wydruki) - dane dostępowe. |
Lic*, MULTILANGUAGE | Dane licencji - ustawia SoftwareStudio. |
Reguły haseł
Reguły złożoności hasła są parametrami w grupie Administracja. Ustala się w nich wymagane cyfry i znaki specjalne, litery małe i wielkie oraz minimalną i maksymalną długość hasła. Hasło dla konta ustawia administrator w oknie widocznym na zrzucie, a zasady tworzenia kont opisuje strona o użytkownikach systemu.
Załączniki i komunikaty
Formularz awizacji ma kafel Załączniki, a podpowiedź PDF, JPG, XLSX jest tylko wskazówką. Dopuszczalne rozszerzenia ustala parametr systemowy albo kategoria załączników, więc wdrożenie powinno zdefiniować listę zgodną z polityką bezpieczeństwa firmy.
Pliki dodane przez kafel zapisują się od razu, jeszcze przed zapisem awizacji. Pole uwag ma licznik znaków, a u dołu formularza jest pasek z przyciskami Anuluj i Zapisz awizację oraz licznik pól wymaganych. Formularz opisuje strona Nowa awizacja.
Aplikacja mobilna ma własny parametr: pytanie o potwierdzenie przy wyjściu z transakcji można wyłączyć. Osobny parametr ustawia interwał komunikatów.
Typowe sytuacje przy pracy z parametrami
Większość pytań administratorów wynika z pomylenia warstw konfiguracji albo z pamięci podręcznej aplikacji. Tabela zbiera najczęstsze objawy.
| Objaw | Przyczyna | Co zrobić |
|---|---|---|
| W parametrach nie ma ustawienia długości okna | Długość okna nie jest parametrem, tylko wynikiem algorytmów w skorowidzach. | Sprawdź skorowidze Algorytmy i Rodzaje transportów oraz pole Czas /min/ kontrahenta. |
| Po zmianie parametru aplikacja działa po staremu | Aplikacja korzysta z zapamiętanej kopii konfiguracji. | Zresetuj pamięć podręczną w sekcji Konfiguracja panelu Administratora. |
| Nowe hasło jest odrzucane | Hasło nie spełnia reguł złożoności z grupy Administracja. | Sprawdź wymagane znaki oraz minimalną i maksymalną długość, potem ustaw hasło ponownie. |
| Załącznik nie chce się dodać | Rozszerzenie pliku nie należy do listy dozwolonych. | Dopisz rozszerzenie w parametrze systemowym albo w kategorii załączników. |
| Aplikacja mobilna pyta o potwierdzenie wyjścia z transakcji | Parametr z grupy aplikacji mobilnej przewiduje takie pytanie. | Zmień parametr, jeśli firma nie chce dodatkowego kroku. |
W praktyce administracyjnej zmienia się jeden parametr naraz. Przed zmianą zapisuje się dotychczasową wartość, a po zmianie sprawdza się efekt w miejscu, którego parametr dotyczy: w oknie zmiany hasła, w kafelku załączników albo w aplikacji mobilnej. Przy dwóch zmianach jednocześnie trudno ustalić, która z nich wywołała objaw.
Wartości dostępowe
Dane dostępowe nie są opisane. Dane poczty wychodzącej i bramki SMS ustawia się przy wdrożeniu. Parametry z adresami serwerów, loginami, hasłami i tokenami nie są opisane w instrukcji ani pokazane na zrzutach, bo ich ujawnienie osłabiłoby zabezpieczenia instalacji. Nie zapisuj takich wartości w notatkach ani w wiadomościach e-mail.
Zasięg zmiany. Parametr globalny obowiązuje wszystkich użytkowników instalacji, a nie jedno konto. Po zmianach konfiguracji administrator resetuje pamięć podręczną aplikacji, żeby nowa wartość zaczęła działać. Wdrożenie omawia strona o instalacji i konfiguracji.
Ćwiczenie w demo - lekcja lub zajęcia
Ćwiczenie: rozstrzygnij, gdzie ustawia się dane zachowanie awizacji
Uczeń rozdziela cztery warstwy konfiguracji: parametr, skorowidz, kartotekę kalendarzy i stałą programu. Panel Administratora nie należy do ról demo, więc ćwiczenie korzysta z roli Kierownik logistyki. Czas: około 15 minut.
- Otwórz demo Studio VSS.net, wybierz rolę Kierownik logistyki i zapisz sześć ustawień: minimalna długość hasła, minimalny czas obsługi, czas obsługi transportu TIR, godziny okienek magazynu, liczba dni naprzód w wyborze terminu oraz domyślny widok kalendarza ogólnego.
- W menu Kartoteki, pozycja Skorowidze, odczytaj czas obsługi transportu TIR w skorowidzu Rodzaje transportów i godziny okienek w skorowidzu Okienka czasowe.
- W menu Kartoteki, pozycja Kalendarze, odszukaj domyślny widok kalendarza ogólnego.
- W menu Awizacje otwórz Nową awizację, wybierz obiekt, następnie magazyn i bramę, sprawdź w wyborze terminu ostatni dzień do wskazania i zamknij formularz przyciskiem Anuluj.
- Przypisz każde z sześciu ustawień do jednego miejsca: parametr, skorowidz, kalendarz albo stała programu, i uzasadnij wybór jednym zdaniem.
Pytanie kontrolne. Dlaczego minimalny czas obsługi nie jest parametrem, choć dotyczy całej instalacji, i kto musi zmienić program, jeśli firma chce okna krótszego niż 20 minut?
Podstawa programowa. Ćwiczenie realizuje efekt "opracowuje harmonogram procesu transportowego" z kwalifikacji SPL.04 Organizacja transportu (jednostka SPL.04.4) w zawodzie technik logistyk, w tym kryterium optymalizacji harmonogramu procesu transportowego (podstawa programowa zawodu technik logistyk). Pozostałe ćwiczenia zebraliśmy na stronie demo VSS.net na zajęciach z logistyki, a pełny opis systemu - na stronie Studio VSS.net - system awizacji dostaw i YMS.
Najczęstsze pytania
Czy długość okna czasowego można zmienić w parametrach globalnych?
Nie. Długość okna wynika z aktywnych algorytmów w skorowidzach, z okien czasowych rodzajów transportu i z pola Czas /min/ w kartotece kontrahenta. Minimum 20 minut jest stałą programu.
Gdzie ustawia się reguły haseł?
W parametrach, w grupie Administracja. Reguły obejmują wymagane cyfry i znaki specjalne, litery małe i wielkie oraz minimalną i maksymalną długość hasła.
Dlaczego instrukcja nie podaje wartości części parametrów?
Część wartości to dane dostępowe: adresy serwerów, loginy, hasła i tokeny. Kody i znaczenie parametrów są opisane w tabelach na tej stronie, a wyszukiwarka edytora przeszukuje opis, kod i wartość.
Czy czas sesji jest parametrem?
Nie. To ustawienie serwera aplikacji. W konfiguracji standardowej sesja wygasa po 120 minutach bezczynności.
Czy zmiana parametru dotyczy jednego użytkownika?
Nie. Parametry globalne obowiązują całą instalację. Zmianę wykonuje administrator, a po zmianie konfiguracji resetuje pamięć podręczną aplikacji.
Czy kierownik może sam zmienić próg czasu reakcji agencji?
Tak. Ekran Parametry w menu Kartoteki pozwala kierownikowi zmienić parametry agencji celnej i LPR. Włączniki modułów i listy uprawnionych zmienia administrator.
Słownik pojęć
- Parametr globalny
- Ustawienie obowiązujące całą instalację, na przykład reguła złożoności hasła, edytowane w widoku Parametry programu.
- Maska parametru
- Zapis ograniczający wartość parametru do zakresu liczb albo do listy dozwolonych opcji; edytor pilnuje jej przy zapisie.
- Stała programu
- Reguła zapisana w kodzie, na przykład minimalny czas obsługi 20 minut; nie jest parametrem ani wpisem w słowniku.
- Reguły złożoności hasła
- Zestaw parametrów wymagających określonych znaków w haśle oraz jego minimalnej i maksymalnej długości.
- Pamięć podręczna aplikacji
- Zapisana kopia ustawień konfiguracyjnych; po zmianie konfiguracji administrator ją resetuje, żeby aplikacja użyła nowych wartości.