Studio VSS.net - instrukcja obsługi

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ą.

Studio VSS.net - panel Administrator z pozycjami Użytkownicy, Skorowidze, Numeracja i Parametry oraz okno zmiany hasła z polami Hasło i Powtórz hasło
Menu panelu Administratora z pozycją Parametry oraz okno zmiany hasła, w którym obowiązują reguły ustawione w parametrach (wygląd z poprzedniej wersji interfejsu).

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

  1. Jak wygląda edytor parametrów
  2. Co jest parametrem, a co nie
  3. Parametry modułów awizacji
  4. Ekran Parametry dla kierownika
  5. Parametry wspólne instalacji
  6. Reguły haseł
  7. Załączniki i komunikaty
  8. Typowe sytuacje przy pracy z parametrami
  9. Wartości dostępowe
  10. Ćwiczenie: rozstrzygnij, gdzie ustawia się dane zachowanie awizacji
  11. Najczęstsze pytania
  12. 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.

ZachowanieGdzie się je ustawiaOpis w instrukcji
Reguły złożoności hasła i jego długośćParametry, grupa AdministracjaSekcja Reguły haseł na tej stronie
Dozwolone rozszerzenia załącznikówParametr systemowy albo kategoria załącznikówSekcja Załączniki i komunikaty
Pytanie przy wyjściu z transakcji w aplikacji mobilnejParametr z grupy aplikacji mobilnejSekcja Załączniki i komunikaty
Interwał komunikatówParametrSekcja Załączniki i komunikaty
Długość okna czasowegoSkorowidze Algorytmy i Rodzaje transportów oraz pole Czas /min/ w kartotece kontrahentaSkorowidze w panelu Administratora
Godziny okienSkorowidz Okienka czasoweSkorowidze awizacyjne w roli logistyki
Pojemność okna, minimum 20 minut, 30 dni naprzód, 99 paletStałe programuSkorowidze w panelu Administratora, sekcja o stałych programu
Widoki i uprawnienia kalendarzaKonfiguracja kalendarza w kartotece KalendarzeKalendarze w kartotekach
Format numeru dokumentuMaska zapisana w programie; liczniki w panelu NumeracjaNumeracja dokumentów
Czas sesjiKonfiguracja serwera aplikacji; w konfiguracji standardowej sesja wygasa po 120 minutach bezczynnościLogowanie do Studio VSS.net
Poczta wychodząca i bramka SMSUstawienia zespołu wdrożeniowegoSekcja 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.

KodDo czego służyWartościKto zmienia
AC_BLOKADA_RAMPYBlokada 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żenieKierownik (ekran Parametry)
AC_ZGODA_CZKierownik agencji może wydać zgodę na rozładunek części ładunku.1 - tak, 0 - nieKierownik (ekran Parametry)
AC_TOL_WAGADopuszczalna różnica masy brutto z dokumentu celnego i z wagi; większa daje ostrzeżenie.0-50 %Kierownik (ekran Parametry)
AC_PROG_ZOLTYPo tylu minutach oczekiwania na decyzję agencji awizacja na pulpicie robi się żółta.1-480 min, mniej niż próg czerwonyKierownik (ekran Parametry)
AC_PROG_CZERWPo tylu minutach oczekiwania na decyzję agencji awizacja robi się czerwona.1-480 minKierownik (ekran Parametry)
AC_AWAR_UZUP_DNIDni na dołączenie dokumentu po zgodzie wydanej w trybie awaryjnym; potem awizacja trafia na listę braków.1-30 dniKierownik (ekran Parametry)
AC_MCS_ALARMYNa ile dni przed końcem terminu składowania pod dozorem idzie e-mail do agencji i klienta.liczby dni po przecinku, np. 30,15,7Kierownik (ekran Parametry)
AC_POW_KMAG_EMLAdres kierownika magazynu, który dostaje powiadomienie o decyzji agencji.jeden adres e-mail; puste - bez powiadomieniaKierownik (ekran Parametry)
AC_TEL_AGENCJITelefon agencji wstawiany w SMS do kierowcy, gdy odprawa jest wstrzymana.numer, 7-15 cyfrKierownik (ekran Parametry)
AC_POW_JEZYKJęzyk SMS do kierowcy, którego numer nie ma rozpoznanego prefiksu kraju.pl-PL, en-GB, de-DE, uk-UA, ru-RUKierownik (ekran Parametry)
AC_URL_PUESCLink do portalu celnego PUESC przy dokumencie na pulpicie agencji.adres https://Kierownik (ekran Parametry)
LPR_TOL_PRZEDOdczyt tablicy wcześniej niż tyle minut przed oknem awizacji nie zostanie do niej dopasowany.0-720 minKierownik (ekran Parametry)
LPR_TOL_POOdczyt tablicy później niż tyle minut po końcu okna awizacji nie zostanie do niej dopasowany.0-720 minKierownik (ekran Parametry)
YMS_POW_TRYBTryb wysyłki powiadomień YMS: PROBA - nic nie wychodzi, TEST - wszystko na adres i numer testowy, PROD - do odbiorców.PROBA, TEST, PRODEkran Powiadomienia YMS
YMS_POW_TEST_EML, YMS_POW_TEST_SMSAdres e-mail i numer, na które w trybie TEST trafiają wszystkie powiadomienia.e-mail, telefonEkran Powiadomienia YMS
YMS_POW_DYSP_EML, YMS_POW_DYSP_SMS, YMS_POW_DYSP_TEAMSDane dyspozytora placu - odbiorcy powiadomień z regułą „dyspozytor”.e-mail, telefon, kanał TeamsEkran Powiadomienia YMS
MODUL_AC, MODUL_YMS_PLUS, MODUL_YMS_GAWłączniki modułów: agencja celna, YMS+ (zadania placu, etapy, powiadomienia), Gate Assistant.1 - włączony, 0 - wyłączonyAdministrator
AC_KIEROWNICYKierownicy agencji: obejście blokady rampy i zgoda częściowa.role albo loginy po przecinkuAdministrator
AC_ROLE_PLOMBYKto potwierdza plomby celne na bramie i rampie.role albo loginy po przecinkuAdministrator
AC_MAGAZYN_WMSMagazyn WMS, do którego trafiają dokumenty celne utworzone w VSS.kod magazynu; puste - magazyn VSSAdministrator
PAR_KIER_ROLE_VSSKto oprócz SuperVisora i Administratora otwiera ekran Parametry.role albo loginy; domyślnie MAWAdministrator

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.

  1. Otwórz Kartoteki, pozycja Parametry.
  2. Zmień wartości w polach sekcji Agencja celna albo Rozpoznawanie tablic (LPR). Zakres liczby jest podany pod opisem parametru.
  3. Kliknij Zapisz zmiany. Komunikat podaje liczbę zapisanych parametrów; Cofnij zmiany przywraca wartości z bazy.
  4. 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.

KodDo czego służy
PASS_MIN_LENGTH, PASS_MAX_LENGTH, PASS_NUMBER, PASS_SPECIAL_SIGNS, PASS_SMALL_LETTERS, PASS_BIG_LETTERSReguły złożoności hasła (grupa Administracja).
ZALEXTDozwolone rozszerzenia załączników.
ROZSZERZENIA_FOTODozwolone rozszerzenia zdjęć.
ConfirmExitAndroidAplikacja mobilna pyta przed wyjściem z transakcji (False - nie pyta).
NotifyInterwalCo ile sekund odświeżane są komunikaty dla użytkownika.
DefMonthDomyślny zakres dni wstecz w rejestrach.
LANGUAGEWybó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, StudioSystemWwwAdresy witryn: kodów QR, zdjęć i zakładki StudioSystem.
DefMail, EmailHost, EmailUser, EmailPasswordPoczta wychodząca - dane dostępowe, ustawiane przy wdrożeniu.
SMSAPIURL, SMSAPILOG, SMSAPIPASBramka SMS - dane dostępowe.
SQLReportServer, SQLReportServerPath, SQLUser, SQLPassword i pozostałe SQL*Serwer raportów (wydruki) - dane dostępowe.
Lic*, MULTILANGUAGEDane 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.

Studio VSS.net - sekcje Transport i Podsumowanie awizacji z polem uwag dla magazynu oraz kaflem Dodaj lub przeglądaj załączniki z podpowiedzią formatów
Kafel Załączniki w formularzu awizacji - lista dozwolonych rozszerzeń jest ustawieniem instalacji.

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.

ObjawPrzyczynaCo zrobić
W parametrach nie ma ustawienia długości oknaDł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 staremuAplikacja korzysta z zapamiętanej kopii konfiguracji.Zresetuj pamięć podręczną w sekcji Konfiguracja panelu Administratora.
Nowe hasło jest odrzucaneHasł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 transakcjiParametr 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.

  1. 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.
  2. W menu Kartoteki, pozycja Skorowidze, odczytaj czas obsługi transportu TIR w skorowidzu Rodzaje transportów i godziny okienek w skorowidzu Okienka czasowe.
  3. W menu Kartoteki, pozycja Kalendarze, odszukaj domyślny widok kalendarza ogólnego.
  4. 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.
  5. 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.