Printer icon

Procedura aktualizacji wersji

Wykaz czynności, których wykonanie jest wymagane lub zalecane w przypadku aktualizacji do podanej wersji nAxiom. Brak numeru wersji w wykazie oznacza, że aktualizacja do tej wersji nie wymagała wykonania żadnych specjalnych czynności.

1.15.5.0 (06-11-2025)

Wymagane jest wykonanie następujących czynności:
  • Optymalizacja obsługi tłumaczeń:

    Z uwagi na zmiany opisane poniżej, aby aktualizacja powiodła się, należy uruchomić w następujące skrypty SQL (w SQL Server Studio):

    1. Sprawdzenie długości danych. 
      IF EXISTS (
SELECT 1
FROM [core].[TranslationDefinitions]
WHERE LEN([TableName]) > 150 OR LEN([Field]) > 150
)
  PRINT 'Skróć wpisy w kolumnach TableName i/lub Field do maksymalnie 150 znaków';
ELSE
  PRINT 'Wpisy w kolumnach TableName i Field nie wymagają skrócenia';
    2. Sprawdzenie indeksów. 
      DECLARE @Indeksy NVARCHAR(MAX);

SELECT @Indeksy = STRING_AGG(i.name, ', ')
FROM sys.indexes i
JOIN sys.index_columns ic ON i.object_id = ic.object_id AND i.index_id = ic.index_id
JOIN sys.columns c ON ic.object_id = c.object_id AND ic.column_id = c.column_id
JOIN sys.tables t ON i.object_id = t.object_id
JOIN sys.schemas s ON t.schema_id = s.schema_id
WHERE s.name = 'core'
  AND t.name = 'TranslationDefinitions'
  AND c.name IN ('TableName', 'Field');

IF @Indeksy IS NOT NULL
    PRINT 'Usuń indeksy: ' + @Indeksy;
ELSE
    PRINT 'Nie znaleziono indeksów';

1.15.0.0 (12-09-2025)

Wymagane jest wykonanie następujących czynności:
  • Integracja z RabbitMQ:

    Od wersji nAxiom 1.15 wymagany jest dostęp do serwisu brokera komunikatów RabbitMQ. Może to być serwis na serwerze zdalnym, działającym lokalnie w kontenerze lub zainstalowanym lokalnie. W przypadku instalacji lokalnej odpowiednie instalatory można pobrać z serwisu Github:

1.14.9.0 (05-08-2025)

Wymagane jest wykonanie następujących czynności:
  • Modyfikacja core.UserTaskData:

    1. Podczas aktualizacji do bieżącej wersji tabela core.UserTasksData jest tworzona ponownie, dlatego przed aktualizacją zaleca się wyłączenie opcji Pokazuj instancje tego dokumentu na liście zadań użytkownika dla tych definicji dokumentu, dla których nie jest to konieczne.

    2. Wystąpienie zduplikowanej wartości ACLId dla instancji różnych definicji dokumentów uniemożliwi uruchomienie witryny po aktualizacji. Aby tego uniknąć, można sprawdzić tabele użytkownika w bazie danych przy użyciu poniższego skryptu. Zakłada się, że wszystkie tabele użytkownika są w schemacie dbo.

    

    1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

    		

    DECLARE @sql NVARCHAR(MAX) = N'';
DECLARE @tableName NVARCHAR(128);
-- Cursor to iterate over tables with ACLId column
DECLARE table_cursor CURSOR FOR
SELECT t.name
FROM sys.tables t
JOIN sys.columns c ON t.object_id = c.object_id
WHERE c.name = 'ACLId' AND SCHEMA_NAME(t.schema_id) = 'dbo';

OPEN table_cursor;
FETCH NEXT FROM table_cursor INTO @tableName;

WHILE @@FETCH_STATUS = 0
BEGIN
  SET @sql +=
    CASE
      WHEN LEN(@sql) = 0 THEN ''
      ELSE ' UNION ALL '
    END +
    'SELECT CAST(ACLId AS NVARCHAR(255)) AS ACLId, ''' + @tableName + ''' AS SourceTable FROM dbo.' + QUOTENAME(@tableName);

  FETCH NEXT FROM table_cursor INTO @tableName;
END

CLOSE table_cursor;
DEALLOCATE table_cursor;

-- Wrap the combined query to find duplicates and show their source tables
SET @sql = '
WITH AllACLIds AS (
  ' + @sql + '
),
DuplicateACLIds AS (
  SELECT ACLId
  FROM AllACLIds
  GROUP BY ACLId
  HAVING COUNT(*) > 1
)
SELECT a.ACLId, a.SourceTable
FROM AllACLIds a
JOIN DuplicateACLIds d ON a.ACLId = d.ACLId
ORDER BY a.ACLId, a.SourceTable;
';
-- Execute the final query
EXEC sp_executesql @sql;
  • Zadania użytkownika:

    Sprawdzić, czy w definicjach widoków list z włączoną weryfikacją uprawnień ACL według szablonów statusów zapytania źródłowe zwracają kolumnę Status. Brak tej kolumny spowoduje, że widok listy nie będzie się wyświetlał.

1.14.7.0 (07-05-2025)

Wymagane jest wykonanie następujących czynności:
  • Lista wyboru w edycji inline:

    Aktualizacja nAxiom do wersji 1.14.7.0 spowoduje usunięcie kolumny DefinedControlOptions z tabeli core.GridColumns. W efekcie wartości [key] wybierane na liście wyboru w trybie edycji inline nie będą trafiać do kolumny docelowej i nie będą zapisywane. Aby to naprawić, należy zdefiniować mapowanie wartości [key] na kolumnę docelową (właściwości kolumny > karta Edycja Inline > Lista zależności kolumna - kolumna). Przed aktualizacją można wyszukać w bazie takie przypadki zapytaniem:

    SELECT [Id]
  ,[GridDataId]
  ,[Code]
  ,[DataType]
  ,[DefinedControlId]
  ,[DefinedControlOptions]
FROM [MojaBaza].[core].[GridColumns]
WHERE DefinedControlOptions IS NOT NULL

1.14.2.0 (31-01-2025)

Wymagane jest wykonanie następujących czynności:
  • Nowe zastępstwa:

    W ramach modyfikacji funkcji core.GetAllSubstitutions usunięto parametr LangId. W związku z tą zmianą zdefiniowane wywołania funkcji będą zwracać błąd. Wymagane jest usunięcie parametru z wywołania funkcji:

    SELECT * FROM core.GetAllSubstitutions ()

1.14.1.0 (23-01-2025)

Wymagane jest wykonanie następujących czynności:
  • Wydajność operacji wsadowych:

    W związku ze zmianą struktury tabeli [core].[ACLInstanceEntries] wszelkie zapytania niestandardowe oparte na tej tabeli mogą wymagać aktualizacji odpowiednio do wprowadzonych zmian.

1.14.0.12 (20-11-2024)

Instalator zaawansowany: Wymagana jest samodzielna instalacja plików platformy .NET 8 w danym środowisku. W przeciwnym razie instalacja tej wersji nAxiom nie będzie możliwa. Pakiet instalacyjny .NET Hosting Bundle należy pobrać, używając linku: https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-8.0.11-windows-hosting-bundle-installer

1.14.0.12 (20-11-2024)

Obrazy dockerowe: Wymagana jest modyfikacja sekcji SQLConnectionString w pliku appsettings-custom.json poprzez dodanie wpisu Encrypt=false:

{
 "ConnectionStrings": {
   "SQLConnectionString": "
     Server=host.docker.internal;
     Initial Catalog=tenants-docker;
     User ID=sa;
     Password=p@ssw0rd;
     Connection Timeout=30;
     Encrypt=false;"
 },
 "AppConfiguration": {
 "FileStorageRoot": "/home/app/nAxiom"
 }
}

Ponadto, w przypadku aktualizacji środowiska w architekturze kontenerów należy zaktualizować ciągi połączenia z bazami danych tenantów w aplikacji TenantsadminSPA, dodając również jawną deklarację Encryption=false.*

* Ta zmiana nie jest wymagana. Jest ona wykonywana automatycznie w ramach aktualizacji do nowej wersji (przez migrację bazy danych).

1.14.0.0 (08-04-2024)

Nowa funkcja showCustomMessage: (dodano 09-04-2024) W związku z usunięciem biblioteki alertify.js należy wszystkie odwołania do tej biblioteki zastąpić odwołaniami do funkcji showCustomMessage. Aby znaleźć miejsca użycia tej biblioteki, można użyć poniższych zapytań SQL:

SELECT *
  FROM [core].[FormSections]
  WHERE Settings LIKE '%alertify%'
  
SELECT *
  FROM [core].[Actions]
  WHERE Command LIKE '%alertify%'
SELECT *
  FROM [core].[Forms]
  WHERE ContextChangeScript LIKE '%alertify%'
SELECT *
  FROM [core].[FormFields]
  WHERE ControlValue LIKE '%alertify%'

1.14.0.0 (08-04-2024)

Synchronizacja jednostek organizacyjnych: W związku ze zmianami tabel używanych do synchronizacji jednostek organizacyjnych wymagana jest weryfikacja danych do synchronizacji. Dodatkowo, konieczne jest usunięcie odwołań do kolumny OrgUnitId w tabeli SyncUserProfiles.

1.14.0.0 (08-04-2024)

Dezaktywacja akcji: Akcje z wyłączonym przełącznikiem Aktywna nie będą się wykonywać.

1.13.2.0 (20-02-2024)

Akcja zmiany statusu: Od bieżącej wersji podczas wykonywania przejść w akcji zmiany statusu nie będą dostępne parametry systemowe dodawane do kontekstu formularza: FormId, BusinessDocId, FormCode, AppId. Dotyczy to akcji wykonywanych na przejściu, warunków wykonania przejścia, warunku wyświetlania przycisku, eskalatorów itp.

1.13.0.0 (12-12-2023)

Konfigurowanie wyglądu przycisków: Zmiana konfiguracji przycisków spowoduje nieznaczne zwiększenie szerokości przycisków edycji inline w trybie Tylko ikona i może wymagać zwiększenia szerokości kolumny akcji w definicjach list, aby te przyciski nie wyświetlały się jeden nad drugim. Tę czynność można wykonać za pomocą zapytania SQL:

UPDATE [core].[GridColumns] SET Width = Width + 5
WHERE [ColumnType] = 2 -- kolumna akcji
AND [GridDataId] IN (1) -- id widoku listy

1.13.0.0 (12-12-2023)

Zmiana tabeli core.PermissionDelegations: W związku z usunięciem kolumny AcceptanceLimit z tabeli core.PermissionDelegations oraz modyfikacją obiektów powiązanych żądań Public API, może być konieczna modyfikacja rozwiązań własnych, które odwołują się do tej kolumny, aby zapewnić ich działanie w wersji nAxiom 1.13.0.0.

1.12.0.0 (09-10-2023)

Zapowiedź: Wycofanie obsługi organizacji: Wobec planowanego wycofania obsługi organizacji zaleca się przegląd aplikacji biznesowych pod kątem tej zmiany w celu zapewnienia ich prawidłowego działania po aktualizacji do wersji 1.13.

1.12.0.0 (09-10-2023)

Zmiana roli Administrator na biznesową: Jeśli w istniejących aplikacjach używano referencji do typu roli Administrator (core.Roles.Type), konieczne jest uwzględnienie zmiany tej wartości z 0 na 1.

1.12.0.0 (09-10-2023)

Usunięcie kolumn z tabeli core.AclInstanceEntries: Konieczna jest modyfikacja własnych rozwiązań konsultantów w istniejących aplikacji biznesowych, które pobierają dane z kolumn TaskOwnerUserId i TaskOwnerName w tabeli core.AclInstanceEntries. Te kolumny zostały usunięte.

1.11.3.0 (03-08-2023)

Kontrolka interesariuszy: Konieczne jest usunięcie wymaganych ról biznesowych w definicji kontrolki interesariuszy i ponowne ich dodanie, aby ponownie wygenerować zapytanie z wyrażeniem smart numbers.

1.11.0.0 (09-05-2023)

Generator dokumentacji: Wymagane jest ponowne wczytanie 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.

1.10.1 (21-03-2023)

Zmiana obsługi szablonów: Aby uruchomić migrację szablonów raportów do bazy danych należy otworzyć dowolny szablon raportu w module Web Report Designer (AdminSPA > NARZĘDZIA > Szablony > Szablony raportów > Designer). To spowoduje przeniesienie wszystkich szablonów z folderu na dysku do bazy danych. Dopiero wtedy raporty będą dostępne w aplikacji FrontSPA.

1.9.1 (07-11-2022)

Domyślny poziom logowania błędów: Aktualizacja do tej wersji zmieni ustawiony poziom logowania błędów na error. Jeśli w danym wdrożeniu ustawiono inny poziom, należy po aktualizacji przywrócić go ręcznie.

1.9 (20-10-2022)

Aktualizacja środowiska nAxiom do platformy .NET 6: W przypadku korzystania z tradycyjnego instalatora, należy przed jego uruchomieniem pobrać i zainstalować plik dotnet-hosting-6.0.8-win.exe ze strony:https://dotnet.microsoft.com/en-us/download/dotnet/6.0
Link bezpośredni:
https://download.visualstudio.microsoft.com/download/pr/c5e0609f-1db5-4741-add0-a37e8371a714/1ad9c59b8a92aeb5d09782e686264537/dotnet-hosting-6.0.8-win.exe.

1.9 (20-10-2022)

Nowa kolumna w core.AuditsLog: Wymagane jest przebudowanie triggerów odpowiedzialnych za audyt danych. W tym celu należy po aktualizacji wejść w definicję dokumentu biznesowego z włączonym audytem danych w kolumnach i zapisać ją.

1.8.4 (23-09-2022)

Automatyczne logowanie w aplikacji mobilnej: Aby zapewnić prawidłowe działanie funkcji szybkiego logowania, po aktualizacji do wersji 1.8.4 użytkownik powinien ustawić w pliku appsettings.json dla aplikacji Auth wartość “RefreshTokenLifetime”: 5184000 w obiekcie “ClientId”: “mobile”.

1.8.3 (02-09-2022)

Modyfikacja trigerów dla danych audytowych: Aktualizacja do wersji 1.8.3 spowoduje nadpisanie własnych trigerów na tabelach dokumentów biznesowych!

1.8.3 (02-09-2022)

Limit długości kodów i nazw pozycji słownikowych: W związku z ograniczeniem długości i dozwolonych znaków w kodach pozycji słownika, przed aktualizacją do bieżącej wersji należy dokonać przeglądu tych kodów i ewentualnie zmienić je samodzielnie na zgodne z wymaganiami nowej wersji, aby uniknąć błędów wynikających z automatycznej konwersji. Patrz także odpowiedni wpis w informacjach o wersji 1.8.3.

1.8.1 (29-07-2022)

Brak możliwości zalogowania się po aktualizacji witryny: Wymagane jest ponowne uruchomienia witryny na serwerze IIS po instalacji i pierwszym logowaniu użytkownika. Pominięcie tego kroku spowoduje, że aplikacja TaskService nie zostanie uruchomiona.

1.8.1 (29-07-2022)

Scalenie procedur migracji bazy danych w ramach procesu aktualizacji systemu: Scalenie procedur migracji bazy danach powoduje, że w przypadku aktualizacji witryny nAxiom z wersji starszej niż 1.4.2, należy najpierw wykonać aktualizację do dowolnej wersji między 1.4.2 a 1.8.0.2, a następnie można aktualizację do bieżącej wersji.

1.8.0.2 (25-07-2022)

Przywrócenie kolumny RecordId w tabeli tłumaczeń: Aby wycofać zmiany funkcji tłumaczeń wprowadzone w wersji 1.8, należy wykonać procedurę opisaną w informacjach do wersji 1.8.0.2 w punkcie Przywrócenie kolumny RecordId w tabeli tłumaczeń.

1.8 (15-07-2022)

Zmiany funkcji tłumaczeń: W związku ze zmianami mechanizmu tłumaczeń konieczne jest odświeżenie funkcji tabelarycznych używanych jako źródła danych dla list generowanych automatycznie. W tym celu w Kreatorze modeli danych należy użyć polecenia Aktualizacja widoków, zaznaczając na wyświetlonej liście wszystkie tabele modeli standardowych i uproszczonych.

Ponadto konieczne jest dostosowanie rozwiązań własnych odwołujących się do kolumny RecordId (int) w tabeli core.TranslationDefinitions, która została usunięta.

1.8 (15-07-2022)

Modernizacja bloku Oczekiwanie: Po aktualizacji konieczne jest uzupełnienie statusu bloku oczekiwania w diagramach procesów, w których używany jest ten blok.

Copyright © 2025 OPTEAM SA. Theme Copyright © 2017-2020 Patrick Marsceill. Distributed by an MIT license.