Atrybuty w tworzeniu formularzy

Ten artykuł opisuje atrybuty dostępne we wszystkich formularzach.

Wspólna konfiguracja atrybutów: #

Każdy atrybut ma podobną konfigurację rozłożoną na różne zakładki.

1. Ogólne – zakładka z nazwą pola, numerem Guid, polem na opis, typem nadrzędnego atrybutu, typem atrybutu (pole tekstowe) i opcjami ustawienia tego pola jako widocznego, edytowalnego i wymaganego.

2. Warunki – zakładka umożliwiająca ustawienie zaawansowanych warunków i logiki dla pola.

Tryb atrybutu – jako wartość domyślna jest to Pole Standardowe. Po ustawieniu na Pole wyliczane automatycznie dostępne staje się nowe okienko.

Pole wyliczane automatycznie – wartość jest obliczana za każdym razem, gdy zmienia się wartość w polach zależnych (wybranych z listy). Ustawia się go za pomocą przełącznika, w którym mamy wybór:

SIMPLE – opcja bez kodu, wybieramy dane z dowolnej kolumny obsługiwanej listy lub wpisujemy wartość. Możliwe jest filtrowanie wyników z listy. Warunkiem pobrania wartości jest wybranie kolumny, która ma typ danych zgodny z typem pola. W przypadku pola Data przełącznik umożliwia wybór jednej z trzech opcji:

Wartość – wprowadź wartość ręcznie lub wybierz z obsługiwanej listy lub słownika.
Funkcja – dostępna dla dat, umożliwia tworzenie warunków zależnych od bieżącej daty (bieżący dzień, bieżący tydzień itp.). W przypadku funkcji określamy przesunięcie, np. Ten dzień -1 = poprzedni dzień; Ten dzień +1 = następny dzień.
Wartość dynamiczna – umożliwia wybór danych z listy.

W przypadku wyboru atrybutu przełącznik pozwala wybrać jeden z 3 trybów:

Wartość – wybiera wartość z listy dołączonej do atrybutu.
Wartość dynamiczna – wybiera wartość dynamiczną z listy dołączonej do atrybutu, masz możliwość ustawienia filtrów i rodzaju agregacji wyników: Pierwszy/ostatni.
Wartość dynamiczna na podstawie innej listy – wybierz wartość z listy innej niż dołączona do wybranego atrybutu.

SQL – wartość jest obliczana za każdym razem, gdy zmienia się wartość w polach zależnych (tj. wybranych ze wzmiankami z listy pod przyciskiem @ lub w wartościach, do których odwołuje się @), np. bieżący identyfikator użytkownika lub bieżący identyfikator grupy użytkowników. Możemy również użyć klasycznych zapytań SQL.
Przykład prostego zapytania SQL o niskim kodzie (low-code):
SELECT @Net + @Gross – ustawia wartość pola jako SUMĘ wybranych pól Net i Gross.

Pole obliczane automatycznie z opcją nadpisywania – tak samo jak pole obliczane automatycznie, ale wartość może zostać zmieniona w polu przez użytkownika.

Pole wyliczane dynamicznie (brak przechowywania wartości) – wartość jest obliczana podobnie do opcji Pole wyliczane automatycznie, jednak wartość nie jest przechowywana w bazie danych i jest obliczana za każdym razem, gdy dokument jest zapisywany lub atrybuty używane w obliczeniach ulegają zmianie.

Wartości domyślne – ustawienia są podobne do wartości obliczanej automatycznie. Wartość domyślna jest obliczana tylko raz, podczas tworzenia dokumentu. Uwaga: Jeśli w momencie tworzenia dokumentu wymagane dane do obliczeń nie zostaną podane, pole pozostanie puste. Jeśli dane zostaną dostarczone później podczas pracy z dokumentem, użyj opcji Automatycznie obliczone wartości.

3. Wygląd – zakładka służąca do konfiguracji szerokości elementu (Auto, px, %), szerokości kontrolki (Auto, px, %) oraz opcji układu elementu (układ 2-kolumnowy, układ 1-kolumnowy, styl globalny, etykieta po prawej stronie). Dostępna jest opcja Wyświetl w trybie etykiety (po zaznaczeniu pokazuje atrybut jako etykietę). Dostępna jest również sekcja Opcje układu etykiet, w której można ustawić styl tekstu od domyślnego do niestandardowego. W trybie niestandardowym można ustawić opcje formatowania (pogrubienie, kursywa, podkreślenie, rozmiar, kolor i kolor tła).

4. Konfiguracja – pole z ustawieniami specyficznymi dla typu atrybutu, używane w atrybutach wyboru, prezentacji danych, grupach i polach systemowych.

5. Komunikaty – zakładka służąca do dodawania podpowiedzi i wskazówek do pola.

6. Tłumaczenia – zakładka służąca do konfiguracji tłumaczenia na drugi język systemu. Można ustawić przetłumaczoną nazwę, podpowiedzi, etykiety.

7. Ustawienia warunkowego formatowania – umożliwia zdefiniowanie dodatkowych warunków formatowania tekstu. Warunki dodane poniżej określą sposób formatowania atrybutu. Jeśli warunki są określone, atrybut zostanie sformatowany zgodnie z pierwszym warunkiem, który pasuje do danych. Jeśli żaden warunek nie pasuje do danych i zdefiniowane jest formatowanie domyślne, tekst zostanie ułożony zgodnie z formatowaniem domyślnym. W przeciwnym razie atrybut nie zostanie sformatowany.

8. Zależności – lista wszystkich powiązanych formularzy, list czy aplikacji z naszym atrybutem na formularzu.

Podstawowe atrybuty #

Pole tekstowe #

Standardowe pole tekstowe. Służy do wprowadzania krótkich informacji tekstowych.

Pole wielowierszowe #

Obszar tekstowy z możliwością ustawienia wielu wierszy. Służy do wprowadzania dłuższych informacji tekstowych, np. pola opisu.

Edytor HTML #

Pole, które jest widżetem HTML – tzn. umożliwia wstawianie hiperłączy, tabel czy pogrubianie tekstu.

Liczba całkowita #

W tym polu można wprowadzać tylko liczby.

Liczba zmiennoprzecinkowa #

To pole umożliwia wprowadzanie liczb z miejscami dziesiętnymi.

Data i czas #

Pole umożliwia wybranie daty i godziny.

Data #

Pole umożliwia wybranie daty (bez godziny).

Czas #

Pole umożliwia wybranie godziny.

Hasło #

Jest to specjalne pole tekstowe, które nie jest widoczne podczas wpisywania. Ustawienia konfiguracji podobne do pola tekstowego (bez dodatkowych ustawień warunków formatu), ale z dodatkową zakładką Konfiguracja, w której można narzucić bezpieczną zmianę hasła. Po zapisaniu hasło jest przechowywane, ale niewidoczne.

Załączniki #

Dostępne opcje:

Pokaż podgląd pierwszego załącznika – otwiera podgląd pierwszych załączników podczas ładowania dokumentu.
Podpis elektroniczny – zezwala na cyfrowe podpisywanie załączonych dokumentów.
OCR – umożliwia optyczne odczytywanie dokumentów.
Tryb galerii – wyświetla załączniki graficzne jako galerię.
Użytkownik może również ustawić maksymalną ilość i rozmiar pliku w MB.

Przy podglądaniu przesłanych plików użytkownik może wybrać formę:

oryginalny plik,
grafika,
oryginalny plik i grafika.

Obraz #

Pole, w którym można dodawać załączniki graficzne z dysku lokalnego. W przeciwieństwie do atrybutu Załączniki, obraz jest wyświetlany w formularzu jako np. zdjęcie profilowe użytkownika. Ustawienia konfiguracji są podobne do pola Załączniki, ale konfiguracja ustawia tylko szerokość, wysokość i maksymalny rozmiar pliku w MB.

Przycisk akcji #

Pole Przycisk Akcji umożliwia wykonanie określonej akcji. Przycisk może służyć np. do przekierowania na określony adres URL, tworzenia nowych dokumentów lub wykonania dowolnej akcji rozumianej jako wyrażenie SQL. Atrybut ten ma nieco inne ustawienia w 3 zakładkach:

Warunki – zakładka służąca tylko do ustawienia warunków widoczności.
Wygląd – zakładka służąca do konfiguracji szerokości etykiety (Auto, px, %) i szerokości kontrolki (Auto, px, %).
Konfiguracja – zakładka służąca do ustawiania opcji takich jak: Wyświetl na nowym dokumencie (przycisk będzie widoczny w nowych, jeszcze niezapisanych dokumentach), Wyświetl w trybie edycji (przycisk będzie widoczny podczas edycji dokumentu), Wyświetl na podglądzie (przycisk będzie widoczny tylko w trybie widoku), Wyrównanie (Do lewej, Do środka, Do prawej), Wygląd przycisku i Akcja: użytkownik otrzymuje listę możliwych akcji do wyboru. Dostępnych jest kilka akcji systemowych do wykonania. Akcje mogą działać na dokumentach i procesach, a nawet skanować kody kreskowe. Podczas tworzenia dokumentu musimy wybrać formularz, czy automatycznie uruchomić na nim proces i jak dokument zostanie otwarty (okno lub PopUp).

Ikona #

Pole, w którym można ustawić ikonę graficzną. W zakładce Konfiguracja możemy wybrać ikonę do wyświetlenia, kolor (systemowy lub z palety) oraz rozmiar (krotność lub w px).

Atrybuty wyboru #

Przełącznik #

To pole umożliwia wybranie tylko jednej z 2 pozycji w zestawie danych. W celu konfiguracji należy wprowadzić dwie wartości stanu włączonego i wyłączonego.

Pojedynczy wybór #

To pole umożliwia wybranie tylko jednego z elementów w zestawie danych. Przycisk ten może zostać wybrany przez użytkownika, ale nie może zostać wyczyszczony. Trzeba skonfigurować ustawienia takie jak: orientacja pionowa/pozioma i źródło danych. W tym drugim przypadku wybieramy, czy dane mają pochodzić ze Słownika lub z Lista. Ustawienie listy jest podobne do wstawiania listy. W przypadku korzystania ze słownika użytkownik sam wprowadza opcje wyboru.

Pole wyboru #

Pole umożliwia wybranie tylko jednego z elementów w zestawie danych. Ten przycisk może być wybierany i usuwany przez użytkownika. Konfiguracja jest podobna do konfiguracji pola radiowego (bez ustawień warunków konfiguracji i formatu).

Pole wielokrotnego wyboru #

To pole umożliwia wybranie kilku elementów z danego zestawu danych. Konfiguracja jest podobna do pola pojedynczego wyboru.

Lista rozwijana #

Lista wyświetlająca dane z danego zestawu danych. Konfiguracja jest podobna do pola pojedynczego wyboru.

Lista rozwijana wielokrotnego wyboru #

Lista wyświetlająca dane z danego zestawu danych i oferująca wybór kilku pozycji z listy. Konfiguracja jest podobna do pola pojedynczego wyboru.

Atrybuty prezentacji danych #

Lista #

To pole służy do wstawiania listy dokumentów do formularza. Podczas konfiguracji użytkownik wybiera dane z załączonej listy. Istnieje możliwość filtrowania danych, co zostało opisane w artykule tutaj. W tej zakładce użytkownik może zdecydować, czy powiązana lista będzie wyświetlana zgodnie z jej standardowymi ustawieniami (globalnymi lub wybranymi podczas konfiguracji listy), czy też zostaną one nadpisane przez ustawienia wybrane w tej zakładce. Więcej informacji na temat tworzenia listy można znaleźć tutaj.

Wykres #

Pole służy do wstawiania wykresu na podstawie danych z określonej listy. W zakładce konfiguracja wybieramy typ wykresu (liniowy, słupkowy lub kołowy) i wybieramy listę. Następnie możemy zawęzić listę poprzez dodanie filtrów, agregacji miar (np. Suma), miar (na podstawie kolumn całkowitych), argumentów (na podstawie kolumn listy), etykiet danych, etykiet narzędzi i pozycji legendy na wykresie.

Statyczny tekst #

Pole używane do wprowadzania zwykłego tekstu do formularza, ale niezgrupowane jako pole tekstowe. W dużej mierze służy do ustawiania nieedytowalnych opisów w formularzu. Konfiguracja jest podobna do Listy pól z wyjątkiem zakładki Konfiguracja, gdzie wprowadzany jest tylko wyświetlany tekst.

Wykresy Gantta #

Pole umożliwiające wstawienie wykresu Gantta. Przydatny do prezentacji postępów w projektach i zarządzania zadaniami. Aby go ustawić wybieramy listę jako bazę danych dla wykresu, następnie Nazwę – atrybut identyfikujący rekordy na wykresie – oraz Daty rozpoczęcia/zakończenia.

Atrybuty grupujące #

Grupa #

To pole służy do tworzenia pola grupowania w formularzu. Jeden z najważniejszych atrybutów do zaprojektowania przystępnego UX. Grupy są odpowiedzialne za ostateczną prezentację dokumentów i pulpitów (dashboardów). Atrybut ten ma nieco inne ustawienia w 3 zakładkach:

Warunki – zakładka do ustawienia warunków widoczności. Aby ustawić te warunki wybieramy operatora (zawiera, nie zawiera, zaczyna się od, kończy się na, równa się, nie równa się, reset) i źródło danych z pola w formularzu lub ze standardowych pól systemowych (autoinkrementacja, czyli zwiększanie wartości argumentu o 1, i dane oparte na bieżącym użytkowniku). Możemy również ustawić filtry na podstawie zmiennych.
Wygląd – zakładka służąca do konfiguracji szerokości etykiet (Auto, px, %) i kontrolek (Auto, px, %). Zawiera opcję pokazywania/ukrywania nagłówka grupy.
Konfiguracja – zakładka służąca do ustawiania opcji: Pokaż nagłówek, Rozszerzona (grupa będzie domyślnie rozszerzona), Rozszerzalna (zezwalaj użytkownikowi na otwieranie/zamykanie grupy), Grupa przewijana (jeśli grupy nie mieszczą się na ekranie, przypisywane są im niezależne suwaki), Pokaż zawartość w kolumnach, Podgląd okna dialogowego oraz Opcje szerokości kolumn.

Lista elementów #

Lista umożliwia grupowanie pól w jednym wierszu, przy czym każde pole jest traktowane jako kolumna na liście. Aby dodać listę elementów, należy dodać element, a następnie dołączyć poszczególne kolumny jako podelementy wewnątrz okna atrybutu za pomocą przeciągania i upuszczania. W konfiguracji możemy ustawić jedynie szerokość dla każdego podelementu.

Panel zakładek #

Pole służy do umieszczania w formularzu panelu z niestandardowymi zakładkami. Najpopularniejsze nazwy zakładek to: Ogólne, Obieg, Komentarze i Uprawnienia.

Grupa przycisków #

Pole zawierające grupę standardowych przycisków, takich jak Zapisz, Edytuj czy Wstecz. Służy do projektowania lepszego UX. Gdy w formularzu wymagany jest więcej niż jeden przycisk w pobliżu, zaleca się zgrupowanie ich w grupie przycisków i umieszczenie ich razem w odpowiednim miejscu formularza.

Separator #

Pole bez zawartości służy do oddzielania pól w formularzu i tworzenia pustej przestrzeni. Ustawienia konfiguracyjne są podobne do Panelu zakładek.

Atrybuty systemu #

Dokumenty nadrzędne #

Pole z listą wyświetlającą tylko dokumenty nadrzędne do naszego dokumentu. Konfiguracja jest podobna do wstawiania listy. Pole służy do drzewiastego wyświetlania list i prawidłowego zachowania wykresów Gantta. Użyj go, aby przypisać dokument do innego dokumentu (wyższego w hierarchii). Dobrym przykładem jest Projekt (rodzic) posiadający Zadania (dzieci).

Dokumenty podrzędne #

Pole z listą wyświetlającą tylko dokumenty podrzędne do naszego dokumentu. Konfiguracja jest podobna, ale odwrotna do pola Dokumenty nadrzędne.

Dokumenty powiązane #

Pole z listą wyświetlającą wszystkie dokumenty powiązane z naszym dokumentem. Konfiguracja jest podobna do pola Parent documents.

Uprawnienia #

To pole służy do wyświetlania uprawnień dla dokumentu. Użytkownicy z odpowiednimi uprawnieniami mogą dodawać nowe uprawnienia do dokumentu za pośrednictwem tego widżetu. Nie jest tutaj potrzebna żadna dodatkowa konfiguracja. Więcej o złożonych ustawieniach uprawnień można przeczytać tutaj.

Komentarze #

Ten widżet systemowy służy do publikowania komentarzy do dokumentu. Składa się z edytora HTML i mechanizmów pozwalających na cytowanie i odpowiadanie na inne komentarze. Widżet ten pozwala również na odwołanie się do konkretnego pracownika, co umożliwia przekazywanie informacji lub poleceń bez uruchamiania obiegu dokumentu. Konfiguracja obejmuje dodanie użytkownika, aby zawsze otrzymywał powiadomienia systemowe lub zawsze informował użytkownika e-mailem. Istnieje również opcja powiadamiania twórcy dokumentu przez e-mail.

Proces #

Zakładka pokazuje historię obiegu dokumentu. Możliwe jest ustawienie w konfiguracji, aby wyświetlane były tylko działania wykonane przez użytkownika.

Zastępstwa #

Zakładka pokazuje listę użytkowników ustawionych jako możliwe zastępstwa dla użytkownika w obiegu dokumentów oraz przycisk umożliwiający dodanie zastępstwa.

Sygnatura dokumentu #

To pole systemowe automatycznie wygeneruje unikatowy numer na podstawie numeru ostatnio zapisanego dokumentu. W przypadku braku dokumentów na liście, system rozpocznie ich numerację od 1. Jeśli sygnatura nie zostanie zdefiniowana system automatycznie nada dokumentom numery zaczynając od 1. W zakładce konfiguracja możliwe jest ustawienie schematu formatowania sygnatury. Przykładowy schemat: SYMBOL/@DocumentDate(’rrrr’)/@DocumentDate(’MM’)/@AutoIncrement(’000′)
Wynik: SYMBOL/2020/06/001

Ustawianie sygnatury jest ułatwione dla użytkownika poprzez odnośniki typu @mention (wzmianki). Na gifie prezentujemy jak ustawić sygnaturę opartą na symbolu z typu dokumentu zakupu, dacie dokumentu (rok, miesiąc) oraz dodajemy systemową kontrolkę do autoinkrementacji numerów (czyli zwiększania wartości argumentu o 1).

Dodatkowe pola:

Sygnatura nie może być zmieniona – wyłącza możliwość edycji podpisu po zapisaniu dokumentu.

Sygnatura jest unikalna w obrębie formularza – wyłącza możliwość dodawania dokumentów z tym samym podpisem w ramach tego formularza.

Utworzony przez użytkownika #

Automatycznie wypełniane pole tekstowe odnoszące się do użytkownika, który utworzył dokument. Użytkownik nie może edytować tego pola. Konfiguracja przebiega standardowo.

Modyfikowany przez użytkownika #

Automatycznie wypełniane pole tekstowe odnoszące się do ostatniego użytkownika, który zmodyfikował dokument. Użytkownik nie może edytować tego pola. Konfiguracja przebiega standardowo.

Data utworzenia #

System automatycznie wypełnia pole daty i godziny. Pole zawiera datę utworzenia dokumentu. Użytkownik nie może edytować tego pola. Konfiguracja przebiega standardowo.

Data modyfikacji #

System automatycznie wypełnia pole daty i godziny. Pole zawiera datę ostatniej modyfikacji dokumentu. Użytkownik nie może edytować tego pola. Konfiguracja przebiega standardowo.

Tytuł #

System automatycznie wypełnia pole tytułu. Pole zawiera nazwę dokumentu i ścieżkę w menu. Użytkownik nie może edytować tego pola. Konkretne warunki do ustawienia to, czy ma być:

Wartością dynamiczną – czyli być zawsze obliczana, a jej wartość nie jest przechowywana w bazie danych.

Wartością wyliczaną dynamicznie – tzn. być obliczana przy tworzeniu dokumentu, przy jego otwieraniu lub przy zmianie wartości pola zależnego. W tym przykładzie Tytuł będzie pokazywał Nazwę kampanii.

Jak usunąć pole z formularza? #

Podczas tworzenia aplikacji system tworzy zależności między polami, formularzami, listami i procesami. Jeśli chcesz usunąć atrybut z formularza, musisz najpierw usunąć wszystkie zależności (np. usunąć kolumnę opartą na tym atrybucie z listy). System powiadomi użytkownika odpowiednim komunikatem podczas próby usunięcia atrybutu z zależnościami.