Przejdź do zawartości

Wytyczne przygotowania szablonów

Z Primesoft Wiki

DOC/PDF

Wstęp

FAQ

Jak zapisywać zmienne w szablonie

Szablony DOC/FOP bazują na plikach w formacie *.docx. Pola dynamiczne w tak przygotowanym szablonie należy zapisać poprzedzając nazwę pola znakiem $ a nazwę kolumny w danych źródłowych wpisujemy w nawiasach klamrowych np.: ${Nazwa_firmy}. Ważne również, aby w nazwie kolumny nie stosować polskich znaków i spacji.

Czy szablon DOC/PDF pozwala na instrukcje warunkowe

Tak jest to jedna z wielu możliwości wbudowanych w ramach szablonów DOC/PDF. Przygotowany w systemie ArthurDoc silnik transformat pozwala nie tylko na dodanie instrukcji warunkowych (typu jeżeli, wykonaj dla wszystkich) lecz również na obróbkę danych (np. zapisanie liczny jako tekst, sformatowanie daty itp). Opis wszystkich przygotowanych funkcji znajduje się w artykule DocToPdf - wbudowane funkcje

Tekst nie jest widoczny po przegenerowaniu dokumentu do formatu PDF (Wykorzystanie niestandardowych czcionek)

W przypadku jeżeli w szablonie dokumentu w formacie *.docx widoczny jest tekst natomiast po wykorzystaniu szablonu i przedruku dokumentu do formatu PDF tekst nie jest widoczny najprawdopodobniej problem jest związany z brakiem wybranej czcionki w silniku przedruku uzupełnionego dokumentu do formatu PDF. W przypadku wystąpienia wyżej opisanego problemu zaleca się, przed zapisaniem szablonu w natywnym programie tj. Microsoft Word, wymuszenie osadzenie czcionek w dokumencie jak niżej:

Konfiguracja programu MS Word - osadzenie czcionek w szablonie

Opcja dostępna w menu Plik pozycja Opcje jak niżej:

Konfiguracja programu MS Word - menu Opcje

Dopiero tak przygotowany szablon *.docx wgrywany do systemu ArthurDoc.

Jak szybko testować szablony

Aby przyspieszyć fazę testowania/przygotowania szablonu zaleca się wgranie do systemu AthurDoc przykładowych danych przypisanych do danego szablonu. Rozwiązanie pozwala na wygenerowanie przykładowego pliku bez konieczności każdorazowego definiowania Zadań. Podczas generowania dokumentu wykorzystując plik z przykładowymi danymi system korzysta zawsze z pierwszego rekordu definiującego dokument. Jako przykładowe dane możliwe jest wgranie pliku JSON, XLSX lub XML. Wgranie przykładowych danych dostępne jest na ekranie Edycji szablonu patrz: (1), natomiast test szablonu bazujący na przykładowych danych wykonujemy korzystając z opcji Walidacja przykładowymi danymi patrz: (2)

Przykładowe dane - szybkie testowanie szablonu

Przykłady

Przykładowe szablony wraz z danymi wejściowymi

Faktura

szablon - Faktury Szablon dane źródłowe - Faktury Dane źródłowe

List

szablon - List Szablon dane źródłowe - List Dane źródłowe

Umowa

szablon - Umowy Szablon dane źródłowe - Umowy Dane źródłowe

FOP TO PDF

Wstęp

Szablony FOP TO PDF bazuje na języku/transformacie FOP (Formatting Objects Processor), która na podstawie pliku XSL-FO (XSL Formatting Objects) oraz silnika graficznego pozwala szybkie wygenerowanie dokumentu w formacie PDF. Szczegółowy opis możliwości transformaty XSL-FO znajduje sie na stronie projektu The Apache™ FOP Project]

Przykłady

Przykładowe szablony wraz z danymi wejściowymi

Rachunek

szablon - Rachunek Szablon dane źródłowe - Rachunek Dane źródłowe