Szablony
Szablon (ang. template) jest plikiem definiującym wygląd docelowego pliku, który ma zostać wygenerowany w systemie. W zależności o wybranego mechanizmu generowania dokumentów może to być plik docx (DocToPdf), pdf (XfdfToPDF) lub xml (FopToPDF).
Po wybraniu z menu opcji Nowy szablon -flow lub Nowy szablon - prosty model danych na ekranie mamy następujący ekran:
Pierwszym krokiem tworzenia nowego szablonu jest:
- podanie unikalnej nazwy
- wybór mechanizmu generowania dokumentów/wysyłki maili. W tym przypadku mamy następujące możliwości do wyboru:
- DOC to PDF - konwersja szablonu word na plik pdf - FOP to PDF - konwersja szablonu xslt na plik pdf - XDFDF to PDF - wypełnienie danymi pliku pdf z formularzami - send email - wysyłka maili - DOC to PDF - wypełnienie danymi szablonu word
- podanie pliku szablonu zgodnego z podanym powyżej mechanizmem
Po wypełnieniu danych wybieramy przycisk Dalej i przechodzimy do kroku drugiego.
W przypadku tworzenia szablonu z prostym modelem danych krok ten jest pomijany. W takim wypadku wraz z utworzonym szablonem powiązany zostaje domyślny model danych. Model ten nie definiuje struktury danych, które mogą znaleźć się w danych wejściowych. W efekcie jako źródło można podać dowolny zestaw danych. Jeśli jednak w szablonie zostanie wykorzystane pole, które nie zostanie podane w danych wejściowych to w efekcie może pojawić się błąd podczas tworzenie szablonu lub wysyłki maili.
W przypadku tworzenia szablonu z wykorzystaniem opcji Nowy szablon -flow podczas tworzenia szablonu definiowany jest również model danych opisujący strukturę danych wejściowych. Struktura ta definiuje jakie pola powinny zawierać dane wejściowe (np. data umowy, marka pojazdu) oraz jaki format powinny mieć (np. tekstowy, liczbowy). Model ten tworzony jest automatycznie na podstawie przykładowych danych wejściowych, które podawane są w kroku drugim. Przykładowe dane wejściowe mogą zostać podane jako plik excel, xml lub json. Podczas definiowania można podać swoją nazwę modelu lub też pozostawić automatycznie wygenerowaną.
Po wypełnieniu danych wybieramy przycisk Dalej i przechodzimy do kroku trzeciego - podsumowanie
W tym miejscu mamy do wyboru następujące opcje:
Zapisać szablon Cofnąć proces tworzenie do kroku wcześniej (w przypadku szablonu z prostym modelem danych opcja ta jest niedostępna) Zresetować proces tworzenia - akcja ta wiąże się z usunięciem wszelkich dotychczasowych danych procesu
Krok ten ma za zadanie sprawdzenie zgodności wybranego źródła danych oraz szablonu.
Poniżej zamieszczone zrzuty ekranu prezentują stronę podsumowania przeprowadzenia procesu walidacji w dwóch przypadkach:
poprawnego wykonania
oraz znalezienia niezgodności między szablonem, a źródłem danych nowo - dodawanego zadania.
Z poziomu tej strony i w przypadku prawidłowej walidacji zadania możliwe są następujące akcje:
Przejście na podsumowanie - w przypadku nie wykrycia błędów
Przerwanie procesu tworzenia i powrót na listę istniejących zadań - w przypadku pojawienia się błędów w walidacji
Jeżeli wszystko zostało poprawnie zdefiniowane i walidacja zakończyła się sukcesem to możemy przejść do kroku trzeciego - podsumowanie. Wówczas na ekranie zostanie wyświetlony poniższy ekr
Ostatnią stroną procesu tworzenia zadania jest strona jego podsumowania. Z tej strony możemy wykonać następujące operacje:
- Zapisać zadanie
- Zapisać oraz zlecić jego procesowanie
- Przerwać proces tworzenia - akcja ta wiąże się z usunięciem wszelkich dotychczasowych danych procesu
- Podejrzeć rezultat generowania dokumentu (więcej na stronie Podgląd dokumentu)
Po wybraniu z menu opcji Lista zadań na ekranie wyświetlona zostaje następująca lista:
Opcja Szukaj umożliwia nam wyszukiwanie tekstu w wyświetlanej na ekranie tabeli. W celu wyszukania określonego ciągu znaków w okienko wpisujemy wyszukiwany tekst i akceptujemy ENTEREM. Jak chcemy powrócić do pełnej listy w okienku Szukaj musimy mieć pusto i akceptujemy ENTEREM.
Na liście mamy następujące informacje:
Id - jednoznaczny identyfikator źródła danych
Utworzono - data i godzina utworzenia źródła danych
Zmodyfikowano - data i godzina ostatniej modyfikacji
Nazwa szablonu - nazwa szablonu, w którym zapisany jest model danych
Nazwa pliku - nazwa pliku
Nazwa magazynu - nazwa magazynu
W kolumnie Akcje możemy wybrać opcję Pokaż. Wówczas na ekranie wyświetlone zostaną poniższe dane:
W tym momencie mamy do wyboru następujące operacje: xxx - Po wybraniu z menu opcji Lista wyników zadania na ekranie wyświetlona zostaje następująca lista:
ArthurDoc Podręcznik użytkownika
ArthurDoc Podręcznik administratora