Informacje o wersji 1.10.0.3 z dn. 09-03-2023

Informacje uzupełniające

Migrator aplikacji

Migrator nie tworzy w docelowej bazie danych schematów bazy danych. Jeśli importowana aplikacja korzysta z niestandardowych schematów bazy danych, przed importem konsultant musi utworzyć je w docelowej bazie danych. W przeciwnym razie import nie powiedzie się.

Parametry w akcji otwierania formularza

Akcja otwierania formularza (w trybie dialog) jest wykonywana także podczas odświeżania formularza, który został otwarty przy użyciu tej akcji. Jednak w tym przypadku kontekstem domyślnym jest kontekst formularza docelowego. Dlatego ważne jest odpowiednie skonfigurowanie parametrów odwołujących się do kontekstu formularza źródłowego (tego, z którego jest inicjowana akcja).
Właściwa składnia to {@*KodFormularza.PoleFormularza}. Alternatywnie można skorzystać z funkcji
JSON_VALUE({@OpenedForms},’$[0].PoleFormularza’)
Należy przy tym pamiętać (w obu przypadkach) o konieczności przestawienia trybu pola wprowadzania na SQL.
Zastosowanie zmiennej {@PoleFormularza} spowoduje błąd lub nieoczekiwane zachowanie po odświeżeniu formularza docelowego, ponieważ system będzie szukał wartości takiej zmiennej w kontekście odświeżanego formularza.

Konfiguracja ruchu wewnętrznego w instalatorze

W przewodniku instalacji dodano następującą uwagę dotyczącą konfiguracji ruchu wewnętrznego w instalatorze:

Jeśli na danym hoście jest instalowanych kilka witryn dostępnych z zewnątrz, dla każdej z nich należy skonfigurować inny port dla ruchu wewnętrznego. Użycie tej samej wartości (np. domyślnej) dla wszystkich witryn spowoduje, że możliwe będzie uruchomienie tylko jednej z tych witryn.
Ponadto przed podaniem portu dla ruchu wewnętrznego należy sprawdzić, czy nie jest on już używany przez inne oprogramowanie.

Nowe i zmodernizowane funkcje

Filtrowanie sekcji kalendarza

We właściwościach sekcji kalendarza dodano właściwości Zależność od sekcji oraz Warunek dla zależności. Warunek zależności jest stosowany do zapytania zwracającego zdarzenia (Typ sekcji > Ustawienia > Źródło danych dla zdarzeń).

Pola zależne, konfiguracja listy wyboru

W oknie dialogowym konfiguracji list wyboru zamieniono przełącznik Aktualizuj zawsze zależne pole na listę wyboru Tryb aktualizacji. Na liście są dostępne następujące pozycje:

• Zawsze: każda operacja otwarcia i odświeżenia formularza powoduje aktualizację wartości w polach zależnych.
• Tylko po zmianie na liście wyboru: aktualizacja wartości w polach zależnych odbywa się tylko po zmianie pozycji w liście rozwijanej (zmiana przez użytkownika lub np. przez akcję).
• Tylko gdy wskazane pole jest puste: wartości zwrócone przez listę wyboru są przekazywane do pól zależnych tylko wtedy, kiedy są one puste.

Na efekty działania tej funkcji ma wpływ zachowanie nAxiom przy odświeżaniu formularza. Kliknięcie ikony odświeżania w prawym górnym rogu formularza inicjuje działanie zależnie od typu okna formularza:

• Dialog: zostaje ponownie wykonana akcja otwierania formularza z użyciem przekazywanych w niej parametrów.
• Link wewnętrzny: formularz i dane rekordu zostają ponownie wczytane z bazy danych; ewentualne parametry przekazywane w akcji otwierania formularza zostają utracone. Tak samo działa przeładowanie strony w przeglądarce klawiszem F5.

Akcja odświeżenia formularza działa tak samo, niezależnie od typu okna formularza, to jest wczytuje ponownie formularz i dane rekordu z bazy danych. Jeśli formularz został otwarty akcję z przekazaniem parametrów, parametry zostaną utracone.

Nowy tryb aktualizacji Tylko po zmianie na liście wyboru ma charakter próbny; jego działanie może zostać w kolejnych wersjach zmodyfikowane, zależnie od opinii użytkowników.

Obsługa wyjątków w akcji zapytań do webserwisów

W akcji zapytań do webserwisów oraz w konfiguracji listy wyboru (WebService) dodano możliwość definiowania własnej procedury obsługi odpowiedzi niezależnie od zwróconego kodu statusu HTTP. Użytkownik ma do wyboru dwa tryby obsługi odpowiedzi:

• domyślny: (wybrany domyślnie) procedura obsługi dotyczy odpowiedzi o statusach z zakresu 200-299; dla pozostałych statusów zwracany jest wyjątek.
• własny warunek obsługi odpowiedzi: w procedurze obsługi możliwa jest obsługa wszystkich odpowiedzi, niezależnie od kodu statusu.

Ponadto, dodano nowe zmienne, których można użyć w instrukcji SQL do obsługi odpowiedzi, są to:

• @_HTTPResponseStatusCode: status odpowiedzi (int) np. 404,
• @_HTTPResponseStatusName: nazwa statusu odpowiedzi np. NotFound dla statusu 404,
• @_HTTPResponseHeader - nagłówki odpowiedzi w formacie JSON o następującej strukturze:

  {
  "header_1": ["value_1"],
  "header_2": ["value_2", "value_3"]
  }
  

  gdzie header_x to nazwa nagłówka odpowiedzi, a value_x to wartość tego nagłówka.

Więcej informacji oraz przykłady zawiera pomoc kontekstowa dostępna w oknie edycji akcji oraz Leksykon nAxiom.

Obsługa wyjątków w akcji algorytmu C#

Wprowadzono poprawki, które umożliwiają obsługę błędów zwracanych przez akcje uruchamiane akcją algorytm C#. Dodatkowo zmieniono sposób logowania błędów: jeśli błąd wystąpi w akcji wykonywanej w algorytmie C#, treść komunikatu zostanie dodana do wyjątku akcji C#.
Przykład obsługi błędów w wykonywanej akcji:

using System;
using CSharpScript.ActionRunner;
string model = @"{
  RecordId:1,
  DocumentDefinitionId:56,
  Model:""{}""
}";
try
{
ActionExecutionResult result =
     await CSharpScript.ActionRunner.SqlAction.Instance.RunActionAsync(1, model);
}
catch(ActionExecutionException ex)
{
throw new Exception(ex.ExecutionResult?.ValidationResult?.Errors[0].ErrorMessage);
}

Uwaga: Klucz “Model” w parametrze wywołania akcji model nie może być pusty (NULL) ani nie może być pustym tekstem (”“), może to być natomiast pusty obiekt JSON (”{}”), jeśli przekazanie go do akcji nie jest wymagane.

Poprawki i usunięte błędy

Sekcja kalendarza, tryb tylko do odczytu

Poprawiono działanie ustawienia tylko do odczytu dla sekcji kalendarza.

W trybie tylko do odczytu nie można przeglądać kalendarza, np. przez zmianę miesiąca.

Zaznaczanie pola wymaganego w uprawnieniach formularza

Usunięto błąd, który powodował, że pomimo zaznaczenia pola wyboru Pole wymagane w oknie dialogowym Uprawnienia dla formularza, przy ponownym otwarciu tego okna to pole wyświetlało się jako niezaznaczone.

Pole Warunek dla zależności, właściwości sekcji

Zmieniono sposób wyświetlania podglądu zapytania dla pola Warunek dla zależności we właściwościach sekcji. Dodano możliwość wykonania zapytania z warunkiem i podglądu zwracanych danych.

Błąd podczas działania instalatora

Usunięto przyczynę błędu w działaniu instalatora, który powodował wyświetlenie komunikatu:
„Wystąpił błąd podczas instalacji aplikacji: Nazwa pliku: \?\C:\WINDOWS\system32\inetsrv\config\applicationHost.config Błąd: Nie można przekazać zmian konfiguracji, ponieważ plik na dysku został zmieniony”.

Odświeżanie kontrolki wielowyboru

Usunięto problem, który powodował, że na liście wielowyboru wciąż były wyświetlane wartości, chociaż w modelu formularza pole tej kontrolki miało wartość NULL (kontrolka była wypełniana przez ustawienie listy wyboru jako pole zależne).

Pole Warunek dla zależności

Poprawiono zachowanie pola Warunek dla zależności we właściwościach sekcji typu lista. Obecnie w tym polu jest zawsze wyświetlany tylko zdefiniowany warunek.

Instalator, dostęp z Internetu

Poprawiono działanie instalatora nAxiom w przypadku aktualizacji witryny instalowanej na hoście z dostępem z Internetu.

Lista wyboru, wypełnianie pól zależnych

Poprawiono błąd z ustawianiem wartości w polach zależnych dla listy wyboru w przypadku, kiedy kontrolka pola zależnego była w trakcie wczytywania.

Raporty Telerik, parametry daty i czasu

Poprawiono wyświetlanie kontrolki dla parametru typu datetime w sekcji podglądu raportu Telerik.

Raporty Telerik, błędy importu

Usunięto błąd, który blokował wczytywanie szablonów raportów podczas importu aplikacji nAxiom.

×