Co to jest formularz? #
Formularz to podstawowy zbiór grup i atrybutów skonfigurowanych i uporządkowanych w celu wizualizacji dokumentu. W Navigator365 wszystko zaczyna się od formularza. Nawet użytkownik jest zbudowany na formularzu. Formularz składa się z atrybutów takich jak tekst, liczba całkowita, data, atrybuty wyboru, wykresy, grupy i pola systemowe.
W Navigator365 można projektować i konfigurować formularze za pomocą edytora wizualnego. Po dwukrotnym kliknięciu elementu po prawej stronie pojawi się sidenav (interfejs) z konfiguracją.
Rodzaje formularzy #
W Navigator365 dostępnych jest kilka rodzajów formularzy.
Formularz #
Standardowa opcja tworzenia formularza używanego do pracy z dokumentami. Na podstawie formularza można utworzyć kilka instancji dokumentu.
Widok #
Specjalna definicja formularza, która jest mocno powiązana ze standardowym formularzem. Za pomocą widoku można skonfigurować inny wygląd dokumentu. Dokumenty utworzone zarówno na widoku jak i formularzu są traktowane przez system tak samo, np. standardowo są wyświetlane na tej samej liście. Podczas dodawania widoku formularza należy wybrać już istniejący formularz, aby oprzeć na nim nowy widok.
Pulpit (dashboard) #
Formularz, który służy do wyświetlania informacji, jest zazwyczaj główną stroną docelową aplikacji. Dashboard przeważnie zawiera listy dokumentów, przyciski czy wykresy ułatwiające nawigację. Tworzenie dashboardu jest podobne do tworzenia zwykłego formularza, jednak wymaga więcej uwagi dla grup, aby zaprojektować pożądany wygląd i lepszy UX.
Atrybut złożony #
Ten rodzaj formularza służy do tworzenia złożonych atrybutów. Na przykład, jeśli potrzebujesz kontrolki do wyświetlania adresów, które zawierają pola takie jak ulica, miasto czy kod pocztowy możesz zbudować atrybut złożony, który zawiera wszystkie takie pola i wstawić je do zwykłego formularza. Takie atrybuty mogą być używane w wielu formularzach, dzięki czemu można je zbudować raz i używać wiele razy.
Konfiguracja #
Ten typ dokumnetu wygląda jak zwykły formularz ze wszystkimi atrybutami, ale różnica polega na tym, że można na jego podstawie utworzyć tylko jeden dokument. Przewaga tego formularza polega na tym, że ten dokument może być użyty jako formularz konfiguracyjny dla aplikacji. Korzystając z mechanizmu wzmianek (@mentions) można łatwo odwoływać się do pól w takich dokumentach. Na przykład, jeśli potrzebujesz stawki godzinowej, możesz dodać takie pole w formularzu konfiguracyjnym i użyć go do obliczenia kosztu na każdym dokumencie w aplikacji a nawet całym systemie. „Formularz ustawień globalnych systemu” jest dobrym przykładem. Taki formularz konfiguracyjny jest tylko jeden i przechowuje wszystkie ustawienia systemu Navigator365. Jest on jednak zbudowany tak samo jak standardowy formularz z atrybutami.
Tworzenie formularza #
Aby utworzyć nowy formularz należy podać jego nazwę oraz typ, który ustawiony jest domyślnie na Formularz. Można go zmienić, jeśli chcemy utworzyć widok formularza, atrybut złożony, dashboard lub formularz konfiguracyjny. Po wpisaniu nazwy formularza można nacisnąć przycisk Zapisz, aby utworzyć nowy formularz.
Konfiguracja formularza (ustawienia) #
W pierwszej zakładce – Ustawienia – oprócz Typu i Nazwy formularza znajduje się kilka innych opcji.
Warto wspomnieć, że w każdej chwili można zmienić nazwę formularza, ale nie można zmienić jego typu.
Pozostałe opcje:
Form guid – pole tylko do odczytu, w którym wyświetlany jest GUID – unikalny identyfikator, dostępny po zapisaniu nowego formularza. Każdy obiekt w Navigator365 jest identyfikowany w bazie danych za pomocą tego pola. Można go użyć do napisania złożonego zapytania SQL.
Opis formularza – w tym miejscu można wpisać krótki opis . Informacje te są dostępne tylko w konfiguracji formularza, a więc tylko dla administratorów aplikacji.
Opcje układu etykiet – jest to domyślna konfiguracja warstwy etykiet. Możesz zmienić tę opcję na każdym elemencie formularza, ale jeśli tego nie zrobisz, będzie ona identyczna z tą. Dostępne są trzy opcje:
Układ 2-kolumnowy: etykieta znajduje się po lewej stronie elementu.
Układ 1-kolumnowy: Etykieta znajduje się na górze elementu.
Etykieta po prawej stronie: Jest to układ podobny do 2-kolumnowego, ale z etykietą po prawej stronie. Ta opcja jest używana głównie w przypadku atrybutów, takich jak pola wyboru, gdzie atrybut znajduje się po lewej stronie, a etykieta po prawej.
Opcje historii dokumentu – za pomocą tej opcji można zdecydować, ile danych będzie przechowywanych w historii dokumentu. Historia dokumentu będzie rejestrować wszystkie informacje o utworzeniu i modyfikacji pisma.
Brak: historia dokumentu nie będzie przechowywana
Wszystkie zmiany: wszystkie zmiany wprowadzone w dokumencie zostaną zapisane.
Ostatnia zmiana: zapisana zostanie tylko ostatnia zmiana.
Dostępność elementów – w Navigator365 formularze są przypisane do aplikacji i domyślnie nie mogą być używane poza tą aplikacją. Jeśli istnieje potrzeba użycia formularza w innej aplikacji, należy zmienić tę opcję. Dostępne są trzy warianty:
Prywatny: formularz może być używany tylko w tej aplikacji (domyślnie).
Publiczny: formularz może być używany we wszystkich aplikacjach, nawet tych utworzonych w przyszłości.
Współdzielony z aplikacjami: najbardziej powszechna i zalecana opcja ze względów bezpieczeństwa. Możesz określić listę aplikacji, w których ten formularz będzie dostępny. Zauważ, że jeśli później dodasz nową aplikację i chcesz użyć w niej tego formularza, musisz udostępnić go nowej aplikacji.
Zakładka Formularz #
W tej zakładce znajduje się wizualny edytor formularza. Po lewej stronie znajduje się pasek narzędzi zawierający wszystkie atrybuty, które można dodać do formularza. Szczegółowy opis atrybutów można znaleźć w innym artykule. Zauważ, że niektóre atrybuty można dodać do formularza tylko raz (atrybuty systemowe). Należy pamiętać, że istnieje ograniczenie liczby atrybutów w bazie danych. Większość z nich może być dodana tylko 25 razy na jednym formularzu. Wyjątkami są Liczba całkowita – 75, Liczba zmiennoprzecinkowa – 75, Pole wyboru – 35, Pole tekstowe – 100, Pole wielowierszowe – 50.
Uprawnienia #
Tutaj można określić uprawnienia do dokumentów stworzonych na podstawie tego formularza. Oczywiście istnieje opcja, by dodać uprawnienia do każdego dokumentu osobno, konfiguracja z poziomu tego formularza będzie po prostu domyślna dla wszystkich dokumentów.
Istnieje kilka rodzajów uprawnień: Odczyt, Dodawanie, Edycja i Pełna kontrola.
- Uprawnienie do dodawania – użytkownicy lub grupy użytkowników, którzy mogą dodawać nowe dokumenty,
- Uprawnienie do pełnej kontroli – użytkownicy lub grupy, którzy mogą modyfikować i usuwać dokumenty,
- Uprawnienie do edycji – użytkownicy lub ich grupy, którzy mogą modyfikować dokumenty,
- Uprawnienie do odczytu – użytkownicy lub grupy, którzy mogą przeglądać dokumenty tylko w trybie do odczytu.
Grupy czy użytkowników można wybierać z list rozwijanych, które są przypięte do każdej opcji.
Nieco poniżej znajduje się sekcja ze specjalnymi uprawnieniami dla użytkownika, który jest twórcą dokumentu na podstawie tego formularza.
Twórca może mieć pełny dostęp do dokumentu (opcja Pełny dostęp) – co oznacza, że będzie w stanie zarówno edytować, jak i usuwać dokument w przyszłości. Twórca może mieć dostęp tylko do edycji (Edycja), tylko do odczytu (Tylko do odczytu) lub w ogóle nie korzystać z dokumentu po jego utworzeniu (Brak dostępu).
Ważne jest, aby wiedzieć, że uprawnienia są ustawiane na wielu poziomach w systemie Navigator365. Można dowiedzieć się o nich więcej w tym artykule.
Ustawienia widoku #
W zakładce „Ustawienia widoku” można zdefiniować rodzaj dostępu do określonego atrybutu dla użytkownika formularza.
Istnieje kilka rodzajów dostępu: Widoczny, Edytowalny i Wymagany. Oczywiście można to zmienić, definiując warunki w formularzu lub w procesie obiegu.
- Widoczny: użytkownik może zobaczyć atrybut, ale nie może zmienić jego zawartości.
- Edytowalny: użytkownik może zobaczyć atrybut i edytować jego zawartość. Zaznaczenie tej opcji spowoduje automatyczne zaznaczenie pola wyboru „Widoczny”.
- Wymagany: podobnie jak w opcji „Edytowalny”, ale dodatkowo dokument nie zostanie zapisany, jeśli użytkownik pozostawi to pole puste.
Jak zauważyłeś, są tutaj atrybuty, które zostały utworzone w zakładce „Formularz”. Wszystkie pola są domyślnie ustawione na „Widoczne”.
Dostęp do każdego atrybutu można zmienić w ustawieniach atrybutów (więcej informacji na ten temat można znaleźć w tym artykule) oraz w procesach wewnątrz ustawień widoku na ścieżkach. Więcej o procesach można przeczytać tutaj.
API #
Interfejs programowania aplikacji (API) to sposób, w jaki dwa lub więcej programów komputerowych komunikuje się ze sobą.
W tej zakładce można znaleźć i ustawić kody atrybutów potrzebne do utworzenia interfejsu API. Kody atrybutów muszą być unikalne, w przeciwnym razie interfejs API nie będzie działać poprawnie. Dlatego system sprawdza kody atrybutów i wysyła odpowiedni komunikat o błędzie. System automatycznie generuje unikalny zestaw atrybutów dla każdego formularza.
Kod API może być użyty na przykład w wywołaniu akcji Rest API w procesie workflow lub z innego systemu.
Zależności #
W zakładce „Zależności” można sprawdzić, czy formularz jest używany w innych widokach formularzy, listach i procesach. Należy pamiętać, że jeśli jest on używany w innym miejscu, nie można go usunąć, aplikacja powiadomi o tym odpowiednim komunikatem. Najpierw należy usunąć go z elementów zależnych. Niżej można również sprawdzić, jakie procesy czy listy są używane w tym formularzu.
Możesz kliknąć każdą zależność i wyświetlić ją w wyskakującym okienku.