Informacje o wersji 1.11.0.0 z dn. 09-05-2023

Nowe i zmodernizowane funkcje

Obsługa wielu tenantów

Wprowadzono obsługę trybu multitenancy. W tym trybie z jednej witryny nAxiom może korzystać kilku tenantów (osobnych organizacji).Każdy z tenantów korzysta z własnej instancji bazy danych, co zapewnia separację i bezpieczeństwo. Tenantami zarządza administrator tenantów, używając nowej aplikacji frontonowej TenantAdminSPA dostępnej pod adresem https://bazowy-adres-naxiom/tenantsadmin/.

Tenanci łączą się z witryną nAxiom, używając adresu URL https://przedrostek-tenanta.bazowy-adres-naxiom, gdzie przedrostek-tenanta to definiowany indywidualnie dla każdego tenanta ciąg znaków. Dla pierwszego tenanta ten przedrostek może być pusty.

Podczas instalacji nowej witryny nAxiom tworzony jest login i baza danych administratora tenantów oraz login i baza danych pierwszego tenanta. W przypadku aktualizacji witryny z wersji nAxiom wcześniejszej niż 1.11, pierwszy tenant jest tworzony na podstawie dotychczasowej konfiguracji. Szczegóły instalacji opisano w Przewodniku instalacji dołączonym do niniejszych informacji o wersji.

W związku z wprowadzonymi zmianami nie jest już możliwa konfiguracja witryny, w której poszczególne serwisy nAxiom korzystały z różnych baz danych. Podczas aktualizacji parametry połączenia z bazą danych dla pierwszego tenanta są pobierane z pliku appsettings.json serwisu api.

Z uwagi na specyfikę implementacji funkcjonalności OCR jest ona dostępna tylko dla pierwszego tenanta. Trwają prace nad rozwiązaniem, które zapewni dostęp do tej funkcjonalności wszystkim tenantom.

Obecne wdrożenia produkcyjne nAxiom po aktualizacji do wersji 1.11 mogą działać bez zasadniczych zmian w konfiguracji z jednym tenantem (tryb single tenant).

Obsługa wielu tenantów, w tym aplikacja TenantAdminSPA, zostanie szczegółowo opisana w osobnej dokumentacji, która jest obecnie w trakcie opracowywania.

Modernizacja instalatora

W związku z wprowadzeniem obsługi wielu tenantów zmodernizowano instalator nAxiom. Najważniejsze zmiany to dodanie kroku konfiguracji administratora tenantów oraz kroku konfiguracji pierwszego tenanta. Poza tym w instalatorze uwzględniono zmienione zasady przechowywania plików statycznych (brak możliwości dowolnego definiowania repozytoriów plikowych przez tenantów w nowych instalacjach) oraz szereg innych zmian, które szczegółowo opisano w Przewodniku instalacji dołączonym do niniejszych informacji o wersji.

W przypadku aktualizacji środowiska nAxiom pierwszy tenant jest powoływany automatycznie na podstawie ustawień z plików appsettings.json poszczególnych serwisów. Nie jest obsługiwana aktualizacja witryny, w której poszczególne serwisy korzystały z różnych baz danych.

Obsługa wielu tenantów wymusza użycie certyfikatu typu wildcard, który zabezpieczy domenę główną środowiska nAxiom wraz z poddomenami dla indywidualnych tenantów. Taki certyfikat nie będzie konieczny w przypadku korzystania z nAxiom w trybie single tenant, kiedy przedrostek URL dla tenanta będzie pusty.

Konteneryzacja nAxiom

Zakończono prace nad konteneryzacją platformy nAxiom, Od bieżącej wersji udostępniamy nAxiom jako zestaw obrazów Docker dla systemów Linux. Dzięki temu możliwe jest wdrożenie nAxiom w chmurze jako zestaw kontenerów w klastrze Kubernetes (lub podobnej platformy orkiestracji kontenerów). Konteneryzacja w połączeniu z obsługą wielu tenantów pozwala zaliczyć nAxiom do platform low-code klasy Enterprise.

Z uwagi na specyfikę implementacji niektórych funkcjonalności nie są one dostępne w skonteneryzowanej wersji nAxiom. Są to raporty Crystal Reports, moduł OCR i moduł ePUAP.

Więcej informacji o tej funkcjonalności zawiera artykuł Wdrożenie nAxiom z obrazów Docker załączony do niniejszych informacji o wersji.

Tryb serwisowy

Dodano nową funkcjonalność o nazwie Tryb serwisowy. Umożliwia ona rejestrowanie oraz podgląd zdarzeń wywoływanych w aplikacji FrontSPA w obrębie formularza.

Funkcję może włączyć użytkownik FrontSPA, który będzie miał odpowiednie uprawnienie PBA. Przełącznik Tryb serwisowy jest dostępny w menu wyświetlanym po kliknięciu nazwy użytkownika. Dodatkowo w menu jest dostępne polecenie Log serwisowy, które wyświetla okno z zarejestrowanymi zdarzeniami oraz opcjami konfiguracji.

Logowane są trzy kategorie zdarzeń:

USER: inicjowane przez użytkownika,
SYSTEM: inicjowane przez system,
ERROR: błędy.

Obecnie rejestrowane są następujące rodzaje zdarzeń:

pobranie definicji formularza
ustawienie kontekstu dla formularza
wyświetlenie formularza
odświeżenie formularza
aktualizacja kontekstu formularza
uruchomienie skryptu zmiany kontekstu na formularzu
zdarzenia OnChange, OnClick, OnLeave na kontrolkach
akcje JavaScript na zdarzeniach OnChange, OnClick, OnLeave
ustawienie zależności na kontrolkach
kliknięcie przycisku
wywołanie akcji
dodanie, usunięcie i wyświetlenie podglądu załącznika
kliknięcie pozycji w menu użytkownika

Funkcja rejestruje wyłącznie zdarzenia wyzwalane w aplikacji FrontSPA. Zdarzenia wyzwalane przez żądania API nie są rejestrowane.

Odświeżenie strony w przeglądarce powoduje wyłączenie przełącznika Tryb serwisowy.

Uprawnienia PBA dla trybu serwisowego

W związku z dodaniem nowej funkcjonalności Tryb serwisowy, dodano nowe uprawnienia w sekcji Konfiguracja systemu:

Tryb serwisowy: umożliwia włączanie/wyłączanie trybu serwisowego,
Tryb serwisowy - podgląd szczegółów: umożliwia wyświetlanie szczegółów zalogowanych zdarzeń.

Zmiana w instalatorze

Zmodyfikowano działanie instalatora w ten sposób, że obecnie nie zatrzymuje już on serwera IIS podczas instalowania/aktualizacji witryny. Zatrzymywana jest jedynie sama witryna i jej pule aplikacji. Dzięki temu instalacja nAxiom nie wstrzymuje działania innych aplikacji udostępnianych na serwerze IIS.

Ta zmiana nie umożliwia równoległej instalacji kilku witryn nAxiom.

Rozszerzenie zakresu logowania informacji

Rozszerzono zakres logowanych informacji dla serwisów api, publicapi, mobileapi i taskservice. Nowe pola danych w logach to:

Użytkownik: id zalogowanego użytkownika (jeśli dostępne),
Identyfikator żądania HTTP: unikalny identyfikator pozwalający łączyć wiele informacji zalogowanych w obrębie jednego żądania obsługiwanego przez system.

Nowe pole w szczegółach wyjątku:

Informacje szczegółowe: dane wejściowe przekazane do wykonania danej operacji, zapisane w formacie JSON (pole uzupełniane wyłącznie dla poziomu ERROR).

Dodatkowo pole Parametry systemowe będzie uzupełniane w większej liczbie przypadków.

Generator dokumentacji

Zmieniono sposób przechowywania szablonów użytkownika do generowania dokumentacji (AdminSPA > POMOC > Generator dokumentacji). Obecnie będą one zapisywane w bazie danych.

Zmiana wymaga ponownego wczytania własnego szablonu dokumentacji. Można to wykonać, klikając w przycisk Nadpisz na ekranie Generator dokumentacji i wskazując następujący plik:
folder_instalacyjny_naxiom\syncfusion\Assets\word_templates\documentation_template_custom.docx.

Maksymalny rozmiar załącznika

W Przewodniku instalacji i Leksykonie nAxiom dodano informację, o tym, że maksymalny rozmiar załącznika w nAxiom zależy od wartości ustawienia Maksymalna dozwolona długość zawartości (w bajtach) dostępnego w programie Menedżer internetowych usług informacyjnych (IIS). Aby skonfigurować ten parametr, należy kliknąć dwukrotnie funkcję Filtrowanie żądań, a następnie kliknąć polecenie Edytuj ustawienia funkcji w menu z prawej strony. W wyświetlonym oknie dialogowym należy wpisać żądaną wartość parametru. Parametr można zdefiniować dla wszystkich witryn na poziomie serwera (hosta) lub indywidualnie dla każdej witryny.

Poprawki i usunięte błędy

Nagłówek formularza

Zmieniono sposób ładowania danych do komponentu nagłówka formularza, eliminując opóźnione doczytywanie danych po wyświetleniu formularza.

JS dla zmiany kontekstu formularza

Usunięto problem, który powodował, że nie można było zmienić wartości w kontekście formularza za pomocą instrukcji JavaScript w polu Skrypt dla zmiany kontekstu formularza.

Akcja Zapisz rekord

Poprawiono przeliczanie uprawnień ACL w przypadku zapisu dokumentu za pomocą akcji Zapisz rekord bez włączonego przełącznika Odśwież formularz po zapisie. Po zmianach zapisanie dokumentu powoduje przeliczenie uprawnień ACL dla bieżącego dokumentu oraz odświeżenie nagłówka formularza z danymi o statusie i przejściach.

Sekcje załączników i podglądu załączników

Poprawiono działanie sekcji załączników i podglądu załączników. Obecnie dodawane załączniki są ustawiane w sekcji załączników chronologicznie według czasu ich dodania. Prawidłowo działa także przełącznik Pokaż najstarszy w sekcji podglądu załączników.

Instalator

Wprowadzono zmianę w instalatorze. Obecnie podczas instalacji w pliku appsettings.json serwisu taskservice w sekcji AppConfiguration jest dodawany wpis IdentityServerUrl.

Migracja akcji WebServices

W migratorze aplikacji usunięto problem, który uniemożliwiał powtórny import aplikacji zawierających akcje WebServices.

Migracja procedur składowanych

W migratorze aplikacji dodano funkcję aktualizacji procedury składowanej. W razie wykrycia w bazie docelowej procedury o tej samej nazwie, migrator usunie ją, a następnie utworzy w wersji zaktualizowanej na podstawie definicji ze źródłowej bazy danych.

Style przycisków

Usunięto problem, który mógł powodować niewłaściwe stosowanie styli do przycisków na formularzu. Problem polegał na zduplikowanym identyfikatorze przycisków definiowanych na formularzu i na diagramie procesu.

Import tłumaczeń

Usunięto problem z importem tłumaczeń (AdminSPA > Tłumaczenia i pomoc > Wczytaj z pliku).

Dwukrotne logowanie

Usunięto problem który powodował, że w przypadku uwierzytelniania Windows w trybie incognito strona logowania była wyświetlana ponownie.

Zapis formularza

Usunięto błąd, który uniemożliwiał zapisanie definicji formularza po dodaniu kilku list wielowyboru.

Błędy w kontekście formularza

Usunięto błąd, który powodował, że po zmianie typu kontrolki z listy interesariuszy na inny w kontekście formularza pozostawały dane dotyczące interesariuszy i nie można było zapisać rekordu. Ponadto poprawiono angielskojęzyczną wersję komunikatów wyświetlanych przy powodzeniu i niepowodzeniu zapisu definicji formularza.

Sekcja typu prosta lista

Usunięto błąd, który powodował konieczność kilkukrotnego ponowienia próby zapisu ustawień sekcji typu prosta lista w definicji formularza.

Nieaktywny przycisk Zapisz

Usunięto błąd, który powodował dezaktywację przycisku zapisu definicji formularza po wejściu w edycję sekcji typu lista w kreatorze formularzy.

Wylogowanie z nAxiom

Poprawiono zachowanie witryny nAxiom po wylogowaniu w przypadku korzystania z Uwierzytelniania Windows. Obecnie po wylogowaniu jest wyświetlana ponownie strona logowania.

Wyświetlanie sekcji typu lista

Poprawiono wyświetlanie sekcji typu lista w przypadku, gdy w danej kolumnie formularza są dwie takie sekcje i pierwsza z nich jest ukryta przez warunek widoczności.

Eksport do pliku Excel

Poprawiono sposób generowania danych w formacie JSON na potrzeby akcji eksportu do pliku Excel. Obecnie akcja nie powinna obciążać procesora ani powodować zawieszenia działania aplikacji, nawet dla bardzo dużej liczby eksportowanych rekordów.

Zależności kontrolek

Poprawiono działanie funkcji zależności kontrolek. Problem występował, w przypadku, gdy dana kontrolka miała dwie kontrolki nadrzędna (jedna sterująca widocznością i druga filtrująca wartości) — zmiana wartości w kontrolce filtrującej powodowała wyświetlenie kontrolki zależnej. Po zmianach problem ten nie występuje.

Problem z zapisem formularza

Poprawiono błąd, który uniemożliwiał zapisanie definicji formularza po przeciągnięciu kolumny z sekcją typu prosta lista do nowego wiersza formularza.