Informacje o wersji (patch) 1.4.2.4 z dn. 06-12-2021

Nowe funkcje

Informacje o akcjach dla przejść workflow: W edytorze workflow dodano funkcję wyświetlania akcji przypisanych do przejścia po wskazaniu przejścia kursorem myszy. Także w panelu USTAWIENIA ELEMENTU są wyświetlane akcje przypisane do zaznaczonego przejścia. Pozwala to np. porównać akcje przypisane do zaznaczonego przejścia i do przejścia wskazanego myszą. (T:0136)

Szablony dla akcji generowania PDF: W akcji generowania pliku PDF dodano możliwość określenia pliku szablonu Word za pomocą zapytania SQL, które musi zwrócić identyfikator tego szablonu z tabeli [core].[WordTemplates]. Pozwala to dynamicznie zmieniać szablony, np. na podstawie wartości wybieranych z pola formularza:

SELECT Id
 FROM core.WordTemplates
 WHERE Id = {@IdSzablonu} 

(T:0699)

Nowa akcja uprawnień

Gruntownie przebudowano akcje uprawnień, które pozwalają teraz nadawać uprawnienia ACL do dokumentów biznesowych indywidualnym użytkownikom, rolom biznesowym, jednostkom organizacyjnym, w tym jednostkom podrzędnym (w powiązaniu z rolami). Zdefiniowane w akcji zapytanie SQL musi zwracać następujące kolumny:

PermissionTypes (varchar): rodzaj nadawanego uprawnienia (RUDA: R=odczyt, U=modyfikacja, D=usuwanie, A=administracja).
SelectedUserGUID (varchar): identyfikator użytkownika, któremu zostanie przypisane uprawnienie (dozwolony NULL).
BusinessRolesId (varchar): identyfikatory ról, którym zostaną przypisane uprawnienia (np. ‘134, 543’, dozwolony NULL).
SelectedOrgUnits (varchar): identyfikatory jednostek organizacyjnych, z których mogą pochodzić użytkownicy o wskazanych rolach (np. ‘1, 123’, dozwolony NULL).
AllowChildOrgUnits (bit): flaga dostępu użytkowników z podrzędnych jednostek organizacyjnych (przyjmuje wartości 0=NIE lub 1=TAK, dozwolony NULL).
Stakeholders (varchar): identyfikatory interesariuszy, którym zostaną przypisane uprawnienia (np. ‘65, 34’, dozwolony NULL). Opcjonalnie zapytanie może zwrócić kolumny:
BusinessDocumentSchema (int): identyfikator definicji dokumentu biznesowego (np. 45, dozwolony NULL); w przypadku braku kolumny w zapytaniu lub wartości NULL uprawnienia dotyczą klasy dokumentów biznesowych, do której należy dany dokument.
InstanceId (int): identyfikator instancji dokumentu biznesowego (np. 500, dozwolony NULL); w przypadku braku kolumny w zapytaniu lub wartości NULL uprawnienia dotyczą bieżącego dokumentu (instancji).

Jednostki organizacyjne mogą jedynie uzupełniać wybór użytkowników na podstawie ról, tak jak dotychczas w szablonach. Nie można utworzyć szablonu uprawnień dla członków danej jednostki bez względu na ich rolę biznesową.

Zestaw wyników zwracanych przez zapytanie SQL musi definiować jeden szablon uprawnień, ale akcja obsługuje operację UNION, co pozwala definiować jedną akcją wiele szablonów uprawnień.

SELECT
     'RUDA' as PermissionTypes,
      {@CreatedBy} as SelectedUserGUID,
      NULL as BusinessRolesId,
      NULL as SelectedOrgUnits,
      0 as AllowChildOrgUnits,
     NULL as Stakeholder,
     {@BizDok} as BusinessDocumentSchema,
     {@Id} as InstanceId
UNION
SELECT
     'RU' as PermissionTypes,
      NULL as SelectedUserGUID,
      NULL as BusinessRolesId,
      NULL as SelectedOrgUnits,
      0 as AllowChildOrgUnits,
     {@StakeholderId} as Stakeholder,
     {@BizDok} as BusinessDocumentSchema,
     NULL as InstanceId

Konwersja parametrów zapytań: W kreatorze formularzy, we właściwościach formularza na karcie Dostępność dodano przełącznik Przekaż wszystkie parametry jako nvarchar. Po włączeniu funkcja konwertuje do typu nvarchar wartości parametrów przekazywanych w zapytaniu SQL w ustawieniach dostępności wszystkich kontrolek na danym formularzu. W nowych formularzach przełącznik jest domyślnie wyłączony, a formularzach istniejących włączony. Na przykład dla pola typu bit jego wartość będzie w zapytaniu przekazywana jako 0 lub 1, gdy przełącznik będzie wyłączony, a jako true lub false, gdy będzie włączony. Stan przełącznika można sprawdzić wskazując ikonę ⓘ obok pola SQL w oknie Ustawienia dostępności/sekcji. (T:0668)

Walidacja parametrów w SQL: W oknach definiowania następujących rodzajów akcji: akcja sql, akcja e-mail, eksport excel, generowanie pdf (podgląd zapytania sql ), import excel, akcje komunikatów, ocr załącznika, konwersja plików i szyfrowanie plików dodano przycisk Sprawdź parametry, który sprawdza, czy parametry używane w zapytaniu SQL odpowiadają polom formularza. Dotyczy to tylko akcji definiowanych na poziomie formularzy, dla których jest wyświetlane pole Dostępne parametry w SQL. (T:-168)

Blokada hasła: Dodano czasowe blokowanie hasła po trzech nieudanych próbach zalogowania.
Blokowanie edycji inline w kolumnach: W konfiguratorze listy, we właściwościach kolumny na karcie Edycja inline dodano przełącznik Tylko do odczytu. Jego włączenie powoduje zablokowanie możliwości edycji wartości w tej kolumnie w trybie inline. (T:0115)
Zwijanie grup rekordów na listach: W konfiguratorze listy, we właściwościach listy na karcie Globalne ustawienia kolumn dodano przełącznik Domyślnie zwijaj grupy rekordów. Jego włączenie powoduje, że po zdefiniowaniu grupowania grupy rekordów będą zwinięte. (T:0694)

Miejsca utworzenia akcji

Do listy akcji (Akcje > Lista akcji) dodano informację o miejscu utworzenia dla akcji utworzonych w edytorze Workflow.

Konfiguracja wyświetlania listy interesariuszy

Zmodyfikowano kontrolkę interesariuszy, dodając możliwość definiowania wartości wyświetlanych na liście interesariuszy za pomocą zapytania SQL. Okno dialogowe zapytania wyświetla się po kliknięciu przycisku Konfiguruj listę wyboru na panelu właściwości. Zapytanie musi zwrócić identyfikator użytkownika jako kolumnę [key] (wartość zapisywana) i wartość wyświetlaną jako kolumnę [value] (wartość wyświetlana pod nagłówkiem Nazwa). Na liście będą wyświetlane dodatkowe kolumny zwracane przez zapytanie. Na przykład dla zapytania:

  SELECT Id as [key],
          concat(FirstName, ' ', LastName) as [value],
          Email as [E-mail]
   FROM [core].[UserProfiles]

wygląd kontrolki będzie następujący:

Zapytanie musi odwoływać się do tabeli [core].[UserProfiles], kolumna zwracana pod aliasem [value] jest wyświetlana pod nagłówkiem Nazwa. (T:0403)

Poprawki i usunięte błędy

Weryfikacja użytkownika w API: W punktach końcowych API dodano weryfikację roli systemowej użytkownika wysyłającego żądanie.
Czarne przyciski: Dodano możliwość ustawienia czarnego koloru przycisku. (T:0446)
Eksport Excel: Zmodyfikowano akcję eksportu listy do formatu Excel w taki sposób, że obecnie podczas eksportu są uwzględniane bieżące ustawienia listy: widoczne kolumny, filtry, sortowania oraz filtry użyte w zapytaniu SQL dla widoku listowego.
Ostrzeżenie RAISERROR: W metodzie SQL RAISERROR dodano żółty kolor tła komunikatu wyświetlanego dla istotności od 10 do 15.
Nowe nazwy w uprawnieniach formularza: Zmieniono nazewnictwo w oknie dialogowym Uprawnienia dla formularza (Formularze > Edycja > Uprawnienia). Dodano okno dialogowe z tabelą objaśniającą wynikowe atrybuty dla kontrolek, zależnie od ustawień w tym oknie, ustawień dostępności i pozycji wybranej z listy Typ walidacji.

Zmodyfikowane komunikaty o błędach: Zmodyfikowano komunikaty o błędach walidacji podczas zapisu formularza. W treści komunikatu jest wskazywane pole i sekcja, w której pole się znajduje. Dodano walidację dla pól zawierających zapytania SQL (ustawienia Dostępność, Konfiguracja listy wyboru, Wartość domyślna, Placeholder, SQL — dla kontrolki Wynik zapytania SQL). Sprawdzana jest poprawność składni oraz używane parametry. (T:0169)
Nazwy przejść w bloku decyzyjnym: Zmodyfikowano działanie bloku decyzyjnego w taki sposób, że obecnie dozwolone jest używanie takich samych nazw przejść w obrębie jednego workflow (definicji dokumentu biznesowego). Ponadto poprawiono sposób definiowania warunku dla bloku.
Metody Public API: Usunięto błędy w metodach API dotyczących załączników.
Odwołanie do OpenedForms: Dodano odwołanie {*FormCode.Wartosc} do tablicy OpenedForms, które zwraca wartość NULL, jeśli ta tablica jest pusta lub jeśli nie ma w niej formularza o podanym kodzie. (T:0678)

Nazwy akcji w oknie edycji W aplikacji AdminSPA uzupełniono brakujące nazwy akcji w oknach Dodawanie akcji.

Rola biznesowa w FrontSPA Wprowadzono poprawkę, dzięki której po dodaniu roli biznesowej nie jest konieczne przeładowanie platformy, aby ta rola była dostępna w aplikacji FrontSPA.

W sytuacji, kiedy rola biznesowa zostanie usunięta w momencie tworzenia profilu użytkownika, wystąpi zablokowanie przycisku zapisu, a profil zostanie dodany do tabeli [auth].[AspNetUsers], ale nie do tabeli [core].[UserProfiles]. Aby go dodać ponownie, konieczne będzie usunięcie tego wpisu.

(T:0311)

Korzystanie z akcji systemowych w workflow: W edytorze workflow dodano możliwość użycia akcji systemowych w ustawieniach Akcje uruchamiane przed i Akcje uruchamiane po. (T:0606)
Migracja załączników: Usunięto błąd migracji załączników do nowej wersji nAxiom, który powodował, że w nowej wersji nie można było pobrać takich załączników ani ich usunąć. (T:0737)

Akcja Zapisz rekord Usunięto błąd w akcji systemowej Zapisz rekord, który powodował, że po zapisaniu rekordu i zamknięciu formularza, dane z tablicy OpenedForms były przenoszone do kontekstu formularza dla nowego rekordu. (T:0734)

Usunięto problem dotyczący migracji bazy danych do wersji 1.4.2.3 w przypadku bazy danych SQL Server 2016. (T:0729)

Formularze w trybie okna dialogowego: Usunięto błąd, który powodował, że po uruchomieniu aplikacji nie otwierały się formularze wyświetlane w trybie okna dialogowego. (T:0708)
Podprocesy: Usunięto błąd, który powodował występowanie komunikatu o błędzie Conversion failed when converting from a character string to uniqueidentifier podczas wykonywania przetwarzania dokumentów w podprocesie, gdy dokument główny pozostawał w statusie synchronizatora

Przewijanie formularza Usunięto błąd, który powodował, że po kliknięciu przycisku wywołującego akcję na formularzu ekran był przewijany. (T:0659)

Lista wielowyboru: Gotowe Wyeliminowano błąd, który występował w przypadku użycia w zapytaniu SQL dla listy wielowyboru parametru {@_LangId}. (T:0513)

Informacje uzupełniające

Kompatybilność z poprzednią wersją w zakresie filtrowania i wyświetlania zależnych kontrolek formularza

W wersjach poniżej 1.4.2.3 mechanizm modyfikacji zależności kontrolki posiadał jedną tabelę do zarządzania filtrowaniem i wyświetlaniem kontrolek zależnych. W tabeli znajdowały się kolumny:
1. Ścieżka do elementu
2. Przypisana wartość
3. Modyfikator widoczności
4. Opcje (Edycja, Usuń)
Aby zbudować logikę dla filtrowania i wyświetlania należało zduplikować ścieżkę do kontrolki zależnej, przekazać do niej pożądane wartości lub słowo kluczowe i dla trybu filtrowania zostawić przełącznik Modyfikator widoczności wyłączony, a dla wyświetlania włączyć go.
1. Aby wyświetlić kontrolkę zależną, kiedy po przefiltrowaniu posiada ona jakąkolwiek wartość, należało użyć w kolumnie Przypisana wartość słowa kluczowego __any.
Od wersji 1.4.2.3 mechanizm zależności jest podzielony na dwie karty: osobno do filtrowania, osobno do widoczności.
1. Filtrowanie odbywa się bez zmian.
2. Zarządzanie wyświetlaniem odbywa się przez wskazanie kodu kontrolki, operatora logicznego oraz pozwala na wskazanie zakresu wartości i tym samym zbudowanie całego odrębnego warunku do zarządzanie wyświetlaniem kontrolki zależnej.
Aby umożliwić korzystanie z istniejących zależności opracowano mechanizm ich konwersji do nowego standardu:
1. Filtrowanie jest mapowane 1:1
2. Wyświetlanie jest rozdzielone na operator i wartość
  1. Wartości są przekazywane 1:1
  2. Operatory logiczne są przekazywane 1:1
  3. Słowo kluczowe __any (które można było wpisać do kolumny Przypisana wartość) jest mapowanie do nowego operatora jest niepusta. Pozwala to na zbudowanie warunku: Jeśli kontrolka sterująca ma przypisaną wartość, to wyświetl kontrolkę zależną. W przeciwnym razie nie wyświetlaj jej.

Migrację przedstawia poniższa tabela:

`Modyfikator widoczności`	Kolumna przed migracją	Karta po migracji	Kolumna po migracji
Wyłączony	`Ścieżka do elementu`	`Filtrowanie`	`Kontrolka zależna`
	`Przypisana wartość`	`Filtrowanie`	`Wartość`
Włączony	`Ścieżka do elementu`	`Wyświetlanie`	`Kontrolka zależna`
	`Przypisana wartość`	`Wyświetlanie`	`Operator`
		`Wyświetlanie`	`Wartość`

(T:0722)