Wytyczne przygotowania szablonów: Różnice pomiędzy wersjami
| Linia 12: | Linia 12: | ||
=== Czy szablon DOC/PDF pozwala na instrukcje warunkowe === | === 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]] | 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: | 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: | ||
[[Plik:Czcionki wbudowane.png|600x300px|ramka|centruj|alt=Konfiguracja programu MS Word - osadzenie czcionek w szablonie]] | [[Plik:Czcionki wbudowane.png|600x300px|ramka|centruj|alt=Konfiguracja programu MS Word - osadzenie czcionek w szablonie]] | ||
| Linia 18: | Linia 18: | ||
[[Plik:Czcionki wbudowane-opcje.png|600x300px|ramka|centruj|alt=Konfiguracja programu MS Word - menu Opcje]] | [[Plik:Czcionki wbudowane-opcje.png|600x300px|ramka|centruj|alt=Konfiguracja programu MS Word - menu Opcje]] | ||
Dopiero tak przygotowany szablon *.docx wgrywany do systemu ArthurDoc. | 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 '''(1)''', natomiast test szablonu bazujący na przykładowych danych wykonujemy korzystając z opcji '''(2)''' | |||
== Przykłady == | == Przykłady == | ||
Wersja z 4 sie 2023, 15:37
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:
Opcja dostępna w menu Plik pozycja Opcje jak niżej:
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 (1), natomiast test szablonu bazujący na przykładowych danych wykonujemy korzystając z opcji (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