Atrybuty podstawowe

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. W zakładce „Wygląd” dostępna jest opcja „Domyślnie jeden wiersz”, dzięki której pole startuje o wysokości jednego wiersza i rozszerza się w trakcie wpisywania tekstu – przydatne w tabelach i listach.

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 tekstu 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 mentions w 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 grupy przycisków. Przycisk można wstawić w dowolnym miejscu formularza, w górnym pasku oraz w nagłówku grupy. Przyciski dodane w górnym pasku formularza mogą być 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 lista 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.
• Sposób otwarcia dokumentu – Określa, w jaki sposób dokument zostanie otwarty po wykonaniu akcji. Dostępne tylko dla akcji Dodaj dokument, Pokaż pulpit i Edytuj dokument. Dostępne opcje:
• Bieżące okno – otwiera dokument w bieżącym oknie, zastępując aktualny widok.
• Okno dialogowe – otwiera dokument w oknie dialogowym nad bieżącym widokiem, które można zamknąć, aby wrócić do poprzedniego miejsca.
• Panel boczny – otwiera dokument w panelu bocznym obok bieżącego widoku, dzięki czemu można pracować bez opuszczania aktualnego ekranu.
• Brak – tworzy dokument w tle bez jego otwierania. Dostępne tylko dla akcji Dodaj dokument, zwykle używane, gdy dokument jest dodawany do listy dokumentów powiązanych.
• 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 – Zapisuje zmiany wprowadzone w bieżącym dokumencie.
• Edytuj dokument – Przełącza bieżący dokument w tryb edycji, umożliwiając modyfikację jego danych. Można wybrać sposób otwarcia dokumentu (np. bieżące okno lub okno dialogowe).
• Usuń dokument – Usuwa bieżący dokument, przenosząc go do kosza.
• Przywróć dokument – Przywraca wcześniej usunięty dokument z kosza.
• Kopiuj dokument – Tworzy nowy dokument na podstawie kopii danych bieżącego dokumentu. Można wskazać proces, który zostanie uruchomiony na kopii.
• Dodaj dokument – Tworzy nowy dokument na podstawie wybranego formularza. Można określić, czy proces uruchomi się automatycznie i który, sposób otwarcia nowego dokumentu oraz w ustawieniach dodatkowych wstępnie wypełnić wybrane pola wartościami stałymi lub skopiowanymi z bieżącego dokumentu.
• Następny dokument – Przechodzi do następnego dokumentu na liście.
• Poprzedni dokument – Przechodzi do poprzedniego dokumentu na liście.
• Podgląd dokumentu – Otwiera bieżący dokument w trybie podglądu tylko do odczytu.
• Pokaż historię dokumentu – Wyświetla historię zmian bieżącego dokumentu. Wymaga włączonej historii dokumentu w ustawieniach ogólnych formularza.
• Dodaj relację do dokumentu – Umożliwia powiązanie bieżącego dokumentu z innymi dokumentami.
• Usuń relację do dokumentu – Umożliwia usunięcie powiązań bieżącego dokumentu do zaznaczonych na wskazanej liście dokumentów.
• Wstecz – Powraca do poprzedniej strony, działając tak samo jak przycisk wstecz w przeglądarce.
• Proces
• Uruchom proces – Uruchamia wybrany proces na bieżącym dokumencie.
• Wstrzymaj proces – Wstrzymuje aktualnie uruchomiony proces.
• Wznów proces – Wznawia wcześniej wstrzymany proces.
• Usuń proces – Anuluje proces uruchomiony na bieżącym dokumencie.
• Wykonaj krok procesu – Wykonuje ścieżkę po aktualnie oczekującym kroku procesu. Przycisk wyświetla nazwę ścieżki i jest widoczny tylko wtedy, gdy na zalogowanego użytkownika czeka krok na wyświetlanym dokumencie.
• Pokaż diagram procesu – Wyświetla okno dialogowe z diagramem procesu. Kolor zielony oznacza zakończone kroki, a pomarańczowy aktualnie oczekujący krok.
• Inne
• Przejdź do – Przekierowuje do innych elementów (formularze, listy, formularze konfiguracyjne) lub dowolnego adresu URL. Można wybrać sposób otwarcia obiektu (bieżące okno, nowe okno lub okno dialogowe).
• Pokaż pulpit – Otwiera wybrany pulpit.
• Zeskanuj kod kreskowy – Skanuje kod kreskowy (za pomocą kamery na urządzeniach mobilnych i tabletach), zapisuje zeskanowany tekst w wybranym polu i opcjonalnie może automatycznie uruchomić inny proces.
• Zeskanuj kod QR – Skanuje kod QR (za pomocą kamery na urządzeniach mobilnych i tabletach), zapisuje zeskanowany tekst w wybranym polu i opcjonalnie może automatycznie uruchomić inny proces.
• Zaloguj do Microsoft – Pobiera token do uwierzytelniania w systemach Microsoft, używany następnie do edycji dokumentów (Office365) lub przesyłania plików do chmury (OneDrive).
• Sprawdź połączenie konta email – Sprawdza połączenie ze skonfigurowanym kontem e-mail.

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 skopiować 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 przejść: 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 ten 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 (wielokrotność lub w px).

Formatowanie wartości podczas wprowadzania

Pola tekstowe i liczbowe mogą korzystać z masek formatujących wartość w czasie pisania, np. numer NIP lub rachunku bankowego. Konfiguracja maski określa format i walidację, a do bazy trafia wartość bez znaków formatujących.

Przy projektowaniu formularza sprawdź, czy maska pasuje do danych, które będą wprowadzali użytkownicy. Nie zastępuje ona pozostałych warunków wymagalności i walidacji.

Obsługę załączników od strony użytkownika opisuje artykuł Załączniki i odczytywanie tekstu.