Warunki na formularzu
Warunki sterują zachowaniem pól formularza: kiedy pole jest widoczne, edycyjne albo wymagane, jaką ma wartość domyślną, z jakich wartości użytkownik wybiera i co się dzieje po kliknięciu przycisku. Z tego artykułu dowiesz się, jak je ustawiać.
Zanim zaczniesz¶
- Warunki ustawiasz w edycji elementu formularza, na zakładce Warunki. Element otworzysz w drzewie elementów formularza albo z edytora wizualnego, przez Edytuj w menu elementu (patrz Tworzenie formularza).
- Wyrażenia pisze się w języku SQL i odwołują się one do tabel bazy Navigatora. Do prostych przypadków wystarczy prosty warunek, który nie wymaga SQL.
Sekcje warunków¶
Zakładka Warunki składa się z sekcji. Każda sekcja ustawia jedno zachowanie elementu:
| Sekcja | Co ustawia | Wyrażenie SQL musi zwrócić |
|---|---|---|
| Widoczność | Czy element jest widoczny. | 1 widoczny, 0 ukryty. |
| Edycyjność | Czy wartość można zmienić. | 1 edycyjny, 0 tylko do odczytu. |
| Wymagalność | Czy pole trzeba wypełnić przed zapisem. | 1 wymagane, 0 niewymagane. |
| Wyróżnienie | Czy element jest wyróżniony na czerwono. | 1 wyróżniony, 0 zwykły. |
| Warunek poprawności | Czy wartość pola jest poprawna. Niepoprawna blokuje zapis. | 1 poprawna, 0 niepoprawna. |
| Domyślna wartość | Wartość pola w nowym obiekcie. | Value, a dla pól wyboru ID i Value. |
| Pole wyliczane automatycznie | Wartość wyliczaną z innych pól. | Jedną wartość, a dla pól wyboru ID i Value. |
| Zestaw danych | Wartości do wyboru w liście rozwijanej, autowyszukiwaniu i polach wyboru. | Kolumny ID i Value. |
| Ograniczenie zestawu danych | Zawęża wartości do wyboru albo zawartość listy. | Jedną kolumnę ID. |
| Akcje | Co się dzieje po kliknięciu przycisku. | Nic. Zwrócony tekst Navigator pokaże jako komunikat. |
Zestaw sekcji zależy od elementu:
- Widoczność i Wyróżnienie ma prawie każdy element, także zakładka i kontener,
- Edycyjność mają elementy, które można edytować, czyli wszystkie poza etykietą,
- Wymagalność, Warunek poprawności, Domyślna wartość i Pole wyliczane automatycznie mają pola wbudowane, atrybuty i kolumny list atrybutów,
- Zestaw danych mają atrybuty z listą wartości: listy rozwijane, autowyszukiwanie i pola wyboru,
- Ograniczenie zestawu danych mają listy i pola wbudowane z wyborem obiektu, np. Kategoria, Właściciel, Kontrahent, Forma płatności, Waluta czy Tagi,
- Akcje mają przyciski.
Definicja warunku¶
W każdej sekcji najpierw wybierasz Definicję, czyli sposób zapisu warunku:
| Definicja | Gdzie | Opis |
|---|---|---|
| Wyrażenie | Wszystkie sekcje | Zapytanie SQL. |
| Prosty warunek | Widoczność, edycyjność, wymagalność, wyróżnienie, poprawność, wartość domyślna | Warunek wyklikany z list, bez SQL. |
| Słownik | Zestaw danych | Wartości ze słownika. |
| Prosta lista | Zestaw danych | Wartości wpisane ręcznie. |
| Lista powiązana | Zestaw danych kolumny listy atrybutów | Wartości z kolumn listy. |
| Akcja z listy | Akcje | Akcja systemowa zamiast SQL. |
Bez wybranej definicji sekcja nie działa, a element zachowuje się według ustawień typu dokumentu.
Prosty warunek¶
Prosty warunek opisuje, kiedy wynik ma być prawdą, np. kiedy pole ma być widoczne. Składa się z wierszy z kolumnami Typ, Zmienna, Operator i Wartość.
- W sekcji, np. Widoczność, wybierz definicję Prosty warunek.
- W kolumnie Zmienna wybierz pole formularza albo parametr systemowy, od którego zależy warunek.
- W kolumnie Typ wybierz, z czym porównać zmienną:
- Stała: z wartością wpisaną albo wybraną w kolumnie Wartość,
- Funkcja: z bieżącym dniem, tygodniem, miesiącem, kwartałem albo rokiem. Liczba obok funkcji przesuwa okres, np. Bieżący miesiąc
-2to dwa miesiące wstecz, - Pole: z wartością innego pola formularza.
- Wybierz Operator i podaj Wartość.
- Żeby dodać kolejny wiersz, kliknij Dodaj i wybierz, jak ma się łączyć z poprzednim: oraz albo lub.
- Kliknij Zapisz.
Przykład: pole Uzasadnienie ma być widoczne tylko dla wniosków pilnych. W jego sekcji Widoczność ustaw typ Stała, zmienną Czy pilne, operator równe i wartość Tak.
W Warunku poprawności zmienną jest samo pole, którego dotyczy warunek. Przykład: data realizacji nie może być wcześniejsza niż dziś. Ustaw typ Funkcja, operator większe lub równe i wartość Bieżący dzień 0.
Dostępne operatory zależą od rodzaju zmiennej:
| Rodzaj zmiennej | Operatory |
|---|---|
| Liczba, data, identyfikatory | równe, różne, większe, mniejsze, większe lub równe, mniejsze lub równe, jest pusta, nie jest pusta |
| Tekst, etykieta, pola wielokrotnego wyboru, autowyszukiwanie multiwybór | równe, różne, zawiera, nie zawiera, jest pusta, nie jest pusta |
| Lista rozwijana, autowyszukiwanie, pole jednokrotnego wyboru | równe, różne, jest pusta, nie jest pusta |
Przy typach Funkcja i Pole operatory jest pusta i nie jest pusta nie są dostępne.
Wartość domyślna¶
W wartości domyślnej prosty warunek ma jedno pole Typ:
- Stała: wpisujesz wartość,
- Funkcja: dla dat, np. Bieżący dzień,
- parametr systemowy, np. ID zalogowanego użytkownika, żeby polem domyślnie była osoba dodająca dokument.
Wyrażenie SQL¶
Wyrażenie to zapytanie SQL, którego wynik zależy od sekcji (patrz Sekcje warunków). Do pól formularza i parametrów systemowych odwołujesz się przez parametry, czyli nazwy poprzedzone znakiem @.
- W sekcji wybierz definicję Wyrażenie.
- Wpisz zapytanie, np.
SELECT CASE WHEN @Kwota > 10000 THEN 1 ELSE 0 END. - Kliknij Generuj parametry. Pod wyrażeniem pojawi się lista parametrów z zapytania.
- Przy każdym parametrze wskaż, skąd ma brać wartość: z pola formularza (pozycje Pole formularza: …) albo z parametru systemowego (pozycje Pole systemowe: …).
- Kliknij Zapisz.
Po każdej zmianie nazw parametrów w zapytaniu kliknij Generuj parametry jeszcze raz.
Znak @ jest zarezerwowany dla parametrów. Jeśli potrzebujesz go w tekście, np. w adresie e-mail, wpisz zamiast niego [at].
Parametry systemowe¶
Oprócz pól formularza parametr może przyjąć jedną z wartości systemowych:
| Parametr | Wartość |
|---|---|
| ID zalogowanego użytkownika | Identyfikator osoby, która ma otwarty formularz. |
| ID grup zalogowanego użytkownika | Grupy, do których należy ta osoba. |
| ID stanowiska zalogowanego użytkownika | Jej stanowisko. |
| ID działu zalogowanego użytkownika | Jej dział. |
| ID przełożonego dla zalogowanego użytkownika | Jej przełożony. |
| ID stanowiska przełożonego dla zalogowanego użytkownika | Stanowisko przełożonego. |
| ID języka zalogowanego użytkownika | Język interfejsu. |
| ID edytowanego obiektu | Identyfikator dokumentu, zadania itp. W nowym obiekcie jest pusty. |
| ID firmy | Firma obiektu. |
| ID pola formularza, GUID pola formularza | Identyfikator elementu, którego dotyczy warunek. |
| Numer wiersza, ID wiersza pozycji | Wiersz listy atrybutów albo pozycji dokumentu, w którym jest pole. |
| Nazwa kroku oczekującego | Nazwa kroku obiegu, na który czeka obiekt. |
Zestaw danych¶
Zestaw danych określa, z jakich wartości użytkownik wybiera w liście rozwijanej, autowyszukiwaniu albo polach wyboru.
| Definicja | Jak ustawić |
|---|---|
| Słownik | Wybierz słownik. Pole pokaże jego elementy. |
| Prosta lista | Kliknij Dodaj i wpisz ID oraz Wartość każdej pozycji. Kolejność zmienisz przyciskami Przenieś w górę i Przenieś w dół. |
| Wyrażenie | Zapytanie zwracające kolumny ID i Value, np. SELECT ID, Name AS Value FROM DoCa WHERE Deleted = 0. |
Prosta lista wystarcza dla stałego zestawu kilku wartości, np. Tak, Nie, Nie dotyczy. Wartości, które administrator ma zmieniać bez edycji formularza, lepiej trzymać w słowniku.
Wyrażenie z parametrem tworzy zależne listy wyboru. Na przykład podkategorie zależne od wybranej kategorii: SELECT ID, Name AS Value FROM DoCa WHERE Deleted = 0 AND Parent = @Kategoria.
Ograniczenie zestawu danych¶
Ograniczenie zawęża wartości, które pole już ma, np. listę kategorii albo zawartość listy na formularzu. Zapytanie zwraca jedną kolumnę ID z identyfikatorami wartości, które mają zostać, np. SELECT ID FROM Do WHERE DoCaID = 5.
Przy zestawie danych ze słownika Navigator dołącza zapytanie do zapytania słownika jako warunek ID IN (...). Takie zapytanie nie może zawierać ORDER BY ani IF.
W polach Forma płatności i Waluta ograniczenie zawęża tylko listę do wyboru. Wartość zapisana wcześniej w dokumencie albo ustawiona automatycznie, np. z KSeF, zostaje, nawet jeśli jest poza ograniczeniem. Przykład: tylko PLN i EUR, SELECT ID FROM Cu WHERE Symbol IN ('PLN', 'EUR').
Parametry poza formularzem
Ograniczenie działa też poza formularzem, np. w filtrach listy i w krokach obiegu. Tam parametry będące polami formularza mają wartość NULL. Uwzględnij to w zapytaniu, bo inaczej lista będzie pusta, np. SELECT ID FROM DiEl WHERE @Pole IS NULL OR [Name] LIKE @Pole + '%'.
Pole wyliczane automatycznie¶
Pole wyliczane dostaje wartość z zapytania, gdy użytkownik zmieni któreś z pól będących parametrami. Przykład, średnia z dwóch pól: SELECT (@Pole1 + @Pole2) / 2.
Do kolumn listy atrybutów odwołujesz się tak samo jak do pól, ale parametr zawiera wtedy wartości ze wszystkich wierszy. Żeby je podliczyć, użyj konstrukcji WITH:
-- suma kolumny
WITH Cte(Value) AS (SELECT @Kwota) SELECT SUM(Value) FROM Cte
-- średnia z dwóch kolumn
WITH Cte(Value) AS (SELECT @Kolumna1 UNION ALL SELECT @Kolumna2) SELECT AVG(Value) FROM Cte
-- wartości z pierwszej kolumny w wierszach, w których druga kolumna ma wartość 1
WITH Cte(Value1, Value2) AS (SELECT @Kolumna1, @Kolumna2) SELECT Value1 FROM Cte WHERE Value2 = 1
Warunek poprawności z komunikatem¶
Gdy warunek poprawności zapiszesz jako wyrażenie, pod zapytaniem pojawia się pole Komunikat. Wpisz w nim, co ma zobaczyć użytkownik, gdy wartość jest niepoprawna, np. „Data realizacji nie może być wcześniejsza niż data dokumentu”. Komunikat możesz przetłumaczyć na inne języki.
Akcje¶
Sekcja Akcje przycisku wykonuje się po jego kliknięciu.
- Wyrażenie: zapytanie SQL, np. zmiana danych w bazie. Jeśli zwróci tekst, Navigator pokaże go jako komunikat.
- Akcja z listy: akcja systemowa, np. utworzenie dokumentu albo wysłanie e-maila. Wybierasz ją w polu Akcja i uzupełniasz jej Parametry. Wykonanie opóźnione uruchamia akcję na końcu, np. po odświeżeniu uprawnień, zamiast na początku.
Co dalej¶
- Elementy formularza: rodzaje elementów i ich ustawienia.
- Tworzenie formularza: budowa formularza.