Primesoft Wiki - Wkład użytkownika [pl]

Wytyczne przygotowania szablonów

2026-04-27T13:23:26Z

Primesoft: /* Tekst nie jest widoczny po przegenerowaniu dokumentu do formatu PDF (Wykorzystanie niestandardowych czcionek) */

= 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:
[[Plik:Czcionki wbudowane.png|600x300px|ramka|centruj|alt=Konfiguracja programu MS Word - osadzenie czcionek w szablonie]]
Opcja dostępna w menu ''Plik'' pozycja ''Opcje'' jak niżej:
[[Plik:Czcionki wbudowane-opcje.png|600x300px|ramka|centruj|alt=Konfiguracja programu MS Word - menu Opcje]]

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.
{| style="border-collapse: collapse; width: 916px; height: 982px;" border="1px" data-path-to-node="3" < thead>
|- style="height: 30px;"
! style="height: 23px; width: 261.275px;" | '''Nazwa czcionki'''
! style="height: 23px; width: 351.375px;" | '''Styl (Szerokość/Kursywa)'''
! style="height: 23px; width: 297.35px;" | '''Rodzina / Uwagi'''
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Abyssinica SIL
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | SIL Open Font
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Aharoni CLM
| style="height: 23px; width: 351.375px;" | Bold / Bold Oblique / Book / Book Oblique
| style="height: 23px; width: 297.35px;" | CLM Project
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Amiri
| style="height: 23px; width: 351.375px;" | Regular / Bold / Slanted / Bold Slanted
| style="height: 23px; width: 297.35px;" | Arabski klasyczny
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Amiri Quran
| style="height: 23px; width: 351.375px;" | Regular / Colored
| style="height: 23px; width: 297.35px;" | Specjalna (Koran)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Andale Mono
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | Monospace
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Ani
| style="height: 23px; width: 351.375px;" | Domyślny
| style="height: 23px; width: 297.35px;" | -
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | AR PL UKai
| style="height: 23px; width: 351.375px;" | Book (CN / HK / TW)
| style="height: 23px; width: 297.35px;" | CJK (Szeryfowe)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | AR PL UMing
| style="height: 23px; width: 351.375px;" | Light (CN / HK / TW)
| style="height: 23px; width: 297.35px;" | CJK (Bezszeryfowe)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Arial
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Standard (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Arial Black
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | Standard (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Caladea
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Kompatybilna z Cambria
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Carlito
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Kompatybilna z Calibri
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Comic Sans MS
| style="height: 23px; width: 351.375px;" | Regular / Bold
| style="height: 23px; width: 297.35px;" | Styl odręczny
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Courier New
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Maszynowy
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | David CLM
| style="height: 23px; width: 351.375px;" | Medium / Medium Italic / Bold / Bold Italic
| style="height: 23px; width: 297.35px;" | Hebrajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | DejaVu Sans
| style="height: 23px; width: 351.375px;" | Book / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Szeroka obsługa Unicode
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | DejaVu Sans Mono
| style="height: 23px; width: 351.375px;" | Book / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Programistyczna
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | DejaVu Serif
| style="height: 23px; width: 351.375px;" | Book / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Szeryfowa
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Frank Ruehl CLM
| style="height: 23px; width: 351.375px;" | Medium / Medium Oblique / Bold / Bold Oblique
| style="height: 23px; width: 297.35px;" | Hebrajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Garuda
| style="height: 23px; width: 351.375px;" | Regular / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Tajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Gentium Basic
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Szeryfowa
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Georgia
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Szeryfowa (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Impact
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | Nagłówkowa
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Liberation Mono
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Zamiennik Courier
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Liberation Sans
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Zamiennik Arial
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Liberation Serif
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Zamiennik Times
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Linux Libertine O
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Semibold / Mono
| style="height: 23px; width: 297.35px;" | Typografia profesjonalna
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Loma
| style="height: 23px; width: 351.375px;" | Regular / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Tajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Noto Sans
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Obsługa "No Tofu" (Global)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Noto Sans CJK
| style="height: 23px; width: 351.375px;" | Regular / Bold (HK / JP / KR / SC / TC)
| style="height: 23px; width: 297.35px;" | Azjatyckie (Chiny/Jap/Kor)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Noto Serif
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Szeryfowa (Global)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Sawasdee
| style="height: 23px; width: 351.375px;" | Regular / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Tajski / Ozdobny
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Times New Roman
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Standardowa szeryfowa
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Tlwg Mono
| style="height: 23px; width: 351.375px;" | Regular / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Tajski (Monospace)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Trebuchet MS
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Bezszeryfowa (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Umpush
| style="height: 23px; width: 351.375px;" | Regular / Bold / Light / Oblique
| style="height: 23px; width: 297.35px;" | Tajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Verdana
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Ekranowa (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Webdings
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | 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)'''
[[Plik:Przykładowe dane.png|600x300px|ramka|centruj|alt=Przykładowe dane - szybkie testowanie szablonu]]

== Przykłady ==

Przykładowe szablony wraz z danymi wejściowymi

* Faktura: 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]

* List: 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]

* 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]

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

Przykładowe szablony wraz z danymi wejściowymi

* Rachunek: 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]

Wytyczne przygotowania szablonów

2026-04-27T13:09:20Z

Primesoft: /* Tekst nie jest widoczny po przegenerowaniu dokumentu do formatu PDF (Wykorzystanie niestandardowych czcionek) */

= 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:
[[Plik:Czcionki wbudowane.png|600x300px|ramka|centruj|alt=Konfiguracja programu MS Word - osadzenie czcionek w szablonie]]
Opcja dostępna w menu ''Plik'' pozycja ''Opcje'' jak niżej:
[[Plik:Czcionki wbudowane-opcje.png|600x300px|ramka|centruj|alt=Konfiguracja programu MS Word - menu Opcje]]

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

System domyślnie (bez konieczności osadzania) obsługuje poniższą listę czcionek. W przypadku jeżeli czcionka wykorzystana w szablonie nie zostanie osadzona w dokumencie zgodnie z opisem powyżej i jednoczenie nie występuje na wykazie wówczas system jeżeli to możliwe stara się dopasować czcionkę z listy czcionek wbudowanych. 
{| style="border-collapse: collapse; width: 916px; height: 982px;" border="1px" data-path-to-node="3" <thead>
|- style="height: 30px;"
! style="height: 23px; width: 261.275px;" | '''Nazwa czcionki'''
! style="height: 23px; width: 351.375px;" | '''Styl (Weight/Slant)'''
! style="height: 23px; width: 297.35px;" | '''Rodzina / Uwagi'''</thead>
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Abyssinica SIL
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | SIL Open Font
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Aharoni CLM
| style="height: 23px; width: 351.375px;" | Bold / Bold Oblique / Book / Book Oblique
| style="height: 23px; width: 297.35px;" | CLM Project
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Amiri
| style="height: 23px; width: 351.375px;" | Regular / Bold / Slanted / Bold Slanted
| style="height: 23px; width: 297.35px;" | Arabski klasyczny
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Amiri Quran
| style="height: 23px; width: 351.375px;" | Regular / Colored
| style="height: 23px; width: 297.35px;" | Specjalna (Koran)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Andale Mono
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | Monospace
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Ani
| style="height: 23px; width: 351.375px;" | Domyślny
| style="height: 23px; width: 297.35px;" | -
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | AR PL UKai
| style="height: 23px; width: 351.375px;" | Book (CN / HK / TW)
| style="height: 23px; width: 297.35px;" | CJK (Szeryfowe)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | AR PL UMing
| style="height: 23px; width: 351.375px;" | Light (CN / HK / TW)
| style="height: 23px; width: 297.35px;" | CJK (Bezszeryfowe)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Arial
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Standard (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Arial Black
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | Standard (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Caladea
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Kompatybilna z Cambria
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Carlito
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Kompatybilna z Calibri
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Comic Sans MS
| style="height: 23px; width: 351.375px;" | Regular / Bold
| style="height: 23px; width: 297.35px;" | Styl odręczny
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Courier New
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Maszynowy
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | David CLM
| style="height: 23px; width: 351.375px;" | Medium / Medium Italic / Bold / Bold Italic
| style="height: 23px; width: 297.35px;" | Hebrajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | DejaVu Sans
| style="height: 23px; width: 351.375px;" | Book / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Szeroka obsługa Unicode
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | DejaVu Sans Mono
| style="height: 23px; width: 351.375px;" | Book / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Programistyczna
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | DejaVu Serif
| style="height: 23px; width: 351.375px;" | Book / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Szeryfowa
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Frank Ruehl CLM
| style="height: 23px; width: 351.375px;" | Medium / Medium Oblique / Bold / Bold Oblique
| style="height: 23px; width: 297.35px;" | Hebrajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Garuda
| style="height: 23px; width: 351.375px;" | Regular / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Tajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Gentium Basic
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Szeryfowa
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Georgia
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Szeryfowa (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Impact
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | Nagłówkowa
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Liberation Mono
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Zamiennik Courier
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Liberation Sans
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Zamiennik Arial
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Liberation Serif
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Zamiennik Times
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Linux Libertine O
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Semibold / Mono
| style="height: 23px; width: 297.35px;" | Typografia profesjonalna
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Loma
| style="height: 23px; width: 351.375px;" | Regular / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Tajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Noto Sans
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Obsługa "No Tofu" (Global)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Noto Sans CJK
| style="height: 23px; width: 351.375px;" | Regular / Bold (HK / JP / KR / SC / TC)
| style="height: 23px; width: 297.35px;" | Azjatyckie (Chiny/Jap/Kor)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Noto Serif
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Szeryfowa (Global)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Sawasdee
| style="height: 23px; width: 351.375px;" | Regular / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Tajski / Ozdobny
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Times New Roman
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Standardowa szeryfowa
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Tlwg Mono
| style="height: 23px; width: 351.375px;" | Regular / Bold / Oblique / Bold Oblique
| style="height: 23px; width: 297.35px;" | Tajski (Monospace)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Trebuchet MS
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Bezszeryfowa (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Umpush
| style="height: 23px; width: 351.375px;" | Regular / Bold / Light / Oblique
| style="height: 23px; width: 297.35px;" | Tajski
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Verdana
| style="height: 23px; width: 351.375px;" | Regular / Bold / Italic / Bold Italic
| style="height: 23px; width: 297.35px;" | Ekranowa (Microsoft)
|- style="height: 23px;"
| style="height: 23px; width: 261.275px;" | Webdings
| style="height: 23px; width: 351.375px;" | Regular
| style="height: 23px; width: 297.35px;" | 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)'''
[[Plik:Przykładowe dane.png|600x300px|ramka|centruj|alt=Przykładowe dane - szybkie testowanie szablonu]]

== Przykłady ==

Przykładowe szablony wraz z danymi wejściowymi

* Faktura: 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]

* List: 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]

* 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]

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

Przykładowe szablony wraz z danymi wejściowymi

* Rachunek: 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]

ArthurDoc Podręcznik programisty

2026-03-30T14:15:02Z

Primesoft:

[https://app.arthurdoc.com/doc/api Dokumentacja API (może wymagać logowania)]

ArthurDoc Podręcznik programisty

2026-03-30T14:14:42Z

Primesoft:

[https://arthurdoc.com/doc/api Dokumentacja API (może wymagać logowania)]

Strona główna

2026-03-19T13:13:53Z

Primesoft:

{| width="100%"
|-
| align="center" width="50%" |
<div style="border: 1px solid #A7D7F9;border-radius:0.5em;margin:5px;padding:5px 15px;vertical-align:top;">

<h1>O ArthurDoc</h1>ArthurDoc jest mechanizmem do łatwego i masowego generowania dokumentów.

ArthurDoc może być wykorzystany zarówno do realizacji wewnętrznych procesów biznesowych jak i do komunikacji z klientem. Pozwala zarówno na wygenerowanie pojedynczego dokumentu, jak i wsadowe przetwarzanie setek tysięcy dokumentów.

ArthurDoc przyspiesza proces przygotowania dokumentów, automatyzuje proces ich tworzenia oraz zapewnia poprawność ich formy oraz treści.
Dokumenty generowane są na podstawie szablonów tworzonych z wykorzystaniem ogólnodostępnych narzędzi, np. pakietu MS Office. Użytkownik definiując szablon wskazuje pola docelowo wypełniane danymi ze wskazanego źródła.
System posiada wbudowane repozytorium szablonów, które udostępnia mechanizmy wersjonowania oraz zarządzania uprawnieniami.
Źródłem danych dla szablonów mogą być informacje pochodzące z istniejących systemów bazodanowych, dane w postaci plików tekstowych oraz innych źródeł.

System ArthurDoc to aplikacja działająca w oparciu o model multi-tenant czyli aplikacja potrafiącą obsługiwać wielu tenantów (dzierżawców, subskrybentów).</div>
| [[Grafika:Tytuł.JPG|right]]
|- valign="top"
|
<div style="border:1px solid #A7D7F9;border-radius:0.5em;background-color:#F1F6FF;margin:5px;padding:5px 15px;vertical-align:top;">

<h1 style="padding-left:0.5em;background: #A7D7F9;background: -moz-linear-gradient(center right, #fff, #A7D7F9 100%);background-image: -o-linear-gradient(left, rgb(167,215,249),rgb(255,255,255));">Podręczniki</h1>
'''

[[ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc Podręcznik administratora]]

[[ArthurDoc Podręcznik programisty]]



'''

</div>
| <div style="border: 1px solid #A7D7F9;border-radius:0.5em;background-color:#F1F6FF;margin:5px;padding:5px 15px;vertical-align:top;">

<h1 style="padding-left:0.5em;background: #A7D7F9;background: -moz-linear-gradient(center right, #fff, #A7D7F9 100%);background-image: -o-linear-gradient(left, rgb(167,215,249),rgb(255,255,255));">Szybkie linki</h1>
* [[Start|Jak rozpocząć pracę z ArthurDoc?]]
* [[Wytyczne do przygotowania szablonów |Jak przygotować szablon?]]
* [[Szablony|Jak dodać wcześniej przygotowany szablon?]]
* [[Zadania|Jak zdefiniować zadanie?]]
* [[Zlecenia|Jak zdefiniować zlecenia?]]
* [[DocToPdf - wbudowane_funkcje|DocToPdf - funkcje wbudowane (if, barcode, rowNumber, rekordset...)]]
</div>
|}

Strona główna

2026-03-19T13:12:24Z

Primesoft:

{| width="100%"
|-
| align="center" width="50%" |
<div style="border: 1px solid #A7D7F9;border-radius:0.5em;margin:5px;padding:5px 15px;vertical-align:top;">
<h1>O ArthurDoc</h1>ArthurDoc jest mechanizmem do łatwego i masowego generowania dokumentów.

ArthurDoc może być wykorzystany zarówno do realizacji wewnętrznych procesów biznesowych jak i do komunikacji z klientem. Pozwala zarówno na wygenerowanie pojedynczego dokumentu, jak i wsadowe przetwarzanie setek tysięcy dokumentów.

ArthurDoc przyspiesza proces przygotowania dokumentów, automatyzuje proces ich tworzenia oraz zapewnia poprawność ich formy oraz treści.
Dokumenty generowane są na podstawie szablonów tworzonych z wykorzystaniem ogólnodostępnych narzędzi, np. pakietu MS Office. Użytkownik definiując szablon wskazuje pola docelowo wypełniane danymi ze wskazanego źródła.
System posiada wbudowane repozytorium szablonów, które udostępnia mechanizmy wersjonowania oraz zarządzania uprawnieniami.
Źródłem danych dla szablonów mogą być informacje pochodzące z istniejących systemów bazodanowych, dane w postaci plików tekstowych oraz innych źródeł.

System ArthurDoc to aplikacja działająca w oparciu o model multi-tenant czyli aplikacja potrafiącą obsługiwać wielu tenantów (dzierżawców, subskrybentów).</div>
| [[Grafika:Tytuł.JPG|right]]
|- valign="top"
|
<div style="border:1px solid #A7D7F9;border-radius:0.5em;background-color:#F1F6FF;margin:5px;padding:5px 15px;vertical-align:top;">
<h1 style="padding-left:0.5em;background: #A7D7F9;background: -moz-linear-gradient(center right, #fff, #A7D7F9 100%);background-image: -o-linear-gradient(left, rgb(167,215,249),rgb(255,255,255));">Podręczniki</h1>
'''

[[ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc Podręcznik administratora]]

[[ArthurDoc Podręcznik programisty]]


'''

</div>
| <div style="border: 1px solid #A7D7F9;border-radius:0.5em;background-color:#F1F6FF;margin:5px;padding:5px 15px;vertical-align:top;">
<h1 style="padding-left:0.5em;background: #A7D7F9;background: -moz-linear-gradient(center right, #fff, #A7D7F9 100%);background-image: -o-linear-gradient(left, rgb(167,215,249),rgb(255,255,255));">Szybkie linki</h1>
* [[Start|Jak rozpocząć pracę z ArthurDoc?]]
* [[Wytyczne do przygotowania szablonów |Jak przygotować szablon?]]
* [[Szablony|Jak dodać wcześniej przygotowany szablon?]]
* [[Zadania|Jak zdefiniować zadanie?]]
* [[Zlecenia|Jak zdefiniować zlecenia?]]
* [[DocToPdf -_wbudowane_funkcje|DocToPdf - funkcje wbudowane]]
</div>
|}

Wytyczne do przygotowania szablonów

2023-08-04T14:43:23Z

Primesoft: Primesoft przeniósł(-osła) stronę Wytyczne do przygotowania szablonów do Wytyczne przygotowania szablonów

#PATRZ [[Wytyczne przygotowania szablonów]]

Wytyczne przygotowania szablonów

2023-08-04T14:43:23Z

Primesoft: Primesoft przeniósł(-osła) stronę Wytyczne do przygotowania szablonów do Wytyczne przygotowania szablonów

Wytyczne przygotowania szablonów

2023-08-04T14:42:52Z

Primesoft: /* Przykłady */

Wytyczne przygotowania szablonów

2023-08-04T14:42:25Z

Primesoft: /* Przykłady */

Wytyczne przygotowania szablonów

2023-08-04T14:41:20Z

Primesoft: /* Przykłady */

Wytyczne przygotowania szablonów

2023-08-04T14:39:59Z

Primesoft:

Wytyczne przygotowania szablonów

2023-08-04T14:37:53Z

Primesoft: /* FAQ */

Plik:Przykładowe dane.png

2023-08-04T14:37:18Z

Primesoft:

Wytyczne przygotowania szablonów

2023-08-04T14:24:30Z

Primesoft: /* Nie widzę tekstu po przegenerowaniu dokumentu do formatu PDF (Wykorzystanie niestandardowych czcionek) */

Plik:Czcionki wbudowane-opcje.png

2023-08-04T14:23:17Z

Primesoft:

Wytyczne przygotowania szablonów

2023-08-04T14:20:12Z

Primesoft: /* Przykłady */

Wytyczne przygotowania szablonów

2023-08-04T14:19:48Z

Primesoft: /* Przykłady */

Wytyczne przygotowania szablonów

2023-08-04T14:19:38Z

Primesoft: /* Przykłady */

Wytyczne przygotowania szablonów

2023-08-04T14:19:00Z

Primesoft: /* Nie widzę tekstu po przegenerowaniu dokumentu do formatu PDF (Wykorzystanie niestandardowych czcionek) */

Plik:Czcionki wbudowane.png

2023-08-04T14:16:05Z

Primesoft:

Wytyczne przygotowania szablonów

2023-08-04T14:09:38Z

Primesoft:

Wytyczne przygotowania szablonów

2023-08-04T13:36:18Z

Primesoft:

= DOC to 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.

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

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

1.1. Faktura

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]

1.2. List

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

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]

= 2. FOP TO PDF =

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]

DocToPdf - wbudowane funkcje

2023-01-25T10:25:28Z

Primesoft:

'''1. Wstawienie zmiennej'''
{| class="wikitable"
|-
| '''Opis funkcji''' || Celem funkcji jest bezpośrednie wstawienie wartości zmiennej z danych wejściowych do dokumentu.
|-
| '''Format funkcji''' || ${'''pole'''}

gdzie

'''pole''' - nazwa pola z danych wejściowych. W przypadku excela jest to nazwa kolumny.
|-
| '''Przykład wywołania''' || ${adres } → ul. wielka 13/5
|}
'''2. Zamiana liczby na wartość kwotową (inwords)'''
{| class="wikitable"
|-
| '''Nazwa funkcji''' || inwords
|-
| '''Opis funkcji''' || Funkcja zamienia wartość typu float na słowną wartość kwoty z dopisaniem walut.
Język ustalany z poziomu wywołania job w api. (tylko język polski, pozostałe języki wymagają dodania parametru do funkcji w docx)
|-
| '''Format funkcji''' || ${inwords('''number, language, currency''')}

gdzie

'''number''' - liczba zapisana zgodnie z standardem ISO 4217. Parametr może być zmienną pobraną z danych wejściowych, np. ${inwords(brutto)}

'''language''' (parametr opcjonalny) - język tłumaczenia, domyślna wartość en (parametr opcjonalny)

'''currency''' (parametr opcjonalny) - waluta tłumaczenia, domyślna wartość USD (parametr opcjonalny)
|-
| '''Przykład wywołania''' || ${inwords('21,20')} → dwadzieścia jeden złotych dwadzieścia groszy

${inwords(brutto)} → dwadzieścia jeden złotych dwadzieścia groszy

${inwords('21.20', ' en','USD' )} → twenty dollars twenty cents

${inwords('134,07', ‘pl’, ‘PLN’)} → sto trzydzieści cztery złote siedem groszy
|-
| '''Obsługiwane lokalizacje''' || Funkcja konwertuje kwotę zapisaną liczbą na zapis słowny. Funkcja wspiera poniższe lokalizacje.
{| class="wikitable"
|-
! Język !! Identyfikator !! Liczba !! Waluta
|-
| Belgian French || fr_BE || + || -
|-
| Brazilian Portuguese || pt_BR || + || +
|-
| Bulgarian || bg || + || -
|-
| Czech || cs || + || -
|-
| Danish || dk || + || +
|-
| Dutch || nl || + || -
|-
| English || en || + || +
|-
| Estonian || et || + || -
|-
| Georgian || ka || + || +
|-
| German || de || + || +
|-
| French || fr || + || +
|-
| Hungarian || hu || + || +
|-
| Indonesian || id || + || -
|-
| Italian || it || + || -
|-
| Lithuanian || lt || + || +
|-
| Latvian || lv || + || -
|-
| Malay || ms || + || -
|-
| Polish || pl || + || +
|-
| Romanian || ro || + || +
|-
| Slovak || sk || + || -
|-
| Spanish || es || + || +
|-
| Russian || ru || + || +
|-
| Swedish || sv || + || -
|-
| Turkish || tr || + || +
|-
| Turkmen || tk || + || +
|-
| Ukainian || ua || + || +
|-
| Yoruba || yo || + || +
|-
|}
|}
'''3. Formatowanie liczby (format)'''
{| class="wikitable"
|-
| Nazwa funkcji || '''format'''
|-
| Opis funkcji || Funkcja przekształca liczbę zmiennoprzecinkową na format waluty określonej lokalizacji.
|-
| Format funkcji || ${format('''liczba, lokalizacja''')}

gdzie:

'''liczba''' - liczba zmiennoprzecinkowa, która podlega formatowaniu. Może być to zmienna pobrana z danych wejściowych,
np. ${format(brutto)}

'''lokalizacja''' (parametr opcjonalny) - parametr odpowiedzialny za format wyjściowy przekształcenia zmiennej liczbowej na wartość walutową.

Parametr ten musi być zgodny z "Powszechnym repozytorium danych lokalizacji" (CLDR - Unicode Common Locale Data Repository) wykorzystywanych

przez International Components for Unicode (ICU). Obsługiwane formaty dostępne na http://www.localeplanet.com/icu/ , np. pl, pl_PL, en, en_GB, en_US.

Domyślna wartość en_US.

Domyślnie formatowanie: do dwóch miejsc po przecinku
|-
| Przykład wywołania || ${format(3000.000)} → 3,000.00

${format(brutto,'pl_PL'} → 3 000,00

${format(100000000,'hi_IN')} → 10,00,00,000.00
|}
'''4. Kod kreskowy, kod QR (barcode)'''

{| class="wikitable"
|-
| Nazwa funkcji || '''barcode'''
|-
| Opis funkcji || Funkcja wstawia obraz z kodem kreskowym podanym w parametrze.
|-
| Format funkcji || ${barcode('''parametr, typ kodu, szerokość, wysokość''')}

gdzie:

'''parametr''' - wartość tekstową lub liczbowa. Parametr może być zmienną pobraną z danych wejściowych.

'''typ kodu''' - typ kodu kreskowego. Typ kodu zgodny z jest listą podaną poniżej.

'''szerokość''' - szerokość obrazu, który ma zawierać kod kreskowy. Szerokość podawana jest pikselach (px).

'''wysokość''' - wysokość obrazu, który ma zawierać kod kreskowy. Wysokość podawana jest pikselach (px).

Lista obsługiwanych typów kodów kreskowych:

* auspost : AusPost 4 State Customer Code
* azteccode : Aztec Code
* azteccodecompact : Compact Aztec Code
* aztecrune : Aztec Runes
* bc412 : BC412
* channelcode : Channel Code
* codablockf : Codablock F
* code11 : Code 11
* code128 : Code 128
* code16k : Code 16K
* code2of5 : Code 25
* code32 : Italian Pharmacode
* code39 : Code 39
* code39ext : Code 39 Extended
* code49 : Code 49
* code93 : Code 93
* code93ext : Code 93 Extended
* codeone : Code One
* coop2of5 : COOP 2 of 5
* daft : Custom 4 state symbology
* databarexpanded : GS1 DataBar Expanded
* databarexpandedcomposite : GS1 DataBar Expanded Composite
* databarexpandedstacked : GS1 DataBar Expanded Stacked
* databarexpandedstackedcomposite : GS1 DataBar Expanded Stacked Composite
* databarlimited : GS1 DataBar Limited
* databarlimitedcomposite : GS1 DataBar Limited Composite
* databaromni : GS1 DataBar Omnidirectional
* databaromnicomposite : GS1 DataBar Omnidirectional Composite
* databarstacked : GS1 DataBar Stacked
* databarstackedcomposite : GS1 DataBar Stacked Composite
* databarstackedomni : GS1 DataBar Stacked Omnidirectional
* databarstackedomnicomposite : GS1 DataBar Stacked Omnidirectional Composite
* databartruncated : GS1 DataBar Truncated
* databartruncatedcomposite : GS1 DataBar Truncated Composite
* datalogic2of5 : Datalogic 2 of 5
* datamatrix : Data Matrix
* datamatrixrectangular : Data Matrix Rectangular
* dotcode : DotCode
* ean13 : EAN-13
* ean13composite : EAN-13 Composite
* ean14 : GS1-14
* ean2 : EAN-2 (2 digit addon)
* ean5 : EAN-5 (5 digit addon)
* ean8 : EAN-8
* ean8composite : EAN-8 Composite
* flattermarken : Flattermarken
* gs1-128 : GS1-128
* gs1-128composite : GS1-128 Composite
* gs1-cc : GS1 Composite 2D Component
* gs1datamatrix : GS1 Data Matrix
* gs1datamatrixrectangular : GS1 Data Matrix Rectangular
* gs1northamericancoupon : GS1 North American Coupon
* gs1qrcode : GS1 QR Code
* hanxin : Han Xin Code
* hibcazteccode : HIBC Aztec Code
* hibccodablockf : HIBC Codablock F
* hibccode128 : HIBC Code 128
* hibccode39 : HIBC Code 39
* hibcdatamatrix : HIBC Data Matrix
* hibcdatamatrixrectangular : HIBC Data Matrix Rectangular
* hibcmicropdf417 : HIBC MicroPDF417
* hibcpdf417 : HIBC PDF417
* hibcqrcode : HIBC QR Code
* iata2of5 : IATA 2 of 5
* identcode : Deutsche Post Identcode
* industrial2of5 : Industrial 2 of 5
* interleaved2of5 : Interleaved 2 of 5 (ITF)
* isbn : ISBN
* ismn : ISMN
* issn : ISSN
* itf14 : ITF-14
* japanpost : Japan Post 4 State Customer Code
* kix : Royal Dutch TPG Post KIX
* leitcode : Deutsche Post Leitcode
* matrix2of5 : Matrix 2 of 5
* maxicode : MaxiCode
* micropdf417 : MicroPDF417
* microqrcode : Micro QR Code
* msi : MSI Modified Plessey
* onecode : USPS Intelligent Mail
* pdf417 : PDF417
* pdf417compact : Compact PDF417
* pharmacode : Pharmaceutical Binary Code
* pharmacode2 : Two-track Pharmacode
* planet : USPS PLANET
* plessey : Plessey UK
* posicode : PosiCode
* postnet : USPS POSTNET
* pzn : Pharmazentralnummer (PZN)
* qrcode : QR Code
* rationalizedCodabar : Codabar
* raw : Custom 1D symbology
* royalmail : Royal Mail 4 State Customer Code
* sscc18 : SSCC-18
* symbol : Miscellaneous symbols
* telepen : Telepen
* telepennumeric : Telepen Numeric
* ultracode : Ultracode
* upca : UPC-A
* upcacomposite : UPC-A Composite
* upce : UPC-E
* upcecomposite : UPC-E Composite
|-
| Przykład wywołania || ${barcode(wartość kodu kreskowego, typ kodu, szerokość, wysokość)}

${barcode(CodeCode128, 'code128', '80px', '80px')}

${barcode(CodeEan13, 'ean13', '80px', '80px')}

${barcode(CodeInterleaved2of5, 'interleaved2of5', '210px', '210px')}

${barcode(CodeQrcode, 'qrcode', '210px', '210px')}
|}
'''5. Obraz z zewnętrznego źródła (image)'''

{| class="wikitable"
|-
| Nazwa funkcji || '''image'''
|-
| Opis funkcji || Funkcja wstawia obraz z podanego źródła (adres url)
|-
| Format funkcji || ${image('''url, szerokość, wysokość, ratio''')}

gdzie:

'''url''' - adres url wstawianego obrazu. Parametr może być zmienną pobraną z danych wejściowych.

'''szerokość''' - szerokość wstawianego obrazu. Szerokość podawana jest miarach: cm, mm, in, pt, pc, px, %, em, ex.

'''wysokość''' - wysokość wstawianego obrazu. Wysokość podawana jest pikselach cm, mm, in, pt, pc, px, %, em, ex.

'''ratio''' - przyjmuje wartości true/false służy do włączenia obsugi proporcji obrazu. Domyślnie parametr ustawiony na false.

Lista obsługiwanych typów obrazów:

* Windows Enhanced Metafile (*.emf)
* Windows Metafile (*.wmf)
* JPEG File Interchange Format(*.jpg; *.jpeg; *.jfif; *.jpe)
* Portable Network Graphics (*.png)
* Windows Bitmap (*.bmp; *.dib; *.rle; *.bmz)
* Graphics Interchange Format (*.gif; *.gfa)
* Compressed Windows Enhanced Metafile (*.emz)
* Compressed Windows Metafile (*.wmz)
* Compressed Macintosh PICT (*.pcz)
* Tag Image File Format (*.tif; *.tiff)
* Computer Graphics Metafile (*.cgm)
* Encapsulated Postscript (*.eps)
* Macintosh PICT (*.pct; *.pict)
* WordPerfect Graphics (*.wpg)
|-
| Przykład wywołania || ${image(UserLogo1)}

${image(UserLogo2, '200')}

${image(UserLogo3, '100px', '100px')}

${image('https://www.google.pl/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png', '100px', '100px')}

${image(UserLogo3, '100px', '800px', 'true')}
|}
'''6. Instrukcje warunkowe (if)'''
{| class="wikitable"
|-
| Nazwa funkcji || '''if'''
|-
| Opis funkcji || Funkcja wykonuję podaną instrukcję warunkową. Jeśli instrukcja kończy się wynikiem true, to objęty funkcją
fragment tekstu jest wstawiany do dokumentu. W przeciwnym wypadku fragment jest usuwany.
|-
| Format funkcji || ${if('''warunek''')} tekst, który ma się wyświetlić w przypadku gdy parametr = true ${endif}

gdzie:

'''warunek''' - instrukcja warunkową zgodną z biblioteką Symfony Expression Language.

Składnia opisana jest na stronie: https://symfony.com/doc/current/components/expression_language/syntax.html.

W instrukcja warunkowych można wykorzystywać zmienne pobrane z danych wejściowych
|-
| Przykład wywołania || ${if(Recipient_ZIP_Code=='60-650')}

Treść dla adresatów posiadających kod 60-650

${endif}
|}
'''7. Tworzenie tabel w dokumencie (RECORDSET)'''
{| class="wikitable"
|-
| Nazwa funkcji || '''RECORDSET'''
|-
| Opis funkcji || Funkcja wstawia w dokumencie tabelę z rekordami pobranymi z danych wejściowych.
|-
| Format funkcji || ${recordset(pole, ''''nazwa'''')}

gdzie:

'''recordset''' - stała nazwa wykorzystywana do funkcji

'''pole''' - nazwa pola z danych wejściowych

'''nazwa''' (parametr opcjonalny) - nazwa recordsetu
|-
| Przykład wywołania ||
Przykład tabeli:

[[Grafika:DocToPdf_7_1.JPG|800px|center]]

Przykładowe dane wejściowe:

[[Grafika:DocToPdf_7_2.JPG|800px|center]]

Wynik działania funckji
[[Grafika:DocToPdf_7_3.JPG|800px|center]]
|-
| Przykład wywołania ||
${ recordset (lp)}

${recordset(lp, ‘harmonogram’)}

${format(recordset(kapital, ‘harmonogram’), ‘pl’)}

${format(recordset(kapital, ‘harmonogram’) + recordset(finans, ‘harmonogram’), ‘pl’)}
|}
{| class="wikitable" style="width: 775px; height: 112px;"
|- style="height: 28px;"
| style="width: 134.781px; height: 28px;" | Nazwa funkcji || style="width: 614.219px; height: 28px;" | '''rowNumber Działa tylko w Recordsecie'''
|- style="height: 28px;"
| style="width: 134.781px; height: 28px;" | Opis funkcji || style="width: 614.219px; height: 28px;" | Funkcja zwraca numer wiersza
|- style="height: 28px;"
| style="width: 134.781px; height: 28px;" | Format funkcji || style="width: 614.219px; height: 28px;" | ${rowNumber('''zera''')}

gdzie:

'''zera '''- liczba zer które będą dopełniane numerem wiersza np.

wartość domyślna 1

3 - zwróci 001 4 - zwróci 0001
|- style="height: 28px;"
| style="width: 134.781px; height: 28px;" | Przykład wywołania || style="width: 614.219px; height: 28px;" | ${rowNumber(1)}

${rowNumber(2)}

${rowNumber(3)}
|}
''''''

'''8. Funkcje arytmetyczne'''

{| class="wikitable"
|-
| Opis funkcji || Funkcja umożliwia wykonywanie wyrażeń za pomocą expression language
|-
| Format funkcji || ${'''wyrażenie'''}

gdzie:

'''wyrażenie''' - podstawowa operacja arytmetyczna, np. ${brutto * vat }
|-
| Przykład wywołania || ${1 + 2} → 3

${1 – 2} → -1

${2 * 2)} → 4

${4 / 2)} → 2

${4.2 + 1.2)} → 5.4

${4,2 + 1,2)} → 5.4

${evaluate((4 + 2) * 3)} → 18

${ZmiennaA} = 12

${ZmiennaA + ZmiennaB * 3} → 72
|}
'''9. Funkcja Teraz'''

{| class="wikitable"
|-
| Nazwa funkcji || '''now'''
|-
| Opis funkcji || Funkcja zwraca obecną datę i czas w którym dokument jest generowany w formacie "Y-m-d H:i:s".
|-
| Format funkcji || ${now( )}
|-
| Przykład wywołania || ${now()}
|}
'''10. Funkcja formatowania czasu'''

{| class="wikitable"
|-
| Nazwa funkcji || '''dateformat'''
|-
| Opis funkcji || Funkcja umożliwia konwertowanie tekstu reprezentującego znacznik czasu z jednego formatu, na inny.
|-
| Format funkcji || ${dateformat('''czas, format''')}

gdzie:

'''czas''' - tekst będący reprezentacją znacznika czasowego. Interpretuje znaczniki czasowe zapisane w formatach zrozumiałych dla klasy \DateTime

'''format''' - formaty daty zgodny z wbudowanymi formatami dat dla PHP

Wartości domyślne argumentów:

* czas - obecny znacznik czasowy,
* format - ISO8601

|-
| Przykład wywołania || ${dateformat('2020-03-12 15:17:22' ,’Y-m-d H:i:sP’)} → 2020-03-12 15:17:22+00:00

${dateformat('03/12/2020 15:17:22', ’Y-m-d H:i:sP’)} → 2020-03-12 15:17:22+00:00

${dateformat('12.05.2020 15:17', ’g:ia \o\n l jS F Y’)} → 3:17pm on Tuesday 12th May 2020

${dateformat('2020-03-12 15:17:22', ’Y-m-d H:i:sP’)} → 2020-03-12 15:17:22+00:00

${dateformat(now(),’m-d-Y’)} → 07-03-2020
|}
'''11. Zagnieżdżanie funkcji'''
{| class="wikitable"
|-
| Opis funkcji || Podane powyżej funkcji można dowolnie zagnieżdżać, np.:

${format( recordset (kapital, ‘harmonogram’) + recordset (finans, ‘harmonogram’), ‘pl’)}

gdzie funkcje realizowane są w następującej kolejności:

# recordset (kapital, ‘harmonogram’)
# recordset (finans, ‘harmonogram’)
# recordset (kapital, ‘harmonogram’) + recordset (finans, ‘harmonogram’)
# format( recordset (kapital, ‘harmonogram’) + recordset (finans, ‘harmonogram’), ‘pl’)
|}
'''12. Funkcja sprawdzająca czy tabela RECORDSET jest wypełniona (IsEmptyRs)'''
{| class="wikitable"
|-
| Nazwa funkcji || '''IsEmptyRs'''
|-
| Opis funkcji || Funkcja zwraca prawdę lub fałsz w zależności od tego czy w pliku z danymi znajdują się wartości do wstawienia w podany RECORDSET.
|-
| '''Format funkcji''' ||
${isEmptyRs(nazwa recordsetu)}

gdzie:

nazwa recordsetu - w przypadku jednego recordsetu bez nazwy należy podać "" (pusty string)
|-
| '''Przykład wywołania''' || ${if(!isEmptyRs('nazwa'))}

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

${recordset(pole, 'nazwa')}

${endif}
|}

[[Plik:MMenu.JPG|200px|lewo]]

Aplikacja ArthurDoc umożliwia definiowanie własnego Menu. '''Opcja ta dostępna jest tylko dla uprawnień Super Admina.'''
W celu zdefiniowania nowej Grupy w Menu wybieramy opcję '''Nowa grupa menu'''
[[Plik:MMenu1.JPG|200px|lewo]]

Po wybraniu tej opcji na ekranie otrzymujemy okno, w którym musimy wprowadzić następujące dane:
[[Plik:MenuRej.png|600px|lewo]]

* nazwa nowej grupy w menu
* nr pozycji nowej grupy w menu
* wskazać rolę którą musi posiadać użytkownik by widzieć daną grupę menu

Po wprowadzeniu danych wybieramy '''Zapisz'''
W celu podglądu zdefiniowanych grup Menu korzystamy z funkcji '''Lista grup menu'''.
[[Plik:MMenu2.JPG|200px|lewo]]

Po wybraniu tej opcji na ekranie mamy następujący widok:
[[Plik:MMenuListaGM.JPG|1000px|lewo]]

Z tego poziomu dostępne są dwie funkcje:

'''Pokaż''' - po wybraniu tej opcji na ekranie mamy następujące informacje dotyczące danej grupy menu (id grupy, data i czas utworzenia, data i czas zmodyfikowania, nazwa grupy menu,

nr pozycji na liście menu dla danej grupy, czy dana grupa jest chroniona? Jeżeli tak to jaka grupa uprawnień ma dostęp. Z tego poziomu możemy przejść do Edycji lub usunąć daną pozycję.

'''Edycja''' - umożliwia edycję danej grupy menu.
[[Plik:MenuEdycja.png|600px|lewo]]

Zmodyfikować możemy: nazwę grupy w menu, nr pozycji grupy w menu, możemy zmienić czy dana grupa ma być chroniona czy też nie i jeżeli jest chroniona to określamy dla jakiej grupy uprawnień ma być widoczna.

Po wprowadzeniu zmian wybieramy '''Zaktualizuj'''.

Z tego poziomu możemy również daną grupę usunąć - wybieramy opcję '''Usuń'''.

W celu zdefiniowania nowej pozycji w danej grupie menu wybieramy opcję '''Nowa pozycja menu'''
[[Plik:MMenu3.JPG|200px|lewo]]

Po wybraniu tej opcji na ekranie otrzymujemy okno, w którym musimy wprowadzić następujące dane:
[[Plik:MMenuRejPM.JPG|800px|lewo]]

* nazwa nowej pozycji w danej grupie menu
* adres strony, która ma się otworzyć po wybraniu danej opcji z menu
* parametry - definiujemy parametry wywołania strony
* nr pozycji nowej pozycji menu w danej grupie
* musimy określić czy dana pozycja jest chroniona i jeżeli tak to określamy dla jakiej grupy uprawnień ma być widoczna
* określamy grupę menu dla której definiujemy daną pozycję
Po wprowadzeniu danych wybieramy '''Zapisz'''

W celu podglądu zdefiniowanych pozycji Menu korzystamy z funkcji '''Lista pozycji menu'''.

[[Plik:MMenu4.JPG|mały|lewo]]

Po wybraniu tej opcji na ekranie mamy następujący widok:
[[Plik:MMenuListaPM.JPG|1000px|lewo]]

Z tego poziomu dostępne są dwie funkcje:

'''Pokaż''' - po wybraniu tej opcji na ekranie mamy następujące informacje dotyczące danej pozycji menu (id pozycji menu, data i czas utworzenia, data i czas zmodyfikowania,

nazwa pozycji menu, nr pozycji na liście menu w danej grupie, czy dana grupa jest chroniona? Jeżeli tak to jaka grupa uprawnień ma dostęp. Z tego poziomu możemy przejść

do Edycji lub usunąć daną pozycję.

'''Edycja''' - umożliwia edycję danej pozycji menu.
[[Plik:MMenuEdycjaPM.JPG|800px|lewo]]

Zmodyfikować możemy: nazwę pozycji w menu, adres strony, która ma się wyświetlać po wybraniu tej pozycji z menu, parametry wywołania strony, nr pozycji w menu,

możemy zmienić czy dana grupa ma być chroniona czy też nie i jeżeli jest chroniona to określamy dla jakiej grupy uprawnień ma być widoczna, grupę menu,

do której dana pozycja należy. Po wprowadzeniu zmian wybieramy '''Zaktualizuj'''.

Z tego poziomu możemy również daną pozycję usunąć - wybieramy opcję '''Usuń'''.

 
 

[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

Plik:MenuEdycja.png

2022-03-17T15:00:59Z

Primesoft:

edycja grupy menu

[[Plik:MMenu.JPG|200px|lewo]]

Aplikacja ArthurDoc umożliwia definiowanie własnego Menu. '''Opcja ta dostępna jest tylko dla uprawnień Super Admina.'''
W celu zdefiniowania nowej Grupy w Menu wybieramy opcję '''Nowa grupa menu'''
[[Plik:MMenu1.JPG|200px|lewo]]

Po wybraniu tej opcji na ekranie otrzymujemy okno, w którym musimy wprowadzić następujące dane:
[[Plik:MenuRej.png|600px|lewo]]

* nazwa nowej grupy w menu
* nr pozycji nowej grupy w menu
* wskazać rolę którą musi posiadać użytkownik by widzieć daną grupę menu

Po wprowadzeniu danych wybieramy '''Zapisz'''
W celu podglądu zdefiniowanych grup Menu korzystamy z funkcji '''Lista grup menu'''.
[[Plik:MMenu2.JPG|200px|lewo]]

Po wybraniu tej opcji na ekranie mamy następujący widok:
[[Plik:MMenuListaGM.JPG|1000px|lewo]]

Z tego poziomu dostępne są dwie funkcje:

'''Pokaż''' - po wybraniu tej opcji na ekranie mamy następujące informacje dotyczące danej grupy menu (id grupy, data i czas utworzenia, data i czas zmodyfikowania, nazwa grupy menu,

nr pozycji na liście menu dla danej grupy, czy dana grupa jest chroniona? Jeżeli tak to jaka grupa uprawnień ma dostęp. Z tego poziomu możemy przejść do Edycji lub usunąć daną pozycję.

'''Edycja''' - umożliwia edycję danej grupy menu.
[[Plik:MMenuRejGM.JPG |800px|lewo]]

Zmodyfikować możemy: nazwę grupy w menu, nr pozycji grupy w menu, możemy zmienić czy dana grupa ma być chroniona czy też nie i jeżeli jest chroniona to określamy dla jakiej grupy uprawnień ma być widoczna.

Po wprowadzeniu zmian wybieramy '''Zaktualizuj'''.

Z tego poziomu możemy również daną grupę usunąć - wybieramy opcję '''Usuń'''.

W celu zdefiniowania nowej pozycji w danej grupie menu wybieramy opcję '''Nowa pozycja menu'''
[[Plik:MMenu3.JPG|200px|lewo]]

Po wybraniu tej opcji na ekranie otrzymujemy okno, w którym musimy wprowadzić następujące dane:
[[Plik:MMenuRejPM.JPG|800px|lewo]]

* nazwa nowej pozycji w danej grupie menu
* adres strony, która ma się otworzyć po wybraniu danej opcji z menu
* parametry - definiujemy parametry wywołania strony
* nr pozycji nowej pozycji menu w danej grupie
* musimy określić czy dana pozycja jest chroniona i jeżeli tak to określamy dla jakiej grupy uprawnień ma być widoczna
* określamy grupę menu dla której definiujemy daną pozycję
Po wprowadzeniu danych wybieramy '''Zapisz'''

W celu podglądu zdefiniowanych pozycji Menu korzystamy z funkcji '''Lista pozycji menu'''.

[[Plik:MMenu4.JPG|mały|lewo]]

Po wybraniu tej opcji na ekranie mamy następujący widok:
[[Plik:MMenuListaPM.JPG|1000px|lewo]]

Z tego poziomu dostępne są dwie funkcje:

'''Pokaż''' - po wybraniu tej opcji na ekranie mamy następujące informacje dotyczące danej pozycji menu (id pozycji menu, data i czas utworzenia, data i czas zmodyfikowania,

nazwa pozycji menu, nr pozycji na liście menu w danej grupie, czy dana grupa jest chroniona? Jeżeli tak to jaka grupa uprawnień ma dostęp. Z tego poziomu możemy przejść

do Edycji lub usunąć daną pozycję.

'''Edycja''' - umożliwia edycję danej pozycji menu.
[[Plik:MMenuEdycjaPM.JPG|800px|lewo]]

Zmodyfikować możemy: nazwę pozycji w menu, adres strony, która ma się wyświetlać po wybraniu tej pozycji z menu, parametry wywołania strony, nr pozycji w menu,

możemy zmienić czy dana grupa ma być chroniona czy też nie i jeżeli jest chroniona to określamy dla jakiej grupy uprawnień ma być widoczna, grupę menu,

do której dana pozycja należy. Po wprowadzeniu zmian wybieramy '''Zaktualizuj'''.

Z tego poziomu możemy również daną pozycję usunąć - wybieramy opcję '''Usuń'''.

 
 

[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

Plik:MenuRej.png

2022-03-17T14:57:06Z

Primesoft:

menu rejestracja

Zadania

2022-03-17T14:54:59Z

Primesoft:

[[Plik:MZadania0.JPG|mały|lewo]]

Zadanie (ang. job) jest pojedynczym procesem generowania dokumentów lub wysyłki maili. Podczas tworzenia zadania użytkownik wybiera szablon oraz źródło danych.

W wyniku zadania otrzymuje dokumenty wyjściowe w formacie pdf/docx lub potwierdzenie wysyłki maila.

Jeśli w danych wejściowych podano więcej niż jeden zestaw danych (np. kilka wierszy danych w excelu), to w ramach zadania zostaną przetworzone wszystkie podane dane.

Po wybraniu z '''menu''' opcji '''Nowe zadanie'''
[[Plik:MZadania1.JPG|mały|lewo]]

na ekranie mamy następujący ekran:
[[Grafika:UtworzZadanieK1.JPG|800px|lewo|Nowe zadanie]]

Pierwszym krokiem tworzenia nowego zadania jest:
* podanie unikalnej nazwy
* wybór zdefiniowanego wcześniej szablonu z listy rozwijalnej dostępnych szablonów (na liście dostępne są aktywne szablony założone w ramach tenanta użytkownika)
* wybór zgodnego z szablonem pliku źródła danych
* wybór nazwy pola, z której będą brane nazwy plików wynikowych (opcjonalne)
Po wypełnieniu danych wybieramy przycisk '''Dalej''' i przechodzimy do kroku drugiego - walidacji.

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
[[Grafika:UtworzZadanieK2.JPG|800px|lewo|Nowe zadanie]]

oraz znalezienia niezgodności między szablonem, a źródłem danych nowo - dodawanego zadania.
[[Grafika:UtworzZadanieK2Err.JPG|800px|lewo|Nowe zadanie]]

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 ekran:
[[Grafika:UtworzZadanieK3.JPG|800px|lewo|Nowe zadanie]]

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ń'''
[[Plik:MZadania2.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Plik:ListaZadan4.png|1000px|lewo|XXX]]

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

'''Utworzył''' - użytkownik który utworzył zadanie

'''Nazwa zadania''' - nazwa zadania

'''Opis statusu zadania''' - informacją na jakim etapie realizacji jest dane zadanie

'''Scal pliki''' - informacja czy wszystko ma zostać scalone do jednego pliku czy nie

W kolumnie '''Akcje''' możemy wybrać opcję '''Pokaż''' i '''Klonuj'''.
Po wybraniu Akcji '''Pokaż'''
Wówczas na ekranie wyświetlone zostaną poniższe dane:
[[Plik:Job.png|700px|lewo|Zadania]]

W tym momencie mamy do wyboru następujące operacje:

'''Pobierz archiwum zip''' - umożliwia pobranie wygenerowanych plików spakowanych w formacie ZIP

'''Pobierz żądanie w formacie JSON''' - umożliwia pobranie informacji w formacie JSON. Wówczas na ekranie mamy następujący ekran:
[[Grafika:PobierzZadanieJSON.JPG|thumb|lewo|5000px|Zadania]]

Po wybraniu Akcji '''Klonuj'''

Po wybraniu z '''menu''' opcji '''Lista wyników zadania'''
[[Plik:MZadania3.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Grafika:ListaWynikowZadan.JPG|thumb|lewo|1000px|Zadania]]

W tym miejscu możemy pobrać wygenrwany w systemie plik.
 
 

[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

Plik:ListaZadan4.png

2022-03-17T14:54:19Z

Primesoft:

lista zadan

Plik:ListaZadan2.png

2022-03-17T14:52:41Z

Primesoft:

lista zadan

Zadania

2022-03-17T14:50:05Z

Primesoft:

[[Plik:MZadania0.JPG|mały|lewo]]

Zadanie (ang. job) jest pojedynczym procesem generowania dokumentów lub wysyłki maili. Podczas tworzenia zadania użytkownik wybiera szablon oraz źródło danych.

W wyniku zadania otrzymuje dokumenty wyjściowe w formacie pdf/docx lub potwierdzenie wysyłki maila.

Jeśli w danych wejściowych podano więcej niż jeden zestaw danych (np. kilka wierszy danych w excelu), to w ramach zadania zostaną przetworzone wszystkie podane dane.

Po wybraniu z '''menu''' opcji '''Nowe zadanie'''
[[Plik:MZadania1.JPG|mały|lewo]]

na ekranie mamy następujący ekran:
[[Grafika:UtworzZadanieK1.JPG|800px|lewo|Nowe zadanie]]

Pierwszym krokiem tworzenia nowego zadania jest:
* podanie unikalnej nazwy
* wybór zdefiniowanego wcześniej szablonu z listy rozwijalnej dostępnych szablonów (na liście dostępne są aktywne szablony założone w ramach tenanta użytkownika)
* wybór zgodnego z szablonem pliku źródła danych
* wybór nazwy pola, z której będą brane nazwy plików wynikowych (opcjonalne)
Po wypełnieniu danych wybieramy przycisk '''Dalej''' i przechodzimy do kroku drugiego - walidacji.

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
[[Grafika:UtworzZadanieK2.JPG|800px|lewo|Nowe zadanie]]

oraz znalezienia niezgodności między szablonem, a źródłem danych nowo - dodawanego zadania.
[[Grafika:UtworzZadanieK2Err.JPG|800px|lewo|Nowe zadanie]]

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 ekran:
[[Grafika:UtworzZadanieK3.JPG|800px|lewo|Nowe zadanie]]

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ń'''
[[Plik:MZadania2.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Grafika:ListaZadan.JPG|1000px|lewo|XXX]]

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

'''Utworzył''' - użytkownik który utworzył zadanie

'''Nazwa zadania''' - nazwa zadania

'''Opis statusu zadania''' - informacją na jakim etapie realizacji jest dane zadanie

'''Scal pliki''' - informacja czy wszystko ma zostać scalone do jednego pliku czy nie

W kolumnie '''Akcje''' możemy wybrać opcję '''Pokaż''' i '''Klonuj'''.
Po wybraniu Akcji '''Pokaż'''
Wówczas na ekranie wyświetlone zostaną poniższe dane:
[[Plik:Job.png|700px|lewo|Zadania]]

W tym momencie mamy do wyboru następujące operacje:

'''Pobierz archiwum zip''' - umożliwia pobranie wygenerowanych plików spakowanych w formacie ZIP

'''Pobierz żądanie w formacie JSON''' - umożliwia pobranie informacji w formacie JSON. Wówczas na ekranie mamy następujący ekran:
[[Grafika:PobierzZadanieJSON.JPG|thumb|lewo|5000px|Zadania]]

Po wybraniu Akcji '''Klonuj'''

Po wybraniu z '''menu''' opcji '''Lista wyników zadania'''
[[Plik:MZadania3.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Grafika:ListaWynikowZadan.JPG|thumb|lewo|1000px|Zadania]]

W tym miejscu możemy pobrać wygenrwany w systemie plik.
 
 

[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

Zadania

2022-03-17T14:46:23Z

Primesoft:

[[Plik:MZadania0.JPG|mały|lewo]]

Zadanie (ang. job) jest pojedynczym procesem generowania dokumentów lub wysyłki maili. Podczas tworzenia zadania użytkownik wybiera szablon oraz źródło danych.

W wyniku zadania otrzymuje dokumenty wyjściowe w formacie pdf/docx lub potwierdzenie wysyłki maila.

Jeśli w danych wejściowych podano więcej niż jeden zestaw danych (np. kilka wierszy danych w excelu), to w ramach zadania zostaną przetworzone wszystkie podane dane.

Po wybraniu z '''menu''' opcji '''Nowe zadanie'''
[[Plik:MZadania1.JPG|mały|lewo]]

na ekranie mamy następujący ekran:
[[Grafika:UtworzZadanieK1.JPG|800px|lewo|Nowe zadanie]]

Pierwszym krokiem tworzenia nowego zadania jest:
* podanie unikalnej nazwy
* wybór zdefiniowanego wcześniej szablonu z listy rozwijalnej dostępnych szablonów (na liście dostępne są aktywne szablony założone w ramach tenanta użytkownika)
* wybór zgodnego z szablonem pliku źródła danych
* wybór nazwy pola, z której będą brane nazwy plików wynikowych (opcjonalne)
Po wypełnieniu danych wybieramy przycisk '''Dalej''' i przechodzimy do kroku drugiego - walidacji.

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
[[Grafika:UtworzZadanieK2.JPG|800px|lewo|Nowe zadanie]]

oraz znalezienia niezgodności między szablonem, a źródłem danych nowo - dodawanego zadania.
[[Grafika:UtworzZadanieK2Err.JPG|800px|lewo|Nowe zadanie]]

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 ekran:
[[Grafika:UtworzZadanieK3.JPG|800px|lewo|Nowe zadanie]]

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ń'''
[[Plik:MZadania2.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Grafika:ListaZadan.JPG|1000px|lewo|XXX]]

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

'''Status zadania''' - informacją na jakim etapie realizacji jest dane zadanie

'''Scal pliki''' - informacja czy wszystko ma zostać scalone do jednego pliku czy nie

W kolumnie '''Akcje''' możemy wybrać opcję '''Pokaż''' i '''Klonuj'''.
Po wybraniu Akcji '''Pokaż'''
Wówczas na ekranie wyświetlone zostaną poniższe dane:
[[Plik:Job.png|700px|lewo|Zadania]]

W tym momencie mamy do wyboru następujące operacje:

'''Pobierz archiwum zip''' - umożliwia pobranie wygenerowanych plików spakowanych w formacie ZIP

'''Pobierz żądanie w formacie JSON''' - umożliwia pobranie informacji w formacie JSON. Wówczas na ekranie mamy następujący ekran:
[[Grafika:PobierzZadanieJSON.JPG|thumb|lewo|5000px|Zadania]]

Po wybraniu Akcji '''Klonuj'''

Po wybraniu z '''menu''' opcji '''Lista wyników zadania'''
[[Plik:MZadania3.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Grafika:ListaWynikowZadan.JPG|thumb|lewo|1000px|Zadania]]

W tym miejscu możemy pobrać wygenrwany w systemie plik.
 
 

[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

Plik:Job.png

2022-03-17T14:45:23Z

Primesoft:

zadanie

Szablony

2022-03-17T14:41:57Z

Primesoft:

[[Plik:MSzablony.JPG|mały|lewo]]

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).

Plik do wczytania należy wcześniej sobie przygotować ([[Wytyczne do przygotowania szablonów]]).

Po wybraniu z '''menu''' opcji '''Nowy szablon -flow''' lub '''Nowy szablon - prosty model danych'''

[[Plik:MSzablony1i2.JPG|mały|lewo]]

na ekranie mamy następujący widok:

[[Plik:Krok1.png|800px|lewo|Nowe zadanie]]

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 - konwersja szablonu word na plik pdf lub docx
- FOP to PDF - konwersja szablonu xslt na plik pdf
- XDFDF to PDF - wypełnienie danymi pliku pdf z formularzami
- send email - wysyłka maili
* podanie pliku szablonu zgodnego z podanym powyżej mechanizmem
Po wypełnieniu danych wybieramy przycisk Dalej i przechodzimy do kroku drugiego.
[[Grafika:UtworzSzablonK2.JPG|800px|lewo|Nowe zadanie]]

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
[[Grafika:UtworzSzablonK3.JPG|800px|lewo|Nowe szablon]]

W tym miejscu mamy do wyboru następujące opcje:

'''Zakończ''' - zapisanie utworzonego szablonu

'''Cofnij''' - cofnięcie do kroku wcześniej (w przypadku szablonu z prostym modelem danych opcja ta jest niedostępna)

'''Resetuj''' - akcja ta wiąże się z usunięciem wszelkich dotychczasowych danych procesu

Po wybraniu z '''menu''' opcji '''Lista szablonów'''
[[Plik:MSzablony3.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Grafika:ListaSzablonow.JPG|1000px|lewo|XXX]]

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.

W kolumnie '''Akcje''' możemy wybrać opcję '''Pokaż'''. Wówczas na ekranie wyświetlone zostaną poniższe dane:

'''Id''' - jednoznaczny identyfikator szablonu (w postaci 128-bitowego textu)

'''guid''' - jednoznaczny identyfikator szablonu

'''Kolejność sortowania''' - pozwala użytkownikowi na ustalenie kolejności wyświetlania się szablonu na listach

'''Utworzono''' - data i godzina utworzenia szablonu

'''Utworzył''' - użytkownik który stworzył szablon

'''Zmodyfikowano''' - data i godzina ostatniej modyfikacji

'''Zmodyfikował''' - użytkownik który zmodyfikował szablon

'''Nazwa szablonu''' - nazwa szablonu

'''Typ szablonu''' - typ szablonu (np. DOC, send mail, FOP to PDF)

'''Nazwa pliku''' - nazwa pliku z zapisanym szablonem

'''Nazwa modelu danych''' - nazwa modelu danych z szablonem

'''Czy szablon jest aktywny?''' - informacja o aktywności szablonu

'''Nazwa programu''' - nazwa programu w którym został stworzony szablon (libreOffice/ Microsot Word)

[[Plik:Szablon.png|thumb|lewo|1000px]]

W tym momencie mamy do wyboru następujące operacje:

'''Pobierz aktualną wersję''' - umożliwia pobranie aktualnej wersji szablonu na komputer

'''Edytuj''' - możliwość edycji wybranego szablonu. Na ekranie wyświetlone zostaje poniższe okno:
[[Grafika:EdycjaSzablonu.JPG|thumb|lewo|1000px|Źródła danych]]

Plik możemy edytować przy użyciu pakietu LibreOffice Online lub Office 365 w zależności od posiadanych przez nas licencji. Po wybraniu pakietu wybrany szablon będzie można zmodyfikować i zapisać.

Poniżej przedstawiono edycję z wykorzystaniem pakietu LibreOffice Online.
[[Grafika:EdycjaSzablonuLibre.JPG|thumb|lewo|1000px|Źródła danych]]

'''Wersje szablonu''' - opcja pozwala na wylistowanie wcześniejszych wersji szablonu. Po wybraniu tej opcji na ekranie wyświetlane są wszystkie wersje z możliwością podglądu każdej wersji (opcja Pokaż).

Jest również możliwość z tego miejsca pobrania wcześniejszych wersji (opcja Pobierz)

[[Grafika:WersjeSzablonu.JPG|thumb|lewo|1000px|Źródła danych]]

'''Lista zadań dla tego szablonu''' - Wyświetla listę wszystkich zadań które zostały stworzone na bazie tego szablonu

'''Dezaktywuj''' - Dostęp do tej funkcjonalności mają użytkownicy o profilu administratora lub super administratora systemu.

Dezaktywacja szablonu powoduje niewyświetlanie się danego szablonu na listach dostępnych szablonów podczas zakładania zadań i zleceń.

'''Usuń''' - Dostęp do tej funkcjonalności mają użytkownicy o profilu administratora lub super administratora systemu.

Usunięcie szablonu powoduje trwałe usunięcie szablonu z systemu. Jest to operacja nieodwracana. Usunąć można tylko te szablony, które nie były nigdy wykorzystane podczas tworzenia zadań.

'''Usuń bezpowrotnie''' - Usuwa szablon wraz ze wszystkimi zadaniami oraz zleceniami. Usuwa również wszystkie pliki związane z szablonem (docx szablonu, pliki danych zadań itp.).

Po trwałym usunięciu szablonu nie pozostaje po nim żaden ślad w systemie. Jest to operacja nieodwracalna.

[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

Plik:Krok1.png

2022-03-17T14:26:39Z

Primesoft:

krok1

Szablony

2022-03-17T14:24:08Z

Primesoft:

[[Plik:MSzablony.JPG|mały|lewo]]

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).

Plik do wczytania należy wcześniej sobie przygotować ([[Wytyczne do przygotowania szablonów]]).

Po wybraniu z '''menu''' opcji '''Nowy szablon -flow''' lub '''Nowy szablon - prosty model danych'''

[[Plik:MSzablony1i2.JPG|mały|lewo]]

na ekranie mamy następujący widok:

[[Grafika:UtworzSzablonK1.JPG|800px|lewo|Nowe zadanie]]

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 - konwersja szablonu word na plik pdf lub docx
- FOP to PDF - konwersja szablonu xslt na plik pdf
- XDFDF to PDF - wypełnienie danymi pliku pdf z formularzami
- send email - wysyłka maili
* podanie pliku szablonu zgodnego z podanym powyżej mechanizmem
Po wypełnieniu danych wybieramy przycisk Dalej i przechodzimy do kroku drugiego.
[[Grafika:UtworzSzablonK2.JPG|800px|lewo|Nowe zadanie]]

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
[[Grafika:UtworzSzablonK3.JPG|800px|lewo|Nowe szablon]]

W tym miejscu mamy do wyboru następujące opcje:

'''Zakończ''' - zapisanie utworzonego szablonu

'''Cofnij''' - cofnięcie do kroku wcześniej (w przypadku szablonu z prostym modelem danych opcja ta jest niedostępna)

'''Resetuj''' - akcja ta wiąże się z usunięciem wszelkich dotychczasowych danych procesu

Po wybraniu z '''menu''' opcji '''Lista szablonów'''
[[Plik:MSzablony3.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Grafika:ListaSzablonow.JPG|1000px|lewo|XXX]]

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.

W kolumnie '''Akcje''' możemy wybrać opcję '''Pokaż'''. Wówczas na ekranie wyświetlone zostaną poniższe dane:

'''Id''' - jednoznaczny identyfikator szablonu (w postaci 128-bitowego textu)

'''guid''' - jednoznaczny identyfikator szablonu

'''Kolejność sortowania''' - pozwala użytkownikowi na ustalenie kolejności wyświetlania się szablonu na listach

'''Utworzono''' - data i godzina utworzenia szablonu

'''Utworzył''' - użytkownik który stworzył szablon

'''Zmodyfikowano''' - data i godzina ostatniej modyfikacji

'''Zmodyfikował''' - użytkownik który zmodyfikował szablon

'''Nazwa szablonu''' - nazwa szablonu

'''Typ szablonu''' - typ szablonu (np. DOC, send mail, FOP to PDF)

'''Nazwa pliku''' - nazwa pliku z zapisanym szablonem

'''Nazwa modelu danych''' - nazwa modelu danych z szablonem

'''Czy szablon jest aktywny?''' - informacja o aktywności szablonu

'''Nazwa programu''' - nazwa programu w którym został stworzony szablon (libreOffice/ Microsot Word)

[[Plik:Szablon.png|thumb|lewo|1000px]]

W tym momencie mamy do wyboru następujące operacje:

'''Pobierz aktualną wersję''' - umożliwia pobranie aktualnej wersji szablonu na komputer

'''Edytuj''' - możliwość edycji wybranego szablonu. Na ekranie wyświetlone zostaje poniższe okno:
[[Grafika:EdycjaSzablonu.JPG|thumb|lewo|1000px|Źródła danych]]

Plik możemy edytować przy użyciu pakietu LibreOffice Online lub Office 365 w zależności od posiadanych przez nas licencji. Po wybraniu pakietu wybrany szablon będzie można zmodyfikować i zapisać.

Poniżej przedstawiono edycję z wykorzystaniem pakietu LibreOffice Online.
[[Grafika:EdycjaSzablonuLibre.JPG|thumb|lewo|1000px|Źródła danych]]

'''Wersje szablonu''' - opcja pozwala na wylistowanie wcześniejszych wersji szablonu. Po wybraniu tej opcji na ekranie wyświetlane są wszystkie wersje z możliwością podglądu każdej wersji (opcja Pokaż).

Jest również możliwość z tego miejsca pobrania wcześniejszych wersji (opcja Pobierz)

[[Grafika:WersjeSzablonu.JPG|thumb|lewo|1000px|Źródła danych]]

'''Dezaktywuj''' - Dostęp do tej funkcjonalności mają użytkownicy o profilu administratora lub super administratora systemu.

Dezaktywacja szablonu powoduje niewyświetlanie się danego szablonu na listach dostępnych szablonów podczas zakładania zadań i zleceń.

'''Usuń''' - Dostęp do tej funkcjonalności mają użytkownicy o profilu administratora lub super administratora systemu.

Usunięcie szablonu powoduje trwałe usunięcie szablonu z systemu. Jest to operacja nieodwracana. Usunąć można tylko te szablony, które nie były nigdy wykorzystane podczas tworzenia zadań.

[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

Plik:Szablon.png

2022-03-17T14:22:26Z

Primesoft:

pola szablonu

Szablony

2022-03-17T14:18:43Z

Primesoft:

[[Plik:MSzablony.JPG|mały|lewo]]

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).

Plik do wczytania należy wcześniej sobie przygotować ([[Wytyczne do przygotowania szablonów]]).

Po wybraniu z '''menu''' opcji '''Nowy szablon -flow''' lub '''Nowy szablon - prosty model danych'''

[[Plik:MSzablony1i2.JPG|mały|lewo]]

na ekranie mamy następujący widok:

[[Grafika:UtworzSzablonK1.JPG|800px|lewo|Nowe zadanie]]

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 - konwersja szablonu word na plik pdf lub docx
- FOP to PDF - konwersja szablonu xslt na plik pdf
- XDFDF to PDF - wypełnienie danymi pliku pdf z formularzami
- send email - wysyłka maili
* podanie pliku szablonu zgodnego z podanym powyżej mechanizmem
Po wypełnieniu danych wybieramy przycisk Dalej i przechodzimy do kroku drugiego.
[[Grafika:UtworzSzablonK2.JPG|800px|lewo|Nowe zadanie]]

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
[[Grafika:UtworzSzablonK3.JPG|800px|lewo|Nowe szablon]]

W tym miejscu mamy do wyboru następujące opcje:

'''Zakończ''' - zapisanie utworzonego szablonu

'''Cofnij''' - cofnięcie do kroku wcześniej (w przypadku szablonu z prostym modelem danych opcja ta jest niedostępna)

'''Resetuj''' - akcja ta wiąże się z usunięciem wszelkich dotychczasowych danych procesu

Po wybraniu z '''menu''' opcji '''Lista szablonów'''
[[Plik:MSzablony3.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Grafika:ListaSzablonow.JPG|1000px|lewo|XXX]]

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 szablonu (w postaci 128-bitowego textu)

'''guid''' - jednoznaczny identyfikator szablonu

'''Kolejność sortowania''' - pozwala użytkownikowi na ustalenie kolejności wyświetlania się szablonu na listach

'''Utworzono''' - data i godzina utworzenia szablonu

'''Utworzył''' - użytkownik który stworzył szablon

'''Zmodyfikowano''' - data i godzina ostatniej modyfikacji

'''Zmodyfikował''' - użytkownik który zmodyfikował szablon

'''Nazwa szablonu''' - nazwa szablonu

'''Typ szablonu''' - typ szablonu (np. DOC, send mail, FOP to PDF)

'''Nazwa pliku''' - nazwa pliku z zapisanym szablonem

'''Nazwa modelu danych''' - nazwa modelu danych z szablonem

'''Czy szablon jest aktywny?''' - informacja o aktywności szablonu

'''Nazwa programu''' - nazwa programu w którym został stworzony szablon (libreOffice/ Microsot Word)

W kolumnie '''Akcje''' możemy wybrać opcję '''Pokaż'''. Wówczas na ekranie wyświetlone zostaną poniższe dane:
[[Grafika:SzablonPokaz.JPG|thumb|lewo|1000px|Źródła danych]]

W tym momencie mamy do wyboru następujące operacje:

'''Pobierz aktualną wersję''' - umożliwia pobranie aktualnej wersji szablonu na komputer

'''Edytuj''' - możliwość edycji wybranego szablonu. Na ekranie wyświetlone zostaje poniższe okno:
[[Grafika:EdycjaSzablonu.JPG|thumb|lewo|1000px|Źródła danych]]

Plik możemy edytować przy użyciu pakietu LibreOffice Online lub Office 365 w zależności od posiadanych przez nas licencji. Po wybraniu pakietu wybrany szablon będzie można zmodyfikować i zapisać.

Poniżej przedstawiono edycję z wykorzystaniem pakietu LibreOffice Online.
[[Grafika:EdycjaSzablonuLibre.JPG|thumb|lewo|1000px|Źródła danych]]

'''Wersje szablonu''' - opcja pozwala na wylistowanie wcześniejszych wersji szablonu. Po wybraniu tej opcji na ekranie wyświetlane są wszystkie wersje z możliwością podglądu każdej wersji (opcja Pokaż).

Jest również możliwość z tego miejsca pobrania wcześniejszych wersji (opcja Pobierz)

[[Grafika:WersjeSzablonu.JPG|thumb|lewo|1000px|Źródła danych]]

'''Dezaktywuj''' - Dostęp do tej funkcjonalności mają użytkownicy o profilu administratora lub super administratora systemu.

Dezaktywacja szablonu powoduje niewyświetlanie się danego szablonu na listach dostępnych szablonów podczas zakładania zadań i zleceń.

'''Usuń''' - Dostęp do tej funkcjonalności mają użytkownicy o profilu administratora lub super administratora systemu.

Usunięcie szablonu powoduje trwałe usunięcie szablonu z systemu. Jest to operacja nieodwracana. Usunąć można tylko te szablony, które nie były nigdy wykorzystane podczas tworzenia zadań.

[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

Szablony

2022-03-17T14:12:15Z

Primesoft:

[[Plik:MSzablony.JPG|mały|lewo]]

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).

Plik do wczytania należy wcześniej sobie przygotować ([[Wytyczne do przygotowania szablonów]]).

Po wybraniu z '''menu''' opcji '''Nowy szablon -flow''' lub '''Nowy szablon - prosty model danych'''

[[Plik:MSzablony1i2.JPG|mały|lewo]]

na ekranie mamy następujący widok:

[[Grafika:UtworzSzablonK1.JPG|800px|lewo|Nowe zadanie]]

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 - konwersja szablonu word na plik pdf lub docx
- FOP to PDF - konwersja szablonu xslt na plik pdf
- XDFDF to PDF - wypełnienie danymi pliku pdf z formularzami
- send email - wysyłka maili
* podanie pliku szablonu zgodnego z podanym powyżej mechanizmem
Po wypełnieniu danych wybieramy przycisk Dalej i przechodzimy do kroku drugiego.
[[Grafika:UtworzSzablonK2.JPG|800px|lewo|Nowe zadanie]]

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
[[Grafika:UtworzSzablonK3.JPG|800px|lewo|Nowe szablon]]

W tym miejscu mamy do wyboru następujące opcje:

'''Zakończ''' - zapisanie utworzonego szablonu

'''Cofnij''' - cofnięcie do kroku wcześniej (w przypadku szablonu z prostym modelem danych opcja ta jest niedostępna)

'''Resetuj''' - akcja ta wiąże się z usunięciem wszelkich dotychczasowych danych procesu

Po wybraniu z '''menu''' opcji '''Lista szablonów'''
[[Plik:MSzablony3.JPG|mały|lewo]]

na ekranie wyświetlona zostaje następująca lista:
[[Grafika:ListaSzablonow.JPG|1000px|lewo|XXX]]

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 szablonu

'''Kolejność sortowania''' - pozwala użytkownikowi na ustalenie kolejności wyświetlania się szablonu na listach

'''Utworzono''' - data i godzina utworzenia szablonu

'''Zmodyfikowano''' - data i godzina ostatniej modyfikacji

'''Nazwa szablonu''' - nazwa szablonu

'''Nazwa pliku''' - nazwa pliku z zapisanym szablonem

'''Nazwa modelu danych''' - nazwa modelu danych z szablonem

W kolumnie '''Akcje''' możemy wybrać opcję '''Pokaż'''. Wówczas na ekranie wyświetlone zostaną poniższe dane:
[[Grafika:SzablonPokaz.JPG|thumb|lewo|1000px|Źródła danych]]

W tym momencie mamy do wyboru następujące operacje:

'''Pobierz aktualną wersję''' - umożliwia pobranie aktualnej wersji szablonu na komputer

'''Edytuj''' - możliwość edycji wybranego szablonu. Na ekranie wyświetlone zostaje poniższe okno:
[[Grafika:EdycjaSzablonu.JPG|thumb|lewo|1000px|Źródła danych]]

Plik możemy edytować przy użyciu pakietu LibreOffice Online lub Office 365 w zależności od posiadanych przez nas licencji. Po wybraniu pakietu wybrany szablon będzie można zmodyfikować i zapisać.

Poniżej przedstawiono edycję z wykorzystaniem pakietu LibreOffice Online.
[[Grafika:EdycjaSzablonuLibre.JPG|thumb|lewo|1000px|Źródła danych]]

'''Wersje szablonu''' - opcja pozwala na wylistowanie wcześniejszych wersji szablonu. Po wybraniu tej opcji na ekranie wyświetlane są wszystkie wersje z możliwością podglądu każdej wersji (opcja Pokaż).

Jest również możliwość z tego miejsca pobrania wcześniejszych wersji (opcja Pobierz)

[[Grafika:WersjeSzablonu.JPG|thumb|lewo|1000px|Źródła danych]]

'''Dezaktywuj''' - Dostęp do tej funkcjonalności mają użytkownicy o profilu administratora lub super administratora systemu.

Dezaktywacja szablonu powoduje niewyświetlanie się danego szablonu na listach dostępnych szablonów podczas zakładania zadań i zleceń.

'''Usuń''' - Dostęp do tej funkcjonalności mają użytkownicy o profilu administratora lub super administratora systemu.

Usunięcie szablonu powoduje trwałe usunięcie szablonu z systemu. Jest to operacja nieodwracana. Usunąć można tylko te szablony, które nie były nigdy wykorzystane podczas tworzenia zadań.

[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

Pojęcia

2022-03-17T14:05:41Z

Primesoft:

'''Batch / Zlecenie''' - zbiór zadań przetwarzanych w ramach jednej paczki

'''Job / Zadanie''' - pojedyncze zadanie przetwarzania danych wejściowych na format wyjściowy

'''Data source / Źródło danych''' - źródło danych wejściowych dla zadania (np. plik Excel XLS, pliki XML)

'''Data / Dane''' - dane wejściowe dla zadania przetworzone ze źródła danych (format pliku XML)

'''Data model / Model danych''' - zbiór zasad opisujących strukturę danych wejściowych (format pliku XSD)

'''Template / Szablon''' - schemat definiujący wynik zadania (zazwyczaj schemat definiujący wygląd dokumentu, maila) - (pliki Word DOCX, transformaty Apache FOP XSLT)

'''Generated / Wygenerowane''' - wynik zadania (zazwyczaj plik PDF, HTML bądź raport tekstowy)

'''Queue / Kolejka''' - lista zadań (kolejka Azure Queue)
 
 
[[ArthurDoc_Podręcznik_użytkownika|ArthurDoc Podręcznik użytkownika]]

[[ArthurDoc_Podręcznik_administratora|ArthurDoc Podręcznik administratora]]

[[Strona_główna|ArthurDoc Strona główna]]
 
[[Plik:ArthurDoc.JPG|100px|mały|lewo]]

DocToPdf - wbudowane funkcje

2022-03-09T12:16:55Z

Primesoft: dodanie opisu isEmptyRs

'''1. Wstawienie zmiennej'''
{| class="wikitable"
|-
| '''Opis funkcji''' || Celem funkcji jest bezpośrednie wstawienie wartości zmiennej z danych wejściowych do dokumentu.
|-
| '''Format funkcji''' || ${'''pole'''}

gdzie

'''pole''' - nazwa pola z danych wejściowych. W przypadku excela jest to nazwa kolumny.
|-
| '''Przykład wywołania''' || ${adres } → ul. wielka 13/5
|}
'''2. Zamiana liczby na wartość kwotową (inwords)'''
{| class="wikitable"
|-
| '''Nazwa funkcji''' || inwords
|-
| '''Opis funkcji''' || Funkcja zamienia wartość typu float na słowną wartość kwoty z dopisaniem walut.
Język ustalany z poziomu wywołania job w api. (tylko język polski, pozostałe języki wymagają dodania parametru do funkcji w docx)
|-
| '''Format funkcji''' || ${inwords('''number, language, currency''')}

gdzie

'''number''' - liczba zapisana zgodnie z standardem ISO 4217. Parametr może być zmienną pobraną z danych wejściowych, np. ${inwords(brutto)}

'''language''' (parametr opcjonalny) - język tłumaczenia, domyślna wartość en (parametr opcjonalny)

'''currency''' (parametr opcjonalny) - waluta tłumaczenia, domyślna wartość USD (parametr opcjonalny)
|-
| '''Przykład wywołania''' || ${inwords('21,20')} → dwadzieścia jeden złotych dwadzieścia groszy

${inwords(brutto)} → dwadzieścia jeden złotych dwadzieścia groszy

${inwords('21.20', ' en','USD' )} → twenty dollars twenty cents

${inwords('134,07', ‘pl’, ‘PLN’)} → sto trzydzieści cztery złote siedem groszy
|-
| '''Obsługiwane lokalizacje''' || Funkcja konwertuje kwotę zapisaną liczbą na zapis słowny. Funkcja wspiera poniższe lokalizacje.
{| class="wikitable"
|-
! Język !! Identyfikator !! Liczba !! Waluta
|-
| Belgian French || fr_BE || + || -
|-
| Brazilian Portuguese || pt_BR || + || +
|-
| Bulgarian || bg || + || -
|-
| Czech || cs || + || -
|-
| Danish || dk || + || +
|-
| Dutch || nl || + || -
|-
| English || en || + || +
|-
| Estonian || et || + || -
|-
| Georgian || ka || + || +
|-
| German || de || + || +
|-
| French || fr || + || +
|-
| Hungarian || hu || + || +
|-
| Indonesian || id || + || -
|-
| Italian || it || + || -
|-
| Lithuanian || lt || + || +
|-
| Latvian || lv || + || -
|-
| Malay || ms || + || -
|-
| Polish || pl || + || +
|-
| Romanian || ro || + || +
|-
| Slovak || sk || + || -
|-
| Spanish || es || + || +
|-
| Russian || ru || + || +
|-
| Swedish || sv || + || -
|-
| Turkish || tr || + || +
|-
| Turkmen || tk || + || +
|-
| Ukainian || ua || + || +
|-
| Yoruba || yo || + || +
|-
|}
|}
'''3. Formatowanie liczby (format)'''
{| class="wikitable"
|-
| Nazwa funkcji || '''format'''
|-
| Opis funkcji || Funkcja przekształca liczbę zmiennoprzecinkową na format waluty określonej lokalizacji.
|-
| Format funkcji || ${format('''liczba, lokalizacja''')}

gdzie:

'''liczba''' - liczba zmiennoprzecinkowa, która podlega formatowaniu. Może być to zmienna pobrana z danych wejściowych,
np. ${format(brutto)}

'''lokalizacja''' (parametr opcjonalny) - parametr odpowiedzialny za format wyjściowy przekształcenia zmiennej liczbowej na wartość walutową.

Parametr ten musi być zgodny z "Powszechnym repozytorium danych lokalizacji" (CLDR - Unicode Common Locale Data Repository) wykorzystywanych

przez International Components for Unicode (ICU). Obsługiwane formaty dostępne na http://www.localeplanet.com/icu/ , np. pl, pl_PL, en, en_GB, en_US.

Domyślna wartość en_US.

Domyślnie formatowanie: do dwóch miejsc po przecinku
|-
| Przykład wywołania || ${format(3000.000)} → 3,000.00

${format(brutto,'pl_PL'} → 3 000,00

${format(100000000,'hi_IN')} → 10,00,00,000.00
|}

'''4. Kod kreskowy, kod QR (barcode)'''

{| class="wikitable"
|-
| Nazwa funkcji || '''barcode'''
|-
| Opis funkcji || Funkcja wstawia obraz z kodem kreskowym podanym w parametrze.
|-
| Format funkcji || ${barcode('''parametr, typ kodu, szerokość, wysokość''')}

gdzie:

'''parametr''' - wartość tekstową lub liczbowa. Parametr może być zmienną pobraną z danych wejściowych.

'''typ kodu''' - typ kodu kreskowego. Typ kodu zgodny z jest listą podaną poniżej.

'''szerokość''' - szerokość obrazu, który ma zawierać kod kreskowy. Szerokość podawana jest pikselach (px).

'''wysokość''' - wysokość obrazu, który ma zawierać kod kreskowy. Wysokość podawana jest pikselach (px).

Lista obsługiwanych typów kodów kreskowych:

* auspost : AusPost 4 State Customer Code
* azteccode : Aztec Code
* azteccodecompact : Compact Aztec Code
* aztecrune : Aztec Runes
* bc412 : BC412
* channelcode : Channel Code
* codablockf : Codablock F
* code11 : Code 11
* code128 : Code 128
* code16k : Code 16K
* code2of5 : Code 25
* code32 : Italian Pharmacode
* code39 : Code 39
* code39ext : Code 39 Extended
* code49 : Code 49
* code93 : Code 93
* code93ext : Code 93 Extended
* codeone : Code One
* coop2of5 : COOP 2 of 5
* daft : Custom 4 state symbology
* databarexpanded : GS1 DataBar Expanded
* databarexpandedcomposite : GS1 DataBar Expanded Composite
* databarexpandedstacked : GS1 DataBar Expanded Stacked
* databarexpandedstackedcomposite : GS1 DataBar Expanded Stacked Composite
* databarlimited : GS1 DataBar Limited
* databarlimitedcomposite : GS1 DataBar Limited Composite
* databaromni : GS1 DataBar Omnidirectional
* databaromnicomposite : GS1 DataBar Omnidirectional Composite
* databarstacked : GS1 DataBar Stacked
* databarstackedcomposite : GS1 DataBar Stacked Composite
* databarstackedomni : GS1 DataBar Stacked Omnidirectional
* databarstackedomnicomposite : GS1 DataBar Stacked Omnidirectional Composite
* databartruncated : GS1 DataBar Truncated
* databartruncatedcomposite : GS1 DataBar Truncated Composite
* datalogic2of5 : Datalogic 2 of 5
* datamatrix : Data Matrix
* datamatrixrectangular : Data Matrix Rectangular
* dotcode : DotCode
* ean13 : EAN-13
* ean13composite : EAN-13 Composite
* ean14 : GS1-14
* ean2 : EAN-2 (2 digit addon)
* ean5 : EAN-5 (5 digit addon)
* ean8 : EAN-8
* ean8composite : EAN-8 Composite
* flattermarken : Flattermarken
* gs1-128 : GS1-128
* gs1-128composite : GS1-128 Composite
* gs1-cc : GS1 Composite 2D Component
* gs1datamatrix : GS1 Data Matrix
* gs1datamatrixrectangular : GS1 Data Matrix Rectangular
* gs1northamericancoupon : GS1 North American Coupon
* gs1qrcode : GS1 QR Code
* hanxin : Han Xin Code
* hibcazteccode : HIBC Aztec Code
* hibccodablockf : HIBC Codablock F
* hibccode128 : HIBC Code 128
* hibccode39 : HIBC Code 39
* hibcdatamatrix : HIBC Data Matrix
* hibcdatamatrixrectangular : HIBC Data Matrix Rectangular
* hibcmicropdf417 : HIBC MicroPDF417
* hibcpdf417 : HIBC PDF417
* hibcqrcode : HIBC QR Code
* iata2of5 : IATA 2 of 5
* identcode : Deutsche Post Identcode
* industrial2of5 : Industrial 2 of 5
* interleaved2of5 : Interleaved 2 of 5 (ITF)
* isbn : ISBN
* ismn : ISMN
* issn : ISSN
* itf14 : ITF-14
* japanpost : Japan Post 4 State Customer Code
* kix : Royal Dutch TPG Post KIX
* leitcode : Deutsche Post Leitcode
* matrix2of5 : Matrix 2 of 5
* maxicode : MaxiCode
* micropdf417 : MicroPDF417
* microqrcode : Micro QR Code
* msi : MSI Modified Plessey
* onecode : USPS Intelligent Mail
* pdf417 : PDF417
* pdf417compact : Compact PDF417
* pharmacode : Pharmaceutical Binary Code
* pharmacode2 : Two-track Pharmacode
* planet : USPS PLANET
* plessey : Plessey UK
* posicode : PosiCode
* postnet : USPS POSTNET
* pzn : Pharmazentralnummer (PZN)
* qrcode : QR Code
* rationalizedCodabar : Codabar
* raw : Custom 1D symbology
* royalmail : Royal Mail 4 State Customer Code
* sscc18 : SSCC-18
* symbol : Miscellaneous symbols
* telepen : Telepen
* telepennumeric : Telepen Numeric
* ultracode : Ultracode
* upca : UPC-A
* upcacomposite : UPC-A Composite
* upce : UPC-E
* upcecomposite : UPC-E Composite
|-
| Przykład wywołania || ${barcode(wartość kodu kreskowego, typ kodu, szerokość, wysokość)}

${barcode(CodeCode128, 'code128', '80px', '80px')}

${barcode(CodeEan13, 'ean13', '80px', '80px')}

${barcode(CodeInterleaved2of5, 'interleaved2of5', '210px', '210px')}

${barcode(CodeQrcode, 'qrcode', '210px', '210px')}
|}

'''5. Obraz z zewnętrznego źródła (image)'''

{| class="wikitable"
|-
| Nazwa funkcji || '''image'''
|-
| Opis funkcji || Funkcja wstawia obraz z podanego źródła (adres url)
|-
| Format funkcji || ${image('''url, szerokość, wysokość, ratio''')}

gdzie:

'''url''' - adres url wstawianego obrazu. Parametr może być zmienną pobraną z danych wejściowych.

'''szerokość''' - szerokość wstawianego obrazu. Szerokość podawana jest miarach: cm, mm, in, pt, pc, px, %, em, ex.

'''wysokość''' - wysokość wstawianego obrazu. Wysokość podawana jest pikselach cm, mm, in, pt, pc, px, %, em, ex.

'''ratio''' - przyjmuje wartości true/false służy do włączenia obsugi proporcji obrazu. Domyślnie parametr ustawiony na false.

Lista obsługiwanych typów obrazów:

* Windows Enhanced Metafile (*.emf)
* Windows Metafile (*.wmf)
* JPEG File Interchange Format(*.jpg; *.jpeg; *.jfif; *.jpe)
* Portable Network Graphics (*.png)
* Windows Bitmap (*.bmp; *.dib; *.rle; *.bmz)
* Graphics Interchange Format (*.gif; *.gfa)
* Compressed Windows Enhanced Metafile (*.emz)
* Compressed Windows Metafile (*.wmz)
* Compressed Macintosh PICT (*.pcz)
* Tag Image File Format (*.tif; *.tiff)
* Computer Graphics Metafile (*.cgm)
* Encapsulated Postscript (*.eps)
* Macintosh PICT (*.pct; *.pict)
* WordPerfect Graphics (*.wpg)
|-
| Przykład wywołania || ${image(UserLogo1)}

${image(UserLogo2, '200')}

${image(UserLogo3, '100px', '100px')}

${image('https://www.google.pl/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png', '100px', '100px')}

${image(UserLogo3, '100px', '800px', 'true')}
|}

'''6. Instrukcje warunkowe (if)'''
{| class="wikitable"
|-
| Nazwa funkcji || '''if'''
|-
| Opis funkcji || Funkcja wykonuję podaną instrukcję warunkową. Jeśli instrukcja kończy się wynikiem true, to objęty funkcją
fragment tekstu jest wstawiany do dokumentu. W przeciwnym wypadku fragment jest usuwany.
|-
| Format funkcji || ${if('''warunek''')} tekst, który ma się wyświetlić w przypadku gdy parametr = true ${endif}

gdzie:

'''warunek''' - instrukcja warunkową zgodną z biblioteką Symfony Expression Language.

Składnia opisana jest na stronie: https://symfony.com/doc/current/components/expression_language/syntax.html.

W instrukcja warunkowych można wykorzystywać zmienne pobrane z danych wejściowych
|-
| Przykład wywołania || ${if(Recipient_ZIP_Code=='60-650')}

Treść dla adresatów posiadających kod 60-650

${endif}
|}

'''7. Tworzenie tabel w dokumencie (RECORDSET)'''
{| class="wikitable"
|-
| Nazwa funkcji || '''RECORDSET'''
|-
| Opis funkcji || Funkcja wstawia w dokumencie tabelę z rekordami pobranymi z danych wejściowych.
|-
| Format funkcji || ${recordset(pole, ''''nazwa'''')}

gdzie:

'''recordset''' - stała nazwa wykorzystywana do funkcji

'''pole''' - nazwa pola z danych wejściowych

'''nazwa''' (parametr opcjonalny) - nazwa recordsetu
|-
| Przykład wywołania ||
Przykład tabeli:

[[Grafika:DocToPdf_7_1.JPG|800px|center]]

Przykładowe dane wejściowe:

[[Grafika:DocToPdf_7_2.JPG|800px|center]]

Wynik działania funckji
[[Grafika:DocToPdf_7_3.JPG|800px|center]]
|-
| Przykład wywołania ||
${ recordset (lp)}

${recordset(lp, ‘harmonogram’)}

${format(recordset(kapital, ‘harmonogram’), ‘pl’)}

${format(recordset(kapital, ‘harmonogram’) + recordset(finans, ‘harmonogram’), ‘pl’)}
|}

'''8. Funkcje arytmetyczne'''

{| class="wikitable"
|-
| Opis funkcji || Funkcja umożliwia wykonywanie wyrażeń za pomocą expression language
|-
| Format funkcji || ${'''wyrażenie'''}

gdzie:

'''wyrażenie''' - podstawowa operacja arytmetyczna, np. ${brutto * vat }
|-
| Przykład wywołania || ${1 + 2} → 3

${1 – 2} → -1

${2 * 2)} → 4

${4 / 2)} → 2

${4.2 + 1.2)} → 5.4

${4,2 + 1,2)} → 5.4

${evaluate((4 + 2) * 3)} → 18

${ZmiennaA} = 12

${ZmiennaA + ZmiennaB * 3} → 72
|}

'''9. Funkcja Teraz'''

{| class="wikitable"
|-
| Nazwa funkcji || '''now'''
|-
| Opis funkcji || Funkcja zwraca obecną datę i czas w którym dokument jest generowany w formacie "Y-m-d H:i:s".
|-
| Format funkcji || ${now( )}
|-
| Przykład wywołania || ${now()}
|}

'''10. Funkcja formatowania czasu'''

{| class="wikitable"
|-
| Nazwa funkcji || '''dateformat'''
|-
| Opis funkcji || Funkcja umożliwia konwertowanie tekstu reprezentującego znacznik czasu z jednego formatu, na inny.
|-
| Format funkcji || ${dateformat('''czas, format''')}

gdzie:

'''czas''' - tekst będący reprezentacją znacznika czasowego. Interpretuje znaczniki czasowe zapisane w formatach zrozumiałych dla klasy \DateTime

'''format''' - formaty daty zgodny z wbudowanymi formatami dat dla PHP

Wartości domyślne argumentów:

* czas - obecny znacznik czasowy,
* format - ISO8601

|-
| Przykład wywołania || ${dateformat('2020-03-12 15:17:22' ,’Y-m-d H:i:sP’)} → 2020-03-12 15:17:22+00:00

${dateformat('03/12/2020 15:17:22', ’Y-m-d H:i:sP’)} → 2020-03-12 15:17:22+00:00

${dateformat('12.05.2020 15:17', ’g:ia \o\n l jS F Y’)} → 3:17pm on Tuesday 12th May 2020

${dateformat('2020-03-12 15:17:22', ’Y-m-d H:i:sP’)} → 2020-03-12 15:17:22+00:00

${dateformat(now(),’m-d-Y’)} → 07-03-2020
|}

'''11. Zagnieżdżanie funkcji'''
{| class="wikitable"
|-
| Opis funkcji || Podane powyżej funkcji można dowolnie zagnieżdżać, np.:

${format( recordset (kapital, ‘harmonogram’) + recordset (finans, ‘harmonogram’), ‘pl’)}

gdzie funkcje realizowane są w następującej kolejności:

# recordset (kapital, ‘harmonogram’)
# recordset (finans, ‘harmonogram’)
# recordset (kapital, ‘harmonogram’) + recordset (finans, ‘harmonogram’)
# format( recordset (kapital, ‘harmonogram’) + recordset (finans, ‘harmonogram’), ‘pl’)
|}

'''12. Funkcja sprawdzająca czy tabela RECORDSET jest wypełniona (IsEmptyRs)'''
{| class="wikitable"
|-
| Nazwa funkcji || '''IsEmptyRs'''
|-
| Opis funkcji || Funkcja zwraca prawdę lub fałsz w zależności od tego czy w pliku z danymi znajdują się wartości do wstawienia w podany RECORDSET.
|-
| '''Format funkcji''' ||
${isEmptyRs(nazwa recordsetu)}

gdzie:

nazwa recordsetu - w przypadku jednego recordsetu bez nazwy należy podać "" (pusty string)
|-
| '''Przykład wywołania''' || ${if(!isEmptyRs('nazwa'))}

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

${recordset(pole, 'nazwa')}

${endif}
|}

Wytyczne przygotowania szablonów

2022-01-05T06:54:50Z

Primesoft:

'''1. DOC TO 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.

Przykład:
${Nazwa_firmy}

'''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]]

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

1.1. Faktura

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]

1.2. List

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

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]

'''2. FOP TO PDF'''

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]

Wytyczne przygotowania szablonów

2022-01-05T06:51:52Z

Primesoft:

'''1. DOC TO 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.

Przykład:
${Nazwa_firmy}

'''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]]

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

1.1. Faktura

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]

1.2. List

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

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]

'''2. FOP TO PDF'''

szablon - [https://gitlab.primesoft.pl/gdk/gdk_api_foptopdf/-/blob/master/src/main/resources/template_examples/invoice_example_fop.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]

Plik:Statement of work example.xlsx

2022-01-05T06:51:26Z

Primesoft:

Wytyczne przygotowania szablonów

2022-01-05T06:51:16Z

Primesoft:

'''1. DOC TO 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.

Przykład:
${Nazwa_firmy}

'''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]]

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

1.1. Faktura

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]

1.2. List

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

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

dane źródłowe - [https://gitlab.primesoft.pl/gdk/gdk_api_doctopdf/blob/develop/src/Resources/template_examples/statement_of_work_example.xlsx Umowy - Dane źródłowe]

'''2. FOP TO PDF'''

szablon - [https://gitlab.primesoft.pl/gdk/gdk_api_foptopdf/-/blob/master/src/main/resources/template_examples/invoice_example_fop.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]

Plik:Statement of work example.docx

2022-01-05T06:50:46Z

Primesoft:

Wytyczne przygotowania szablonów

2022-01-05T06:45:12Z

Primesoft:

'''1. DOC TO 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.

Przykład:
${Nazwa_firmy}

'''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]]

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

1.1. Faktura

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]

1.2. List

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

szablon - [https://gitlab.primesoft.pl/gdk/gdk_api_doctopdf/blob/develop/src/Resources/template_examples/letter_example.docx Umowy - Szablon]

dane źródłowe - [https://gitlab.primesoft.pl/gdk/gdk_api_doctopdf/blob/develop/src/Resources/template_examples/statement_of_work_example.xlsx Umowy - Dane źródłowe]

'''2. FOP TO PDF'''

szablon - [https://gitlab.primesoft.pl/gdk/gdk_api_foptopdf/-/blob/master/src/main/resources/template_examples/invoice_example_fop.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]

Plik:Letter example.xlsx

2022-01-05T06:44:53Z

Primesoft:

Plik:Letter example.docx

2022-01-05T06:44:12Z

Primesoft: