Wytyczne przygotowania szablonów

DOC/PDF

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:

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

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

System domyślnie (bez konieczności osadzania) obsługuje poniżej zamieszczona listę czcionek. W przypadku jeżeli czcionka wykorzystana w szablonie nie zostanie osadzona w dokumencie i jednoczenie nie występuje na wykazie, wówczas, jeżeli jest to możliwe system stara się dopasować czcionkę z listy czcionek wbudowanych.

Nazwa czcionki	Styl (Szerokość/Kursywa)	Rodzina / Uwagi
Abyssinica SIL	Regular	SIL Open Font
Aharoni CLM	Bold / Bold Oblique / Book / Book Oblique	CLM Project
Amiri	Regular / Bold / Slanted / Bold Slanted	Arabski klasyczny
Amiri Quran	Regular / Colored	Specjalna (Koran)
Andale Mono	Regular	Monospace
Ani	Domyślny	-
AR PL UKai	Book (CN / HK / TW)	CJK (Szeryfowe)
AR PL UMing	Light (CN / HK / TW)	CJK (Bezszeryfowe)
Arial	Regular / Bold / Italic / Bold Italic	Standard (Microsoft)
Arial Black	Regular	Standard (Microsoft)
Caladea	Regular / Bold / Italic / Bold Italic	Kompatybilna z Cambria
Carlito	Regular / Bold / Italic / Bold Italic	Kompatybilna z Calibri
Comic Sans MS	Regular / Bold	Styl odręczny
Courier New	Regular / Bold / Italic / Bold Italic	Maszynowy
David CLM	Medium / Medium Italic / Bold / Bold Italic	Hebrajski
DejaVu Sans	Book / Bold / Oblique / Bold Oblique	Szeroka obsługa Unicode
DejaVu Sans Mono	Book / Bold / Oblique / Bold Oblique	Programistyczna
DejaVu Serif	Book / Bold / Italic / Bold Italic	Szeryfowa
Frank Ruehl CLM	Medium / Medium Oblique / Bold / Bold Oblique	Hebrajski
Garuda	Regular / Bold / Oblique / Bold Oblique	Tajski
Gentium Basic	Regular / Bold / Italic / Bold Italic	Szeryfowa
Georgia	Regular / Bold / Italic / Bold Italic	Szeryfowa (Microsoft)
Impact	Regular	Nagłówkowa
Liberation Mono	Regular / Bold / Italic / Bold Italic	Zamiennik Courier
Liberation Sans	Regular / Bold / Italic / Bold Italic	Zamiennik Arial
Liberation Serif	Regular / Bold / Italic / Bold Italic	Zamiennik Times
Linux Libertine O	Regular / Bold / Italic / Semibold / Mono	Typografia profesjonalna
Loma	Regular / Bold / Oblique / Bold Oblique	Tajski
Noto Sans	Regular / Bold / Italic / Bold Italic	Obsługa "No Tofu" (Global)
Noto Sans CJK	Regular / Bold (HK / JP / KR / SC / TC)	Azjatyckie (Chiny/Jap/Kor)
Noto Serif	Regular / Bold / Italic / Bold Italic	Szeryfowa (Global)
Sawasdee	Regular / Bold / Oblique / Bold Oblique	Tajski / Ozdobny
Times New Roman	Regular / Bold / Italic / Bold Italic	Standardowa szeryfowa
Tlwg Mono	Regular / Bold / Oblique / Bold Oblique	Tajski (Monospace)
Trebuchet MS	Regular / Bold / Italic / Bold Italic	Bezszeryfowa (Microsoft)
Umpush	Regular / Bold / Light / Oblique	Tajski
Verdana	Regular / Bold / Italic / Bold Italic	Ekranowa (Microsoft)
Webdings	Regular	Symbole

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ł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