Przejdź do treści

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

  1. Przygotuj szablon w Wordzie i wstaw do niego pola MergeField.
  2. Wgraj szablon do aplikacji Pliki.
  3. Polom formularza, których wartości mają trafić na wydruk, nadaj kody takie same jak nazwy pól MergeField w szablonie.
  4. 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:

  1. W Wordzie przejdź na kartę Wstawianie i w grupie Tekst wybierz Szybkie części > Pole.
  2. Na liście Nazwy pól wybierz MergeField.
  3. 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:

  1. Utwórz tabelę z wierszem nagłówka i jednym wierszem na dane.
  2. W pierwszej komórce wiersza danych wstaw pole MergeField o nazwie RangeStart:kod_listy, gdzie kod_listy to kod listy na formularzu.
  3. W kolejnych komórkach wstaw pola MergeField z kodami kolumn.
  4. 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:

  1. Na formularzu dodaj atrybut typu Auto wyszukiwanie z systemową listą Pliki.
  2. W warunkach atrybutu wskaż kolumnę ID (po niej akcja rozpoznaje plik) i kolumnę z nazwą pliku, którą zobaczy użytkownik.
  3. Dodaj filtry listy, np. ograniczające pliki do folderu z szablonami. Bez filtrów użytkownik zobaczy wszystkie pliki w systemie.
  4. 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:

  1. W Obiegi > Procedury dodaj procedurę z zaznaczoną opcją Tryb akcji i w polu Dotyczy dokumentu wskaż typ dokumentu.
  2. Dodaj jeden krok z akcją Wydruk: Drukuj na podstawie szablonu.
  3. 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).