Otwieranie formularza

Podsumowanie:

Akcja otwierania formularza umożliwia otworzenie wskazanego formularza oraz przekazanie parametrów do tego formularza.

☛ AdminSPA > NARZĘDZIA > Akcje > Otwieranie formularza

Oprócz właściwości wspólnych dla wszystkich akcji, w akcji otwierania formularza należy określić następujące właściwości:

• Typ okna: określa rodzaj okna, w którym zostanie wyświetlony formularz:
  • Dialog: formularz zostanie otwarty w trybie okna dialogowego (pop-up)
  • Okno: formularz zostanie otwarty w trybie okna
  • Link wewnętrzny: formularz zostanie wyświetlony w trybie linku wewnętrznego
  • Panel boczny: formularz zostanie otwarty w trybie panelu bocznego, to jest jego prawa krawędź będzie zadokowana do prawej krawędzi okna przeglądarki; ten tryb jest przeznaczony do wyświetlania formularza przez kliknięcie rekordu w widoku listy. Akcja, w której zostanie wybrany ten tryb, musi zostać przypisana w we właściwości Wywołaj akcje po interakcji z rekordem listy na karcie Ustawienia listy.
• Szerokość/Wysokość: (tryby Dialog i Okno) określona w pikselach szerokość i wysokość okna formularza.
• Pełny ekran: (tryb Okno) po włączeniu wyświetla formularz, wykorzystując całe dostępne miejsce w oknie przeglądarki.
• Szerokość: (tryb Panel boczny) określona w procentach szerokość formularza względem miejsca dostępnego w oknie przegladarki.
• Sposób wyboru identyfikatora formularza:
  • wybierz z listy: wyświetla okno dialogowe z listą zdefiniowanych formularzy
  • zdefiniuj przez SQL: wyświetla okno edycji SQL w celu zdefiniowania zapytania, które zwróci identyfikator GUID formularza
• Otwierany dokument:
  • nowy dokument: otwiera pusty formularz
  • wskazany dokument: wpisz identyfikator dokumentu, który ma zostać otwarty; w polu obsługiwane są zmienne odwołujące się do kontekstu bieżącego formularza {@NazwaPola}.
• Przekazywanie parametrów do formularza: kliknij przycisk wybierz parametry i wartości i w wyświetlonym oknie dialogowym wpisz parametry, czyli wartości, które zostaną wstawione w odpowiednie pola formularza (dostępne są pola użytkownika i pola systemowe); w polach wprowadzania można wpisać stałe wartości, zmienne typu {@Nazwa} oraz zapytania SQL zwracające wartości.

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.

Zależnie od obiektu źródłowego, z którego wykonywana jest akcja Otwórz formularz, odwołania do wartości z tego obiektu powinny wyglądać jak w poniższej tabelce.

Podgląd URL: wyświetla podgląd linku do otwieranego formularza

Powiązane tematy:

• Wspólne parametry akcji

---