Przejdź do zawartości

Wytyczne przygotowania szablonów: Różnice pomiędzy wersjami

Z Primesoft Wiki
Primesoft (dyskusja | edycje)
Nie podano opisu zmian
Primesoft (dyskusja | edycje)
Nie podano opisu zmian
Linia 1: Linia 1:
= DOC to PDF =
= DOC/PDF =


Nazwę pola, które ma zostać zaczytane z pliku z danymi wejściowymi wpisujemy poprzedzając znakiem $ a nazwę kolumny w tabeli źródłowej wpisujemy w nawiasach klamrowych.
== Wstęp ==


Przykład:
<nowiki>${Nazwa_firmy}</nowiki>


'''UWAGA!!! W nazwie kolumn nie stosujemy polskich znaków i spacji!!!'''


W systemie zostały zaimplementowane dodatkowe funkcje umożliwiające odpowiednie formatowanie danych. Opis funkcji dostępny pod adresem: [[DocToPdf - wbudowane funkcje]]
== FAQ ==


Przykładowe szablony wraz z danymi wejściowymi znajdują się pod podanymi poniżej adresami:
=== 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]]
=== Nie widzę tekstu 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:


1.1. Faktura


szablon - [https://wiki.arthurdoc.com/wiki/images/f/f3/Invoice_example.docx Faktury - Szablon]
== Przykłady ==


dane źródłowe - [https://wiki.arthurdoc.com/wiki/images/4/45/Invoice_example.xlsx Faktury - Dane źródłowe]
Przykładowe szablony wraz z danymi wejściowymi znajdują się pod podanymi poniżej adresami:
 
=== Faktura ===
1.2. List
szablon - [https://wiki.arthurdoc.com/wiki/images/f/f3/Invoice_example.docx Faktury Szablon]
dane źródłowe - [https://wiki.arthurdoc.com/wiki/images/4/45/Invoice_example.xlsx Faktury Dane źródłowe]


szablon - [https://wiki.arthurdoc.com/wiki/images/5/5e/Letter_example.docx List - Szablon]
===List===


dane źródłowe - [https://wiki.arthurdoc.com/wiki/images/7/7d/Letter_example.xlsx List - Dane źródłowe]
szablon - [https://wiki.arthurdoc.com/wiki/images/5/5e/Letter_example.docx List Szablon]
dane źródłowe - [https://wiki.arthurdoc.com/wiki/images/7/7d/Letter_example.xlsx List Dane źródłowe]


1.3. Umowa
===Umowa===
szablon - [https://wiki.arthurdoc.com/wiki/images/3/36/Statement_of_work_example.docx Umowy Szablon]
dane źródłowe - [https://wiki.arthurdoc.com/wiki/images/9/91/Statement_of_work_example.xlsx Umowy Dane źródłowe]


szablon - [https://wiki.arthurdoc.com/wiki/images/3/36/Statement_of_work_example.docx Umowy - Szablon]
= FOP TO PDF =


dane źródłowe - [https://wiki.arthurdoc.com/wiki/images/9/91/Statement_of_work_example.xlsx Umowy - Dane źródłowe]
== Wstęp ==


= 2. FOP TO PDF =
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 '''[https://xmlgraphics.apache.org/fop/fo.html The Apache™ FOP Project]]'''
== Przykłady ==


szablon - [https://wiki.arthurdoc.com/wiki/images/4/45/Invoice_example.xlsx Rachunek - Szablon]
Typ szablonu


dane źródłowe - [https://gitlab.primesoft.pl/gdk/gdk_api_foptopdf/-/blob/master/src/main/resources/template_examples/invoice_example_fop.xsl Rachunek - Dane źródłowe]
szablon - [https://wiki.arthurdoc.com/wiki/images/4/45/Invoice_example.xlsx Rachunek Szablon]
dane źródłowe - [https://gitlab.primesoft.pl/gdk/gdk_api_foptopdf/-/blob/master/src/main/resources/template_examples/invoice_example_fop.xsl Rachunek Dane źródłowe]

Wersja z 4 sie 2023, 15:09

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

Nie widzę tekstu 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:


Przykłady

Przykładowe szablony wraz z danymi wejściowymi znajdują się pod podanymi poniżej adresami:

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

Typ szablonu

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