Informacje o wersji 1.11.3.0 z dn. 03-08-2023
Ważne informacje
Limity czasu serwera nginx
W przypadku wdrożenia w architekturze kontenerów limit czasu obsługi żądania na serwerze nginx wynosi 60 s, co może powodować, że większe żądania przekraczające ten limit są anulowane. Zaleca się wydłużenie tego limitu do 300 s. Zmianę należy wprowadzić w plikach konfiguracyjnych serwera nginx, ustawiając parametry:
proxy_read_timeout 300s;
proxy_connect_timeout 300s;
proxy_send_timeout 300s;
Tę informację dodano w artykułach „Wdrożenie nAxiom w Openshift - krok po kroku” i „Wdrożenie nAxiom z obrazów Docker”.
Akcja C#, limit czasu obiektu HttpClient
Domyślny limit czasu dla wystąpienia klasy HttpClient to 100 sekund. W przypadku wykonywania rozbudowanych żądań w akcjach C# niezbędne jest zwiększenie tego limitu dla obiektu HttpClient, który wysyła to żądanie. Na przykład:
HttpClient forceImportClient = new HttpClient();
forceImportClient.Timeout = TimeSpan.FromMinutes(10);
Kolejność kolumn po migracji
Proces migracji aplikacji nie gwarantuje zachowania oryginalnej kolejności kolumn w migrowanych tabelach użytkownika.
Nowe i zmodernizowane funkcje
Uprawnienia ACL dla dokumentów
Zmieniono sposób generowania uprawnień ACL na podstawie szablonów uprawnień dla statusów. Obecnie, przy zmianie statusu danego dokumentu wyliczane są uprawnienia tylko dla bieżącego statusu, a wpisy uprawnień ACL dla poprzedniego statusu są usuwane.
Wartość domyślna w kontrolce interesariuszy
We właściwościach kontrolki interesariuszy dodano możliwość skonfigurowania wartości domyślnej. Pozwala ona wskazać jednego lub kilku użytkowników, którzy domyślnie mają należeć do danej grupy interesariuszy. Nie można w ten sposób wskazać ról globalnych ani ról w jednostkach. Wartością domyślną może być identyfikator GUID użytkownika lub zapytanie SQL zwracające listę identyfikatorów GUID. Zwrócone identyfikatory muszą być podzbiorem zestawu zwróconego przez zapytanie w konfiguracji kontrolki.
Czasy udanego/nieudanego logowania
Dodano mechanizm rejestrowania czasów ostatniego udanego i nieudanego logowania użytkownika do witryny nAxiom oraz czas trwania bieżącej sesji. Informacje te są wyświetlane po kliknięciu nazwy użytkownika zalogowanego w aplikacji FrontSPA.
Funkcje zliczające załączniki
Dodano dwie funkcje służące do obliczania liczby załączników dla określonego dokumentu: countAttachmentFiles oraz countAttachmentFilesByParams. Funkcje są tworzone w schemacie bazodanowym podanym podczas instalacji systemu, domyślnie core.
Funkcja countAttachmentFiles przyjmuje trzy parametry:
- BusinessDocumentId: identyfikator definicji dokumentu, parametr wymagany,
- RecordId: identyfikator dokumentu, parametr wymagany,
- AttachmentCategoryId: identyfikator kategorii załączników, parametr wymagany
Przykład użycia:
SELECT [core].[countAttachmentFiles](
{@BusinessDocId} -- BusinessDocumentId
,{@Id} -- RecordId
,1 -- AttachmentCategoryId)
Funkcja countAttachmentFilesByParams przyjmuje 14 parametrów:
- BusinessDocumentId: identyfikator definicji dokumentu, parametr wymagany,
- RecordId: identyfikator dokumentu, parametr wymagany,
- AttachmentCategoryId: identyfikator kategorii załączników, parametr wymagany,
- VersionNumberMinimum: minimalny nr wersji załącznika,
- VersionNumberMaximum: maksymalny nr wersji załącznika,
- FileName: nazwa pliku załącznika,
- FileExtension: rozszerzenie pliku załącznika,
- FileSizeMinimum: minimalny rozmiar załącznika w bajtach,
- FileSizeMaximum: maksymalny rozmiar załącznika w bajtach,
- CreateDateFrom: data utworzenia; wartość od,
- CreateDateTo: data utworzenia; wartość do,
- ModifyDateFrom: data modyfikacji; wartość od,
- ModifyDateTo: data modyfikacji; wartość do,
- SignatureStatus: status podpisu dokumentu
Przykład użycia, który pozwala sprawdzić, czy dodano załącznik w formacie PDF o maksymalnym rozmiarze 2 MB:
SELECT [core].[countAttachmentFilesByParams](
{@BusinessDocId} -- BusinessDocumentId
,{@Id} -- RecordId
,1 -- AttachmentCategoryId
,NULL -- VersionNumberMinimum
,NULL -- VersionNumberMaximum
,NULL -- FileName
,'pdf' -- FileExtension
,NULL -- FileSizeMinimum
,2000000 -- FileSizeMaximum
,NULL -- CreateDateFrom
,NULL -- CreateDateTo
,NULL -- ModifyDateFrom
,NULL -- ModifyDateTo
,NULL -- SignatureStatus
))
Jeśli nie zostaną podane wymagane parametry, funkcje zwrócą wartości ujemne:
- -10: brak BusinessDocumentId,
- -20: brak RecordId,
- -30: brak AttachmentCategoryId.
Logi bezpieczeństwa
Do audytu bezpieczeństwa (dane rejestrowane w tabeli core.SecurityAudits) dodano nowe zdarzenia dotyczące przypisywania i anulowania przypisania ról biznesowych, w tym ról w jednostkach, oraz dodawania i usuwania jednostek struktury organizacyjnej. Dla każdego zdarzenie rejestrowana jest informacja o dacie zdarzenia, użytkowniku, który wykonał operację, użytkowniku, którego dotyczyła operacja, rodzaju operacji (dodanie usunięcie) oraz o roli i/lub jednostce organizacyjnej, której dotyczyła operacja.
Administrowanie uprawnieniami ACL
W oknie dialogowym zmiany uprawnień ACL dla dokumentu (wyświetlanym po kliknięciu ikony kluczyka w prawym górnym rogu formularza) dodano możliwość ustawiania uprawnień dla roli globalnej i roli w jednostce organizacyjnej.
W ramach tego zadania utworzono funkcję tabelaryczną CalculateOuPath, która dla podanego identyfikatora jednostki organizacyjnej zwraca pełną ścieżkę jednostki w strukturze organizacyjnej.
Parametry widżetów
W oknie dialogowym parametrów widżetu dodano obsługę pola wyboru daty i czasu (datepicker).
Parametry LocalStorage
W kontekście formularza dodano obsługę wielu parametrów zapisanych w pamięci przeglądarki (LocalStorage). Parametry są wyświetlane kolejno w formie SYS_key: “value”, gdzie key to nazwa parametru, a value to jego wartość.
Wylogowanie po zmianie hasła
W celu podniesienia bezpieczeństwa w aplikacjach FrontSPA i TenantAdminSPA dodano mechanizm, który powoduje, że po zmianie hasła do swojego profilu bieżący użytkownik zostanie wylogowany i będzie musiał zalogować się ponownie, używając zmienionego hasła.
Logi systemu
Poprawiono wydajność wczytywania logów aplikacji oraz dodano animowaną ikonę operacji w toku, wyświetlaną podczas wczytywania logów.
Widok listy, klucz główny źródła
W konfiguracji widoku listy dodano walidację zapytania SQL, która sprawdza czy zapytanie zwraca kolumnę o nazwie podanej w polu Klucz główny (PK). W przypadku braku takiej kolumny wyświetlane jest ostrzeżenie z pytaniem czy kontynuować zapis konfiguracji.
Akcja przypisywania ról globalnych do interesariuszy
W akcji dodawania ról globalnych do interesariuszy dodano obsługę błędów w następujących przypadkach:
- użytkownik nie ma uprawnień do aktualizacji dokumentu (U)
- nie znaleziono dokumentu o podanym identyfikatorze
- nie znaleziono roli o podanym identyfikatorze
- nie odnaleziono grupy interesariuszy o podanym identyfikatorze
Akcja importu dokumentów
Działanie akcji importu dokumentów rozszerzono o możliwość importowania dokumentów o statusie docelowym przypisanym na diagramie procesu do bloku oczekiwania.
Limit długości zawartości na serwerze IIS
Dodano obsługę błędu spowodowanego przekroczeniem limitu wielkości żądania na serwerze IIS — ustawienie Maksymalna dozwolona długość zawartości (w bajtach). Przyczyną wystąpienia tego błędu może być na przykład próba dodania załącznika o wielkości przekraczającej limit (domyślnie 28,6 MB). W przypadku wystąpienia tego błędu zostanie wyświetlony komunikat „Wystąpił problem z obsługą żądania przesłanego do aplikacji. Rozmiar żądania jest zbyt duży. Skontaktuj się z administratorem systemu”.
W przypadku żądania wysyłanego przez PublicAPI, jeśli to żądanie przekracza limit, ten komunikat nie jest wyświetlany, natomiast zwracany jest błąd 413.
Kontrolka interesariuszy
Dodano obsługę smart numbers dla ról biznesowych w zapytaniu generowanym dla kontrolki interesariuszy. Do tej pory po wskazaniu dla kontrolki wymaganych ról biznesowych, w zapytaniu wstawiane były identyfikatory ról, co mogło powodować problemy podczas migracji. Obecnie zamiast identyfikatorów w zapytaniu jest wstawiane wyrażenie smart numbers.
W przypadku istniejących konfiguracji konieczne jest usunięcie wymaganych ról biznesowych w definicji kontrolki i ponowne ich dodanie, aby ponownie wygenerować zapytanie z wyrażeniem smart numbers.
Audyt w PublicAPI
Dodano obsługę żądań do PublicAPI przez moduł audytów. Dzięki temu tworzenie i zmiana statusu dokumentów przez żądania wysyłane do PublicAPI są objęte audytem.
Parametry w definicji widżetów
W definicji widżetów dodano obsługę parametrów systemowych {@_UserId}, {@_LangId} oraz wartości przechowywanych w LocalStorage. Te parametry i wartości są teraz także obsługiwane w konfiguracji parametrów widżetów typu lista wyboru SQL.
Poprawki i usunięte błędy
Migracja opisów kolumn
Poprawiono migrację opisów kolumn w tabelach użytkownika.
Obszar tekstowy
Zmieniono zachowanie kontrolki Obszar tekstowy wyświetlanej w trybie tylko do odczytu. Obecnie można zmieniać wysokość takiej kontrolki, przewijać jej zawartość i zaznaczać fragmenty zawartości.
Akcje przypisywania do interesariuszy
W oknie dialogowym definiowania akcji przypisywania ról globalnych i ról w jednostkach organizacyjnych do interesariuszy dodano przełącznik Wykonanie warunkowe.
Uprawnienia formularza
W nagłówkach kolumn z uprawnieniami w oknie dialogowym Uprawnienia dla formularza dodano podpowiedzi tooltip z kodem i nazwą elementu.
Linki w wiadomościach e-mail eskalatorów
Usunięto problem, który powodował, że w wiadomościach e-mail wysyłanych w funkcjonalności eskalatorów linki do dokumentów były nieprawidłowo sformatowane i nie działały.
Migracja przycisków radio i pozycji słownika
Usunięto błędy, które powodowały, że podczas migracji przycisków radio i słowników zmieniała się kolejność przycisków radio i pozycji słownika.
Prefiksy tenantów w linkach do dokumentów
Poprawiono błędy w linkach wewnętrznych generowanych w panelu powiadomień i wysyłanych wiadomościach e-mail dla nowych zdarzeń i eskalatorów w witrynach drugiego i kolejnych tenantów.
Formularz na ekranie dashboard
Usunięto błędy serializacji logów rejestrowane w konsoli przeglądarki podczas wczytywania formularza na ekranie Dashboard.
Widoczność przycisku
Usunięto błąd, który uniemożliwiał ustawienie widoczności przycisku na formularzu za pomocą instrukcji JavaScript we właściwości Skrypt dla zmiany kontekstu formularza.
Linki w szablonach e-mail
Usunięto błąd, który powodował, że linki wewnętrzne generowane w akcji e-mail były niepoprawne (brak elementu /front/ w ścieżce). Błąd dotyczył sytuacji, kiedy akcja była wywoływana przez przejście procesu, a zmiana statusu była wywoływana przez PublicAPI.
Zastępstwa - wybór roli
Usunięto błąd w funkcjonalności zastępstw, który uniemożliwiał wskazanie dla osoby zastępowanej tej samej roli jako globalnej i roli w jednostce organizacyjnej.
Funkcja refreshDropDownControl
Usunięto błąd w działaniu akcji JavaSript z użyciem funkcji odświeżania listy rozwijanej (refreshDropDownControl).
Eskalatory
Usunięto błąd funkcji eskalatorów, który powodował, że dla wszystkich dokumentów z terminem wykonania przypadającym w interwale równym wartości ustawienia Częstotliwość sprawdzania listy eskalatorów do wysyłki (w minutach) (AdminSPA > Ustawienia systemu > Eskalatory) była wysyłana wiadomość e-mail z takim samym numerem dokumentu.
Anulowanie logowania domenowego
Poprawiono zachowanie witryny nAxiom w przypadku, gdy podczas logowania domenowego użytkownik kliknie przycisk Anuluj. Obecnie spowoduje to wyświetlenie standardowego okna logowania do nAxiom.
Komentarze SQL
Poprawiono nieprawidłową obsługę komentarzy w zapytaniach SQL definiowanych przez konsultantów w aplikacji Admin SPA.
Synchronizacja z LDAP
Poprawiono mechanizm synchronizacji użytkowników z katalogiem LDAP w przypadku, gdy przełożony użytkownika znajduje się w innej jednostce organizacyjnej. Dotychczas w takim przypadku profil użytkownika nie był synchronizowany.
Zapis w kreatorze formularzy (widok drzewa)
Poprawiono działanie funkcji zapisu w kreatorze formularzy (drzewo definicji formularza). Obecnie można wprowadzić wiele zmian w definicji formularza i zapisać je w jednej operacji zapisu.
Flaga Audit: Enabled
Poprawiono działanie flagi Audit: Enabled w pliku appsettings.json serwisu api.
Status podpisu załącznika
Poprawiono błąd, który blokował zmianę statusu podpisu w kolumnie SignatureStatus w tabeli core.Attachments po wykonaniu akcji podpisu eSign na załączniku.
Migracja kolumny varbinary
Poprawiono błąd migratora, który powodował, że kolumna typu varbinary(MAX) po migracji miała typ varbinary(1).