Wydruk
Akcja Drukuj na podstawie szablonu tworzy plik PDF lub Word na podstawie szablonu Word (.docx) i danych z formularza dokumentu. Szablon to zwykły dokument Word, w którym w miejscach na dane są pola korespondencji seryjnej (MergeField). Akcja zastępuje te pola wartościami z formularza i zapisuje gotowy plik jako załącznik dokumentu.
Akcję ustawiasz w kroku procedury obiegu albo w procedurze w trybie akcji uruchamianej przyciskiem. Ogólne zasady konfiguracji akcji opisuje artykuł Akcje systemowe.
Jak to działa¶
- Przygotuj szablon w Wordzie i wstaw do niego pola MergeField.
- Wgraj szablon do aplikacji Pliki.
- Polom formularza, których wartości mają trafić na wydruk, nadaj kody takie same jak nazwy pól MergeField w szablonie.
- Skonfiguruj akcję w procedurze obiegu.
Po uruchomieniu akcja:
- pobiera wartości pól formularza, które są aktywne na typie dokumentu i mają uzupełniony kod,
- dopasowuje je do pól MergeField szablonu po nazwie,
- tworzy plik w wybranym formacie i dodaje go do załączników dokumentu.
Pola szablonu, dla których akcja nie znajdzie wartości, zostają na wydruku puste.
Parametry akcji¶
| Parametr | Opis |
|---|---|
| Katalog plików | Folder w aplikacji Pliki z szablonami wydruku. Zawęża listę w parametrze Szablon wydruku. |
| Szablon wydruku | Plik szablonu .docx z folderu wskazanego w parametrze Katalog plików. Zamiast pliku możesz wskazać pole formularza, w którym użytkownik sam wybiera szablon (patrz Wybór szablonu na formularzu). |
| Dokument | Dokument, z którego pochodzą dane i do którego trafi wydruk. Zwykle pole systemowe Id dokumentu, ale może to być też pole z ID innego dokumentu, np. zapisanym przez akcję Dokument: Utwórz nowy (parametr Zachowaj ID w). |
| Użytkownik | Osoba zapisana jako autor wydruku. Domyślnie pole systemowe Id użytkownika. Puste pole oznacza administratora systemu (użytkownika o ID 1). |
| Nazwa wydruku część 1, 2, 3 | Części nazwy pliku: tekst albo pole formularza, np. numer własny. Puste części są pomijane, a znaki niedozwolone w nazwach plików zastępowane. Rozszerzenie (.pdf albo .docx) akcja dodaje sama. Uzupełnij co najmniej jedną część, inaczej plik nie będzie miał nazwy. |
| Separator nazw | Znak albo tekst między częściami nazwy, np. _ albo -. |
| Format daty | Format dat na wydruku. Domyślnie dd.MM.yyyy (patrz niżej). |
| Format liczby | Format liczb jako niestandardowy format liczbowy .NET, np. #,0.00. Dotyczy wszystkich liczb na wydruku. Puste pole oznacza tyle miejsc po przecinku, ile ustawiono w polu formularza, i separator tysięcy. |
| Symbol dziesiętny | Znak oddzielający część dziesiętną. Domyślnie . (kropka). Na polskich wydrukach zwykle , (przecinek). |
| Symbol grupowania cyfr | Separator tysięcy. Domyślnie spacja. |
| Format wydruku | PDF albo Word. Bez wyboru powstaje plik Word. |
| Drukuj z zadania powiązanego | Atrybuty i pola wbudowane pochodzą z formularza zadania powiązanego z dokumentem, a nie z dokumentu. Gdy dokument nie ma powiązanego zadania, akcja kończy się komunikatem i plik nie powstaje. |
| Czy usunąć poprzedni wydruk | Tak usuwa z załączników dokumentu wcześniejsze wydruki z tego samego szablonu. Przydaje się, gdy wydruk powstaje ponownie, np. po poprawkach. |
Symbole w formacie daty:
dd: dzień (dwie cyfry),MM: miesiąc (dwie cyfry),yy: rok (dwie ostatnie cyfry),yyyy: rok (cztery cyfry),HH: godzina,mm: minuty.
Wielkość liter ma znaczenie: MM to miesiąc, a mm to minuty.
Akcja ma domyślnie wykonanie opóźnione, więc wydruk powstaje na końcu przetwarzania obiegu, z aktualnymi danymi.
Przygotowanie szablonu¶
Szablon to plik .docx. Dane z formularza wstawiasz do niego jako pola MergeField:
- W Wordzie przejdź na kartę Wstawianie i w grupie Tekst wybierz Szybkie części > Pole.
- Na liście Nazwy pól wybierz MergeField.
- W polu Nazwa pola wpisz kod pola z formularza, np.
numer_umowy, i zatwierdź.
W dokumencie pole wygląda tak: «numer_umowy». Wygląd pola (czcionka, rozmiar, pogrubienie) przechodzi na wstawioną wartość.
Szablon możesz wgrać do dowolnego folderu w aplikacji Pliki. Najwygodniej przechowywać szablony w osobnym folderze, a przy wielu rodzajach wydruków w osobnych folderach dla każdego rodzaju. Łatwiej wtedy wskazać szablon w akcji i ograniczyć listę szablonów na formularzu.
Kod pola na formularzu¶
Akcja łączy pole formularza z polem MergeField po kodzie. Kod ustawiasz w edycji formularza, we właściwościach pola, w polu Kod. Pole musi być aktywne na typie dokumentu, ale nie musi być widoczne.
Kody pól na jednym formularzu muszą być unikalne. Jeżeli dwa aktywne pola mają ten sam kod, akcja kończy się komunikatem „Błąd wydruku. Istnieje już pole o kodzie: …”.
Pola na wydruku¶
Atrybuty¶
Wartość atrybutu wstawiasz polem MergeField z kodem atrybutu. Sposób wstawienia zależy od typu atrybutu:
| Typ atrybutu | Wartość na wydruku |
|---|---|
| Pole tekstowe, wielowierszowe pole tekstowe | Tekst |
| Lista rozwijana, auto wyszukiwanie, pole jednokrotnego wyboru | Nazwa wybranej pozycji |
| Liczba całkowita, liczba zmiennoprzecinkowa | Liczba sformatowana zgodnie z parametrami Format liczby, Symbol dziesiętny i Symbol grupowania cyfr |
| Data, data i czas | Data w formacie z parametru Format daty |
| Pole wielokrotnego wyboru | Wybrane pozycje jako lista wypunktowana, każda w osobnym wierszu |
| Wielowierszowe pole tekstowe HTML | Sformatowany tekst (pogrubienia, listy, tabele, obrazy) |
| Panel plików | Pierwszy plik z panelu wstawiony jako obraz. Plik musi być obrazem, np. PNG lub JPG |
Tekst HTML wstawisz z dowolnego pola, dodając w nazwie pola MergeField przedrostek Html:, np. «Html:opis». Analogicznie przedrostek Rtf: wstawia tekst zapisany w formacie RTF.
Pola wbudowane¶
Pola wbudowane wstawiasz tak samo jak atrybuty: polem MergeField z kodem, który nadano polu wbudowanemu na formularzu. Większość pól trafia na wydruk w postaci, w jakiej widać je na formularzu. W przypadku pól powiązanych ze słownikami akcja wstawia nazwę:
| Pole wbudowane | Wartość na wydruku |
|---|---|
| Kontrahent | Nazwa kontrahenta |
| Właściciel | Imię i nazwisko |
| Dział | Nazwa działu |
| Forma płatności | Nazwa formy płatności |
| Waluta | Symbol waluty, np. PLN |
| Kurs | Kurs waluty |
| Rodzaj kursu | Nazwa rodzaju kursu |
| Status | Nazwa statusu dokumentu |
| Procedura obiegu | Nazwa procedury |
| Obieg | Status obiegu |
Pola Elementy i Stawki VAT są listami. Ich obsługę opisuje akapit Listy.
Pole wbudowane dotyczące korekty wstawia numer własny dokumentu korygowanego. Dodatkowo udostępnia na wydruku wartości dokumentu przed korektą i po niej:
BeforeCorrectionNet,BeforeCorrectionVat,BeforeCorrectionGross: netto, VAT i brutto dokumentu korygowanego,CorrectionNet_,CorrectionVat_,CorrectionGross_: kwoty korekty,AfterCorrectionNet,AfterCorrectionVat,AfterCorrectionGross: wartości po korekcie.
Sposób wyliczenia kwot korekty i wartości po korekcie zależy od trybu korekty ustawionego na typie dokumentu.
Listy¶
Listy (elementy, stawki VAT, listy atrybutów, listy wbudowane) drukuje się jako tabele, w których wiersz powtarza się dla każdej pozycji listy. W szablonie:
- Utwórz tabelę z wierszem nagłówka i jednym wierszem na dane.
- W pierwszej komórce wiersza danych wstaw pole MergeField o nazwie
RangeStart:kod_listy, gdzie kod_listy to kod listy na formularzu. - W kolejnych komórkach wstaw pola MergeField z kodami kolumn.
- W ostatniej komórce tego samego wiersza wstaw pole
RangeEnd:kod_listy.
Przykładowy wiersz danych dla listy o kodzie pozycje:
| Lp. | Nazwa | Ilość | Wartość |
|---|---|---|---|
| «RangeStart:pozycje»«Order» | «Name» | «Amount» | «ValueNet»«RangeEnd:pozycje» |
Jeżeli lista na dokumencie jest pusta, akcja usuwa z wydruku całą tabelę z tą listą.
Lista atrybutów: nazwy pól w wierszu to kody atrybutów tworzących kolumny listy. Wartości są formatowane tak jak pojedyncze atrybuty. Jeżeli lista ma kolumnę o kodzie IsConcerned, na wydruk trafią tylko wiersze, w których ta kolumna ma wartość 1.
Lista wbudowana: nazwy pól w wierszu to kody kolumn listy. Na wydruk trafiają kolumny widoczne na liście, z wyjątkiem kolumny ID. Akcja uwzględnia warunki, którymi lista jest filtrowana na formularzu. Lista wbudowana oparta na relacjach pokazuje dokumenty powiązane z drukowanym dokumentem.
Elementy: nazwy pól w wierszu to nazwy właściwości elementu:
| Pole | Wartość |
|---|---|
Order |
Liczba porządkowa |
Name |
Nazwa |
AssortmentName |
Nazwa asortymentu |
Description |
Opis |
Amount |
Ilość |
Unit |
Nazwa jednostki miary |
PriceNetBeforeDiscount, PriceGrossBeforeDiscount |
Cena netto i brutto przed rabatem |
Discount |
Rabat |
PriceNet, PriceGross |
Cena netto i brutto |
Vat |
Nazwa stawki VAT |
ValueNet, ValueVat, ValueGross |
Wartość netto, VAT i brutto |
PriceNetMain, PriceGrossMain |
Cena netto i brutto w walucie głównej |
ValueNetMain, ValueVatMain, ValueGrossMain |
Wartość netto, VAT i brutto w walucie głównej |
CurrencySymbol |
Symbol waluty |
Stawki VAT: nazwy pól w wierszu:
| Pole | Wartość |
|---|---|
VatName |
Nazwa stawki VAT |
VatRate |
Stawka VAT |
NetValue, VatValue, GrossValue |
Wartość netto, VAT i brutto |
NetValueMain, VatValueMain, GrossValueMain |
Wartość netto, VAT i brutto w walucie głównej |
Dane z obiegu¶
Na wydruk możesz wstawić dane z wykonanego kroku obiegu, np. kto i kiedy zaakceptował dokument. Nazwa pola MergeField ma postać:
Workflow_KodKroku_Pole
gdzie KodKroku to kod kroku w procedurze obiegu. Kod kroku nie może zawierać znaku _. Dostępne pola:
| Pole | Wartość |
|---|---|
FinishUser |
Imię i nazwisko osoby, która wykonała krok |
FinishUser_Structure |
Stanowisko osoby, która wykonała krok |
FinishDate |
Data wykonania kroku |
StartDate |
Data, kiedy krok trafił do wykonawcy |
Comment |
Komentarz do kroku |
Status_Name |
Nazwa statusu kroku |
Status_ID |
ID statusu kroku |
Workflow_ID |
ID obiegu |
ID |
ID kroku |
Przykład dla kroku o kodzie akceptacja:
- Zaakceptował: «Workflow_akceptacja_FinishUser», «Workflow_akceptacja_FinishUser_Structure»
- Data akceptacji: «Workflow_akceptacja_FinishDate»
Akcja bierze pod uwagę tylko kroki zaakceptowane. Jeżeli krok nie został jeszcze zaakceptowany, pola zostaną puste.
Jeżeli krok był wykonywany kilka razy, wszystkie jego wykonania wydrukujesz jako listę. Użyj wtedy zakresu RangeStart:Workflow_KodKroku i RangeEnd:Workflow_KodKroku, a w wierszu tabeli pól:
FinishUser: imię i nazwisko wykonawcy,FinishUser_Structure: stanowisko wykonawcy,FinishDate: data wykonania,ProcedureActivityName: nazwa kroku,ActivityStatus: status kroku.
Zakres bez kodu kroku (RangeStart:Workflow_ i RangeEnd:Workflow_) drukuje wszystkie kroki obiegu, niezależnie od ich statusu. W ten sposób przygotujesz wydruk historii obiegu.
Pola dodatkowe¶
Poniższe pola nie wymagają żadnego pola na formularzu o takim kodzie. Wystarczy wstawić je do szablonu.
| Pole | Wartość | Wymagane pole wbudowane na formularzu |
|---|---|---|
DateTimeNow |
Bieżąca data w formacie z parametru Format daty | – |
ValueInWords |
Wartość brutto dokumentu słownie (tylko w złotych i po polsku) | Brutto |
OwnerStructure |
Stanowisko właściciela dokumentu | Właściciel |
CompanyName |
Nazwa firmy | Firma |
CompanyShortName |
Nazwa skrócona firmy | Firma |
CompanyAddress |
Adres firmy | Firma |
CompanyZip |
Kod pocztowy i miejscowość firmy | Firma |
CompanyCity |
Miejscowość firmy | Firma |
CompanyNIP |
NIP firmy | Firma |
CompanyRegon |
REGON firmy | Firma |
CompanyEmail |
E-mail firmy | Firma |
CompanyAccountNumber |
Numer rachunku bankowego firmy | Firma |
ContractorName |
Nazwa kontrahenta | Kontrahent |
ContractorShortName |
Nazwa skrócona kontrahenta | Kontrahent |
ContractorAddress |
Adres kontrahenta | Kontrahent |
ContractorZip |
Kod pocztowy i miejscowość kontrahenta | Kontrahent |
ContractorCity |
Miejscowość kontrahenta | Kontrahent |
ContractorNIP |
NIP kontrahenta | Kontrahent |
ContractorRegon |
REGON kontrahenta | Kontrahent |
ContractorEmail |
E-mail kontrahenta | Kontrahent |
ContractorAccountNumber |
Numer rachunku bankowego kontrahenta | Kontrahent |
DeliveryName |
Nazwa odbiorcy | Odbiorca |
DeliveryAddress |
Adres odbiorcy | Odbiorca |
DeliveryZip |
Kod pocztowy i miejscowość odbiorcy | Odbiorca |
DeliveryCity |
Miejscowość odbiorcy | Odbiorca |
DeliveryNIP |
NIP odbiorcy | Odbiorca |
DeliveryRegon |
REGON odbiorcy | Odbiorca |
DeliveryAccountNumber |
Numer rachunku bankowego odbiorcy | Odbiorca |
Dane firmy pochodzą z kontrahenta przypisanego do firmy w Ustawienia > Kartoteki > Firmy. Bez przypisanego kontrahenta pola firmy (poza nazwą) zostaną puste. Jako rachunek firmy akcja wybiera rachunek w walucie dokumentu, a jeśli go nie ma, pierwszy rachunek kontrahenta firmy. Jeżeli na dokumencie wybrano adres kontrahenta lub odbiorcy, pola adresowe, miejscowość i e-mail pochodzą z tego adresu.
Polski numer rachunku zapisany z prefiksem kraju (28 znaków, np. PL61109010140000071219812874) trafia na wydruk bez prefiksu, w grupach po cztery cyfry.
Słownie można też wydrukować wartość dowolnego pola liczbowego. Kod takiego pola musi zawierać tekst InWords, np. kwotaInWords. Pole o takim kodzie wstawione do szablonu pokaże kwotę słownie w złotych.
Dla dokumentu, który ma dokładnie jeden powiązany dokument, dostępne są też pola CorrectionNetBefore, CorrectionVatBefore, CorrectionGrossBefore (wartości dokumentu powiązanego), CorrectionNetAfter, CorrectionVatAfter, CorrectionGrossAfter (wartości drukowanego dokumentu) oraz CorrectionNet, CorrectionVat, CorrectionGross (różnica). Dla nowych szablonów korekt lepiej użyć pól opisanych w akapicie Pola wbudowane.
Fragmenty warunkowe¶
Fragment szablonu można usunąć z wydruku w zależności od wartości pola na formularzu. Fragment obejmij polami MergeField:
DeleteIfStart_kod=wartość … DeleteIfEnd_kod=wartość
gdzie kod to kod atrybutu, a wartość to wartość, przy której fragment ma zniknąć. Dla pól z listą wyboru podaj ID pozycji. Żeby usunąć fragment, gdy pole jest puste, wpisz null.
Przykład: fragment między «DeleteIfStart_zaliczka=0» a «DeleteIfEnd_zaliczka=0» zniknie z wydruku, gdy pole o kodzie zaliczka ma wartość 0. Przy innej wartości fragment zostanie, a same pola DeleteIf zostaną usunięte.
Wybór szablonu na formularzu¶
Jeżeli szablon ma zależeć od dokumentu (np. różne wzory umów), wybór szablonu możesz zostawić użytkownikowi:
- Na formularzu dodaj atrybut typu Auto wyszukiwanie z systemową listą Pliki.
- W warunkach atrybutu wskaż kolumnę ID (po niej akcja rozpoznaje plik) i kolumnę z nazwą pliku, którą zobaczy użytkownik.
- Dodaj filtry listy, np. ograniczające pliki do folderu z szablonami. Bez filtrów użytkownik zobaczy wszystkie pliki w systemie.
- W akcji, w parametrze Szablon wydruku, wskaż ten atrybut.
Uruchamianie wydruku¶
W kroku obiegu¶
Wydruk może powstawać automatycznie w trakcie obiegu dokumentu. W procedurze obiegu (Obiegi > Procedury) dodaj krok z wykonaniem automatycznym, zapisz go i w sekcji Akcje wybierz akcję Wydruk: Drukuj na podstawie szablonu. Sekcja Akcje pojawia się dopiero po zapisaniu kroku.
Najlepiej przeznaczyć na wydruk osobny krok, nazwany np. „Generowanie wydruku”. W historii obiegu widać wtedy, kiedy i w którym miejscu procesu powstał wydruk.
Konfigurację procedury obiegu opisuje artykuł Tworzenie procedury obiegu.
Przyciskiem na formularzu¶
Żeby użytkownik mógł generować wydruk przyciskiem:
- W Obiegi > Procedury dodaj procedurę z zaznaczoną opcją Tryb akcji i w polu Dotyczy dokumentu wskaż typ dokumentu.
- Dodaj jeden krok z akcją Wydruk: Drukuj na podstawie szablonu.
- Na formularzu typu dokumentu dodaj przycisk z działaniem Uruchom obieg i wskaż utworzoną procedurę (patrz Przycisk).
Taką procedurę uruchomisz też przyciskiem menu (patrz Akcje systemowe).
Wydruk historii obiegu¶
Szablonu wydruku użyjesz też w przycisku Drukuj historię w kontrolce obiegu. Szablon wskazujesz w Ustawienia > Pozostałe > Ustawienia, na zakładce Ogólne, w sekcji Wydruki, w polu Szablon wydruku historii obiegu. Jeżeli pole jest puste, wydruk historii jest pobierany z serwera raportów.
Wydruk historii powstaje zawsze w formacie PDF, otwiera się w nowym oknie i nie jest dodawany do załączników dokumentu. W szablonie działają te same pola co w akcji. Wszystkie kroki obiegu pokazuje zakres RangeStart:Workflow_ opisany w akapicie Dane z obiegu. Przycisk widzą użytkownicy z rolą, która ma funkcję pokazywania przycisku drukuj (patrz Role).