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.

Ogólne #

Zakładka zawiera podstawowe informacje o atrybucie:

Nazwa: pole tekstowe które z nazwą atrybutu. Tekst z tego pola będzie wyświetlany jako etykieta pola na formularzu. Nazwa może być dowolna, w przypadku zbyt długiej nazwy będzie ona zawinięta lub skrócona na formularzu.

Guid: Unikalny identyfikator pola który może być użyty np. w zapytaniach SQL.

Opis: pole w którym możemy np. wskazać cel użycia pola lub opisać użyte mechanizmy.

Rodzic atrybutu: Odwołanie do nadrzędnego atrybutu; dzięki temu polu możemy łatwo przenosić całe sekcje w inne miejsce poprzez wybór nowego rodzica.

Typ atrybutu: Pole wyboru w którym znajduje się typ atrybutu. Po dodaniu nowego atrybutu a przed zapisaniem formularza  możemy jeszcze dowolnie zmienić typ atrybutu, po zapisaniu formularza możliwość zmiany będzie drastycznie ograniczona. System pozwoli tylko na zmiany typu które nie będą psuły danych np. Lista rozwijana > Lista rozwijana wielokrotnego wyboru

Widoczne: Przełącznik, który wykasuje czy pole jest widoczne na formularzu.

Edytowalne: Przełącznik, który wskazuje czy pole można edytować

Wymagane: Przełącznik, który wskazuje czy pole jest wymagalne

Warunki #

Zakładka umożliwiająca ustawienie zaawansowanych warunków i logiki dla pola. Wygląd zakładki może się różnić w zależności od rodzaju atrybutu oraz od trybu działania atrybutu.

Tryb atrybutu – jako wartość domyślna jest to Pole Standardowe.

Do wyboru mamy następujące opcje:

Pole standardowe #

Wartość pola jest wprowadzana ręcznie przez użytkownika. Istnieje możliwość podania wartości domyślnej, możemy sterować wszystkimi parametrami pola takimi jak widoczność, edytowalność, wymagalność czy warunek walidacji.

Wartość domyślna #

Wartość domyślna obliczana jest tylko raz, podczas tworzenia dokumentu. Ustawienie to jest widoczne tylko w trybie pola standardowego, przy polach wyliczanych warto domyślna znika.

Za pomocą przełącznika można ustawić tryb pracy:

SIMPLE – wybieramy z dane z dowolnej kolumny podpiętej listy. Istnieje możliwość filtrowania wyników z listy. Warunkiem pobrania wartości jest wybór kolumny posiadającej typ danych zgodny z typem pola.

W przypadku pola Data przełącznik pozwala wybrać jedną z trzech opcji:

• Wartość – wpisujemy wartość ręcznie lub wybieramy z kalendarza
• Funkcja – pozwala na budowę warunków zależnych od bieżącej daty (bieżący dzień, bieżący tydzień itp.). W przypadku funkcjo zamiast wartości podajemy przesunięcie, np. -1 = poprzedni dzień; +1 = następny dzień
• Wartość dynamiczna – pozwala na wybranie danych z listy

W przypadku atrybutów wybory przełącznik pozwala wybrać jedną z 3 opcji:

• Wartość – wybieramy wartość z listy podpiętej do atrybutu
• Wartość dynamiczna – wybieramy wartość dynamiczną z listy podpiętej do atrybutu, mamy możliwość ustawienia filtrów oraz typu agregacji wyników pierwszy/ostatni
• Wartość dynamiczna na podstawie innej listy – wybieramy wartość z innej listy niż podpięta do atrybutu wyboru.

Uwaga! Jeżeli w chwili utworzenia dokumentu nie zostaną dostarczone wymagane dane do obliczeń, pole pozostanie puste. Jeżeli dane będą dostarczane w trakcie pracy z utworzonym dokumentem skorzystaj z opcji Wartości wyliczane

SQL – wpisujemy wartość ręcznie lub wskazujemy pole na formularzu lub zmiennej środowiskowej np. ID zalogowanego użytkownika lub ID grup zalogowanego użytkownika. Możemy także używać klasycznych zapytań SQL. W przypadku używania wartości tekstowych w zapytaniach SQL należy zastosować składnie:
SELECT N’przykładowy tekst’.
Inny przykład zapytania low-code SQL:
SELECT GETUTCDATE() – ustawia wartość pola na bieżącą datę.

Pole wyliczane automatycznie #

Wartość jest obliczana za każdym razem, gdy zmienia się wartość w polach wskazanych w warunku wyliczenia lub na liście. Do wyboru mamy dwa tryby pracy:

SIMPLE – opcja bez kodu, która pozwala na łatwe wskazanie wartości. W zależności od rodzaju atrybutu możemy mieć do wyboru różne opcje wskazania danych.

Dla pól tekstowych lub liczbowych wskazujemy listę, kolumnę na liście oraz filtr. Dodatkowo mamy funkcje agregujące takie jak Pierwszy, Ostatni, Suma, Maksymalna wartość itp. Funkcje muszą oczywiście odpowiadać rodzajowi atrybutu.

Możliwe jest ustawienie filtrów na liście co ogranicza zakres danych służących do wyliczenia.

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 atrybutu wyboru 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. W przypadku tej opcji należy uważać, by dane na innej liście zgadzały się ze źródłem danych na atrybucie.

SQL – wartość jest obliczana za każdym razem, gdy zmienia się wartość w polach od których zależy edytowane pole (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 #

Opcja działa tak samo jak pole obliczane automatycznie, z tym że wartość może zostać zmieniona w polu przez użytkownika. Dlatego w tym widoku poza opcjami z pola wyliczanego mamy również możliwość określenia warunków widoczności, edytowalności czy wymagalności pola a także warunek poprawności danych.

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 formularz jest odświeżany. Pole to może służyć np. jako dynamiczny licznik który odczytuje wartości z listy lub bazy danych.

Zmień wartość pola #

Dodatkową opcją przy polach wyliczanych automatycznie jest opcja „Zmień wartość pola”. Można powiedzieć, że działa ona jak „odwrócony trigger”. O ile konfigurując wartość wyliczaną określaliśmy od jakich pól zależy pole które konfigurujemy czyli określaliśmy, że pole ma się zmienić o ile zmienią się wartości pól od których ono zależy to w przypadku zmiany wartości pola definiujemy akcję odwrotną – zmień wartość wskazanego pola jeżeli zmieni się pole które aktualnie konfigurujemy.

Konfiguracje tego elementu jest podobna jak konfiguracja wartości domyślnej – możemy albo wybrać opcję SIMPLE czyli podać wartość stałą (np. tekst, liczbę, element z listy) albo użyć zapytania SQL do wyliczenia wartości pola.

W tym miejscu warto zauważyć po co jest ta dodatkowa opcja. Podobną funkcjonalność możemy osiągnąć przez zwykłą wartość wyliczaną automatycznie. Może się jednak okazać tak, że wartość A zależy od B a wartość B zależy od A. Na przykład mając wartość netto chcemy wyliczyć brutto a mając wartość brutto chcemy wyliczyć netto. Jeżeli użyjemy wyliczeń automatycznych to system zgłosi błąd – znajdzie pętlę w obliczeniach. Używając opcji Zmień wartość pola omijamy ten problem. Jeżeli w jednym z pól będzie wyliczenie automatyczne a w drugim zmień wartość pola to pętli nie będzie. Na pokazanym wyżej przykładzie pole Wartość PLN zależy od pól Wartość i Kurs, w opcji Zmień wartość pola wyliczamy pole Kurs wartościami z pól Wartość PLN i Wartość

Pozostałe warunki #

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.

Warunek widoczności – pozwala na ustawienie warunku, kiedy pole będzie widoczne. Do wyboru mamy dwa tryby: SQL oraz SIMPLE które działają podobnie jak w automatycznym wyliczeniu. Różnica jest taka, że zapytanie SQL powinno zwracać 0 (pole niewidoczne) lub 1 (pole widoczne) zaś w trybie SIMPLE mamy drzewo warunków, na którym możemy budować złożone warunki logiczne bazując na danych z formularza, formularzach konfiguracyjnych lub zmiennych środowiskowych.

Warunek edytowalności – pozwala na ustawienie warunku, kiedy pole będzie można edytować. Do wyboru mamy dwa tryby: SQL oraz SIMPLE które działają podobnie jak w automatycznym wyliczeniu. Różnica jest taka, że zapytanie SQL powinno zwracać 0 (pole jest nieedycyjne) lub 1 (pole jest edycyjne) zaś w trybie SIMPLE mamy drzewo warunków, na którym możemy budować złożone warunki logiczne bazując na danych z formularza, formularzach konfiguracyjnych lub zmiennych środowiskowych.

Warunek wymagalności – pozwala na ustawienie warunku, kiedy pole musi zostać uzupełnione. Do wyboru mamy dwa tryby: SQL oraz SIMPLE które działają podobnie jak w automatycznym wyliczeniu. Różnica jest taka, że zapytanie SQL powinno zwracać 0 (pole może zostać puste) lub 1 (pole musi być uzupełnione) zaś w trybie SIMPLE mamy drzewo warunków, na którym możemy budować złożone warunki logiczne bazując na danych z formularza, formularzach konfiguracyjnych lub zmiennych środowiskowych.

Warunek walidacji – pozwala na ustawienie warunku poprawności danych. Możemy tu określić zależność pola od innych pól (np. data powrotu musi być większ lub równa od daty wyjazdu) od stałych (ilość dni musi być większa od zer) lub, w przypadku dat, od funkcji (data dokumentu musi być z bieżącego miesiąca). Do wyboru mamy dwa tryby: SQL oraz SIMPLE które działają podobnie jak w automatycznym wyliczeniu. Różnica jest taka, że zapytanie SQL powinno zwracać 0 (dane są niepoprawne) lub 1 (dane są poprawne) zaś w trybie SIMPLE mamy drzewo warunków, na którym możemy budować złożone warunki logiczne bazując na danych z formularza, formularzach konfiguracyjnych lub zmiennych środowiskowych.

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 wybrać domyślny styl dla formularza lub ręcznie ustawić style jedno- lub dwukolumnowy. Niestandardowym stylem, dostępnym tylko w tej opcji jest umieszczenie etykiety po prawej stronie. Dla atrybutu Checkboks dostępny jest styl Etykieta po prawej stronie z marginesem, który powoduje, że cała kontrolka wyrównywana jest  do stylu 2-kolumnowego.

Efekt tych ustawień można zobaczyć poniżej:

Ostatnim ustawieniem jest wygląd atrybutu w którym 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).

Dla liczb dodatkowo mamy możliwość ich formatowania w dwóch opcjach: Liczba oraz Procent

W trybie liczbowym mamy  możliwość wyboru jednostki, czyli grupowania liczb w setki, tysiące, miliony itp oraz określenie ilości miejsc po przecinku wyświetlanych liczb. Możemy też wymusić, by wyświetlany był separator grup  wliczbach (oddzielenie setek, tysięcy, milionów)

Przy wybraniu trybu procentowego możemy określić ilość miejsc po przecinku które będą wyświetlane.

Efekt tej konfiguracji wygląda tak:

Konfiguracja #

Zakładka z ustawieniami specyficznymi dla typu atrybutu, używane w atrybutach wyboru, prezentacji danych, grupach i polach systemowych. Dla niektórych atrybutów, np. pól tekstowych lub liczb, zakładka nie jest wyświetlana.

Komunikaty #

Zakładka służąca do dodawania podpowiedzi i wskazówek do pola. Możemy określić podpowiedzi wyświetlane w tooltipie czyli chmurce wyświetlanej po najechaniu myszą na etykietę formularza, pod etykietą lub w polu. Dla grup mamy dodatkowo podpowiedź pod ikoną I wyświetlaną obok etykiety.

Tłumaczenia #

Zakładka służąca do konfiguracji tłumaczenia na inne języki systemu. W zakładce będzie wyświetlane tyle pozycji ile mamy zdefiniowane w systemie. łatwo zauważyć, że w tej zakładce powtórzone są pola Nazwa i Opis z zakładki Ogólne oraz podpowiedzi z zakładki Komunikaty. Gdy przełączymy język systemu zmieni się zakładka Tłumaczenia, wartości wprowadzone dla aktualnego języka zostaną wyświetlone w zakładkach Ogólne i Komunikaty a do zakładki Tłumaczenia trafią ustawienia tych pól w języku polskim.

Dla atrybutów tekstowych – Pole tekstowe, Pole wielowierszowe, Edytor HTML, Sygnatura – pojawia się dodatkowa opcja:  Wartość tłumaczona. Jeżeli ta opcja jest ustawiona to dane zapisane w tym polu są przechowywane w bazie danych oddzielnie dla każdego języka. Oznacza to, że np. po przełączeniu języka z polskiego na angielski możemy wprowadzić wartość angielski. Po zapisaniu wartość ta nie nadpisze wartości po polsku. Po przełączeniu języka na polski będziemy widzieć polską nazwę a po przełączeniu z powrotem na angielski pojawi się angielska wartość.

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.

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 #

Pole służy do przechowywania plików powiązanych z formularzem. Dla wybranych typów plików system umożliwia ich podgląd, edycję czy dodanie podpisu elektronicznego.

Dostępne opcje w zakładce Konfiguracja:

1. Pokaż podgląd pierwszego załącznika – otwiera podgląd pierwszych załączników podczas ładowania dokumentu.
2. Podpis elektroniczny – zezwala na cyfrowe podpisywanie załączonych dokumentów.
3. OCR – umożliwia uruchomienie procesu rozpoznawania tektu na załączonym pliku.
4. Tryb galerii – wyświetla załączniki graficzne jako galerię.
5. 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 – pliki w formacie Word/Excel/PDF będą prezentowane w podglądzie wbudowanym w przeglądarkę.
• grafika – pliki Word/Excel/PDF zostaną przekonwertowane i pokazane jako grafika
• oryginalny plik i grafika.

Gdy dodajemy dowolny plik z poziomu użytkownika system liczy unikatowy hash takiego pliku i zapisuje go w bazie. Do hasha mamy dostęp przez mentionsyw atrybucie Załączników. Funkcja ta jest używana przy masowym wysyłaniu plików do KSeF.

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 typu Przycisk umożliwia wykonanie określonej akcji. Przyciski mogą być widoczne na formularzu jako pojedyncze przyciski lub jako menu. Przyciski będą również widoczne na liście dokumentów.

Przycisk musi być skonfigurowany poprzez podanie akcji w zakładce Konfiguracja. Lista dostępnych akcji znajduje się poniżej.

Dostępne opcje w konfiguracji:

• Wyświetl w nowym dokumencie – przycisk będzie widoczny w nowym, jeszcze niezapisanym dokumencie,
• Wyświetl w trybie edycji – przycisk będzie widoczny podczas edycji dokumentu,
• Wyświetl w trybie podglądu – przycisk będzie widoczny w trybie podglądu,
• Wyświetl na liście – przycisk pojawi się przy wyświetlaniu listy dokumentów. Po zaznaczeniu tej opcji pojawia si dodatkowa listy z wyborem możliwości, Opcje wyświetlania na liście
  • Zawsze – przycisk widoczny jest zawsze, niezależnie od zaznaczenia dokumentów na liście
  • Gdy zaznaczony jest jeden lub więcej elementów – przycisk jest widoczny gdy zaznaczony jest przynajmniej jeden element
  • Gdy zaznaczony jest tylko jeden element – przycisk jest widoczny gdy zaznaczony jest dokładnie jeden element
  • Gdy żaden element nie jest zaznaczony – jest widoczny gdy nie jest zaznaczony żaden dokument
• Wyrównanie – pole pojawia się dla przycisków, które nie są w grupie przycisków tylko bezpośrednio w standardowej grupie. Pozwala określić wyrównanie przycisku względem grupy. Dostępne opcje:
  • Do lewej
  • Wyśrodkuj
  • Do prawej
• Responsywność
  • Ukryj w razie potrzeby – przycisk pojawi się w zależności od rozmiaru ekranu,
  • Zawsze widoczny – przycisk zawsze będzie widoczny,
  • Zawsze ukryty – przycisk pojawi się jedynie pod przyciskiem rozszerzenia z 3 kropkami.
• Wygląd przycisku:
  • Wyróżniony – przycisk będzie wyświetlany w podstawowym kolorze systemu,
  • Podstawowy – przycisk będzie wyświetlany jako biały z obwódką w kolorze podstawowym
  • Konfigurowalny – styl zdefiniowany przez użytkownika. Można wybrać kolor tła, kolor tekstu i kolor obramowania.
• Akcja. Użytkownik otrzymuje listę możliwych akcji do wyboru.

Dostępne są następujące akcje systemowe dla przycisków. Większość z tych akcji nie potrzebuje dodatkowych parametrów. Tam, gdzie potrzebny jest jeden lub dwa parametry zostało to opisane przy akcji. Najbardziej rozbudowane akcje są dokładniej opisane pod listą.

• Dokument
  • Zapisz dokument – akcja systemowa zapisująca aktualny stan dokumentu.
  • Edytuj dokument – akcja systemowa umożliwiająca przejście do trybu edycji. Dodatkowy parametr: sposób otwarcia dokumentu – Bieżące okno lub Okno dialogowe
  • Usuń dokument – akcja systemowa umożliwiająca usunięcie bieżącego dokumentu.
  • Przywróć dokument – akcja systemowa przywracająca usunięty dokument.
  • Kopiuj dokument – akcja systemowa kopiująca bieżący dokument. Dodatkowy parametr – jaki proces uruchomić na kopii dokumentu
  • Dodaj dokument – akcja umożliwiająca utworzenie nowego dokumentu. Najbardziej rozbudowana akcja pod przyciskiem. Szczegółowy opis parametrów znajduje się pod listą
  • Następny dokument – akcja systemowa umożliwiająca przejście do następnego dokumentu na liście.
  • Poprzedni dokument – akcja systemowa umożliwiająca przejście do poprzedniego dokumentu na liście.
  • Podgląd dokumentu
  • Pokaż historię dokumentu – akcja pokazująca historię zmian w dokumencie (historia musi być włączona w sekcji ogólnej formularza).
  • Wstecz – akcja działa tak samo jak przycisk wstecz w przeglądarce internetowej i przechodzi do poprzedniej strony.
• Proces
  • Uruchom proces – akcja rozpoczynająca wybrany proces na dokumencie. Dodatkowy parametr – proces, który ma być uruchomiony
  • Zatrzymaj proces – akcja zatrzymująca uruchomiony proces na dokumencie.
  • Wznów proces – akcja wznawiająca zatrzymany proces.
  • Usuń proces – akcja anulująca uruchomiony proces.
  • Wykonaj krok procesu – akcja wykonująca ścieżkę po aktualnym oczekującym kroku w procesie. Jest to przycisk akcji systemowej, który wyświetla nazwę ieżki jako nazwę przycisku po kroku procesu. Przycisk jest widoczny tylko wtedy, gdy na zalogowanego użytkownika czeka krok na wyświetlanym dokumencie.
  • Pokaż diagram procesu – akcja wyświetlająca okno dialogowe z diagramem procesu. Kolor zielony oznacza już zakończone kroki, a pomarańczowy aktualny oczekujący krok.
• Inne
  • Przejdź do – akcja przekierowująca do innych elementów w Navigator365 (formularze, listy, formularze konfiguracyjne) lub dowolnego URL.
  • Zeskanuj kod kreskowy – akcja skanuje kod kreskowy (za pomocą kamery na urządzeniach mobilnych i tabletach), zapisuje zeskanowany tekst w wybranym polu (Element docelowy) i opcjonalnie uruchamia inny proces automatycznie.
  • Zeskanuj kod QR – akcja skanuje kod QR (za pomocą kamery na urządzeniach mobilnych i tabletach), zapisuje zeskanowany tekst w wybranym polu (Element docelowy) i opcjonalnie uruchamia inny proces automatycznie.
  • Zaloguj do Microsoft

Akcja Dodaj dokument

Użytkownik musi wybrać formularz, określić, czy proces zostanie uruchomiony automatycznie, i wybrać sam proces. Na końcu wybiera sposób otwarcia nowego dokumentu (Bieżące okno lub Okno dialogowe).

W przypadku tej akcji pojawia się dodatkowa zakładka w menu – Ustawienia dodatkowe. Działa ona podobnie jak wartość domyślna w Warunkach, pozwala na ustawienie wartości pól na nowo tworzonym dokumencie. Możemy użyć wartości statyczny a także wartości z formularza na którym osadzony jest przycisk. Dzięki temu możemy w łatwy sposób skoiować wybrane dane z formularza na nowy dokument.

Przykład użycia tej funkcji znajduje się poniżej.

Akcja Przejdź do

W konfiguracji tej akcji należy podać typ obiektu do którego chcemy przjeść: listę w systemie, dokument konfiguracyjny lub link. Element docelowy, w zależności od wybranego typu, wskazujemy wybierając listę lub formularz konfiguracyjny z listy lub wprowadzając URL. W przypadku budowania URL-a możemy skorzystać ze zmiennych środowiskowych takich jak URL aplikacji, ID aplikacji czy pól na formularzu w których może być przechowywane ID dokumentu. Ostatnim parametrem jest sposób otwarcia obiektu – w bieżącym oknie, w nowym oknie lub w oknie dialogowym.

Akcja Zaloguj do Microsoft

Dzięki tej akcji można pobrać token do uwierzytelniania w  systemach Microsoft. Token tej jest następnie używany do edycji dokumentów (Office365) czy do przesyłania plików do chmury (OneDrive).

Po wywołaniu tej akcji na formularzu pokaże się panel logowania Microsoft

Następnie postępujemy tak, jak przy zwykłym logowaniu do serwisów Microsoft. Po poprawnym zalogowaniu token zostanie pobrany i zapisany we wskazanym miejscu.

Opcje akcji:

Identyfikator aplikacji klienta – klucz wygenerowany podczas konfiguracji aplikacji w Azure

Klucz tajny klienta – wartość z konfiguracji dostawcy

Adres URL autoryzacji – adres usługi OpenID odpowiedzialnej za autoryzację

Adres URL tokena – adres usługi OpenID odpowiedzialnej za generowanie tokena

Token – atrybut na formularzu, w którym będzie przechowywany token

Zakres uprawnień – lista uprawnień które zostaną nadane aplikacji

Więcej na temat konfiguracji dostępu do AZURE można przeczytać w tym artykule: Konfiguracja AZURE

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.

W konfiguracji filtrów na listach jest przełącznik, który umożliwia przełączenie trybu konfiguracji z graficznego (drzewo) na kod. Samo rozwiązanie nie wnosi zbyt wiele w możliwości edycji gdyż tryb graficzny jest znacznie wygodniejszy ale znacząco ułatwia przenoszenie filtrów na inny wykres. Gdy skonfigurujemy skomplikowany filtr i chcemy go przenieść w inne miejsce wystarczy przełączyć się w tryb tekstowy, skopiować cały kod i wkleić go w inne miejsce. W nowym miejscu, po przełączeniu w tryb graficzny, mamy ładnie skonfigurowany filtr.

Statyczny tekst #

Pole używane do prezentowania zwykłego tekstu na dokumencie. Nie jest to prosty atrybut tekstowy gdyz użytkownik końcowy nie ma możliwości edycji tego tekstu. Tekst jest wprowadzany przez Administratora systemu w konfiguracji atrybutu i prezentuje nieedytowalne dane – tekst. Przykład użycia to opisy do pó, regulaminy do zaakceptowania, instrukcje dla użytkownika. Konfiguracja jest podobna do Listy pól z wyjątkiem zakładki Konfiguracja, gdzie wprowadzany jest tylko wyświetlany tekst. Opcja Pokaż jako zwykły tekst pozwala wprowadzić wyświetlany tekst z formacie HTML ze stylami CSS a na dokumencie pojawi się z zadanym formacie.

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.

Tabela #

Atrybut służy do budowania tabel na formularzu. Tabele są statyczne czyli możemy zdefiniować ich wysokość i szerokość na etapie tworzenia formularza ale nie możemy zmieniać tych rozmiarów na samym dokumencie. W konfiguracji możemy wskazać szerokości poszczególnych kolmn, wysokości dostosują się do zawartości.

Poszczególne komórki konfigurujemy wstawiając odpowieni adtybut z menu. Mamy jednak pewne ograniczenia – nie wszystkie atrybuty możemy dodać do tabeli. Nie zagnieździmy tabeli w tabeli, nie dodamy wykresu czy listy. Ogólnie – żadnego dużego atrybutu nie da się dodać do tabeli.

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.

Ścieżka akceptacji #

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.

Widok #

Kontrolka pokazuje aktualny widok formularza. Po przełączeniu wartości w kontrolce zmieni się widok formularza.

Proces #

Kontrolka pokazuje aktualnie uruchomiony proces. Po wyborze procesu i zapisaniu formularza proces zostanie uruchomiony.

Wynik wyszukiwania #

Ten atrybut jest ściśle powiązany z wyszukiwarką globalną. Na samym formularzu nie ma większego zastosowania więc powinien być wyłączony na standardowych widokach.

Po skonfigurowaniu aatrybutu możemy przystąpić do konfiguracji kolejnych elementów:

• Konfiguracja widoku kafelka

Tworzymy nowy widok formularza, jednak jako typ wskazujemy Widok kafelka wyszukiwania. Jest to specjalny typ widoku który jest używany w kontrolce panel wyszukiwania. Jeżeli nie mamy skonfigurowanego widoku to zostanie wyświetlony widok domyślny.

• Teraz możemy skonfigurować widok. Uwuamy niepotrzebne elementy i zostawiamy tylko te, które będą potrzebne. Należy pamiętać, że kafelek wyszukiwania ma dość małą powierzchnię więc ilość informacji należy dostosować do ilości miejsca
• Na koniec warto na standardowym widoku ukryć widok wyszukiwania gdyż ie będzie on nam do niczego potrzeby.

Atrybuty na pulpicie #

Na pulpicie moża używać dedykowanych atrybutów, których nie ma w zestawie dla zwykłych formularzy. Poniżej prezentujemy ich listę

Kafelki nawigacji #

Atrybut pokazuje kafelki aplikacji.

Panel wyszukiwania #

Atrybut służący do przeszukiwania. Służy on do prezentracji wyników działania wyszukiwarki globalnej. Nie musimy konfigurować źródeł danych – dane są pobierane z całego systemu a konfiguracja filtrów dla poszczególnych dokumentów jest ustawiana na konfiguracji formularza.

Na formularzu wyszukiwarka prezentuje się tak:

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.