1. Opis ogólny
System wzorców. Opis ogólny
Elementy definicji wzorców
Edytor wzorców dokumentów
Uprawnienia i wzorce obowiązujące
2. Elementy budowy wzorca
2.1 Opis ogólny
2.2 Rodzaj linii [T][P][D]...
2.3 Pole danych
2.4 Ramka
2.5 Funkcje TrExtLang
2.6 Bloki danych
2.7 Wstawianie elementów graficznych
2.8 Drukowanie kodów kreskowych
3. Tabele pól dla wzorców
4. Tematy powiązane
1. Opis ogólny
System wzorców. Opis ogólny
System wzorców dokumentów i etykiet (en: Template system) w programie
Trawers, to autorskie rozwiązanie, które umożliwia zdefiniowanie treści
i wyglądu dokumentów i etykiet przed wysłaniem na urządzenie wyjściowe.
Urządzenia wyjściowe
System umożliwia połączenie definicji wzorca z bazą danych w celu utworzenia
dokumentów i etykiet o oczekiwanej zawartości informacyjnej i postaci (wyglądu).
Patrz szczegóły:
System wzorców dokumentów i etykiet
Przykłady utworzonych dokumentów i etykiet:
Wzorce dokumentów PrzykładyWzorce etykiet Przykłady
Elementy definicji wzorców
Wzorzec dokumentu tworzy się na podstawie wprowadzanych tekstów,
wstawianych elementów graficznych i wbudowanych funkcji formatujących.
Wzorzec wypełnia się wartościami pól z bazy danych programu Trawers ERP.
Patrz dalej: Elementy budowy wzorca
Wzorzec dokumentu
Wzorzec to jest definicja zawartości i formy dokumentu. Zawiera teksty (opisy)
np. nazwa dokumentu oraz specjalistyczne funkcje ustalające format dokumentu,
np. ramki i elementy graficzne oraz pola z baz danych, np. wartość sprzedaży.
Definicje wzorców zapisane są w plikach w formacie XML.
Wzorce buduje się przy użyciu specjalistycznego edytora: Edytor wzorców dokumentów.
Edytor wzorców dokumentów
(en: Print Format Editor)
Edytor wzorców to jest zestaw funkcji programu ukierunkowany na redagowanie
treści i wyglądu (formatu) wzorca. Ma proste funkcje wprowadzania i edycji tekstów
oraz zaawansowane funkcje umieszczania wartości z pól bazy danych i funkcji
sterujących układem danych.
Edytor służy do budowania wzorca dokumentu lub etykiety z elementów skladowych:
tekstów i opisów, pol danych i znaków sterujacych wydrukiem.
Gotowe wzorce
Wiele gotowych wzorców dokumentów znajduje się w katalogu: https://ftp.tres.pl/
Wzorce Pobieranie z ftp
Wzorce te można dostosowywać dowolnie do swoich potrzeb.
Można to zrobić przy pomocy edytora wzorców.
Definicja wzorca
Wzorzec, to definicja oczekiwanej postaci dokumentu, np. faktury, WZ-tu
lub etykiety, np. etykiety na palety, towary lub etykiety adresowe.
Wzorzec łączy w sobie dowolne opisy i elementy graficzne, np. logo firmy
i dane pochodzące z bazy danych, np. nagłówków i pozycji faktur sprzedaży.
Definicja wzorca składa się z wartości pól z bazy danych, np. adres odbiorcy,
pól wypełnianych przez program, np. kwot do zapłaty oraz funkcji
np. wstawienie logo, kod kreskowy EAN 128.
Uprawnienia i wzorce obowiązujące
Każdy dokument może mieć wiele wzorców. Np. mogą istnieć wzorce faktur krajowych
i faktur eksportowych.
Operatorom można przydzielić uprawnienia do wzorców dokumentów. Operator może wybrać
i drukować tylko te dokumenty (dokumenty wg wzorców), do których ma uprawnienia.
Wzorce uporządkowane są następująco:
System, np. NA Sprzedaż
Rodzaj dokumentu, np. [FA] Faktura sprzedaży
Symbol wzorca , np. [PROFOPDF] PRO FORMA (PDF)
[LKKOPYTR] Kopia faktury
[LKGRAFTR] Faktura graficznie
Dodatkowo, można oznaczyć [*] wzorce domyślne, tj. te które program podpowiada do wydruku.
Patrz opis uprawnień:
Uprawnienia operatorów
2. Elementy budowy wzorca
2.1 Opis ogólny
Definicja wzorca zbudowana jest z następujących elementów:
o---------- Element -----------o
| 1 Rodzaj linii |
| 2 Pola danych |
| 3 Ramki |
| 4 Funkcje |
o------------------------------o
1. Rodzaj linii
Organizują strukturę dokumentu. Wskazują obszar nagłówka, stopki
i pozycji. Np. [T], [P], [D]
2. Pola danych
Są to wartości pochodzące z bazy danych lub obliczane w programie.
Polem danych jest np. numer dokumentu lub nazwa płatnika.
Pola danych pobierane są z tabeli pól i wpisywne do wzorca jako maski,
np. ş---- Firma--miasto ----ş
3. Ramki
Znaki stosowane do budowania tabelek i ramek na wzorcach
4. Funkcje
Pozwalają wstawiać elementy graficzne, np. logo firmy, wpisywać wyniki
obliczeń arytmetycznych, budować wydruki kaskadowe itp.
(patrz opis poniżej)
2.2 Rodzaj linii
Rodzaje linii definiują strukturę dokumentu. Wskazują obszar nagłówka
i stopki, które drukowane są jeden raz oraz miejsce pozycji dokumentu,
które drukowane są wiele razy, tyle ile jest pozycji dokumentu.
Rodzaje pozycji faktur sprzedaży
o---------------------------------------o
| T - tekst drukowany jeden raz |
| S - tekst drukowany na każdej stronie |
| P - pozycja sprzedaży |
| O - pozycja opakowań zwrotnych |
| D - pozycja opisu |
| R - rozliczenie zaliczki |
| # - linia komentarza |
o---------------------------------------o
Można wydzielić obszar nagłówka [T] i pozycji [P]. Można wskazać linie
powielane na kolejnych stronach [S], itd.
Znak rodzaju linii (T, S, P, D, ... itp.) wprowadzany jest w 1-szej kolumnie
każdej linii wzorca dokumentu. Znak ten określa charakter i funkcję linii
Znak rodzaju linii nie jest drukowany.
Lista dostępnych znaków rodzaju może być inna w różnych dokumentach
Program sprawdza układ i kolejność rodzajów pozycji na wzorcu.
* Pierwszy znak linii wzorca musi wskazywać rodzaj linii, np. [T]
* Niektóre rodzaje linii mogą wystąpić tylko raz na wzorcu.
Może być ich kilka, ale jedna po drugiej.
Są to rodzaje wskazujące pozycje dokumentu [P], np. pozycje sprzedaży
na fakturze sprzedaży. Na fakturze pozycji może być wiele.
Ale muszą być w jednej grupie.
* Maska pola musi być ograniczona znakiem początkowym i końcowym.
Cała maska musi mieścić się w jednej linii.
Błędne zapisy program sygnalizuje komunikatem, np.
---------------------------------------
Błąd składniowy w linii: 34
Niewłaściwy rodzaj linii
---------------------------------------
Szczególnym rodzajem linii jest [#] Linia komentarza. Pozwala opisać
przeznaczenie wzorca, wyjaśnić szczegóły techniczne definicji itp.
Poniżej podajemy rodzaje linii i ich funkcje we wzorcach:
Rodzaj linii: [T]
Służy do umieszczania opisów, ramek oraz danych z nagłówka dokumentu
W tej linii umieszcza się też stopki dokumentu, np. podsumowania,
np. sprzedaż netto wg różnych stawek PTU na fakturze
Rodzaj linii: [S]
Linia drukowana na każdej stronie, zawiera podstawowe informacje,
np. nazwa i numer dokumentu, data lub kolejny numer strony
Rodzaj linii: [P]
Linia drukowana tyle razy, ile pozycji posiada dokument. Zawiera dane
odczytywane z pozycji dokumentu. Jeśli na wzorcu umieści się 2 linie
rodzaju [P], to oznacza, że każda pozycja drukowana będzie w 2-ch liniach
Rodzaj linii: [O]
Zawiera
a) dane odczytywane z pozycji opakowań zwrotnych dokumentów
sprzedaży NA i zakupu ZO
b) dane opisu technologicznego operacji w ZP
Rodzaj linii: [D]
Zawiera
a) dane z pozycji dodatkowego opisu dokumentów sprzedaży NA
i dokumentów zakupu ZO
b) dane z pozycji dodatkowego opisu operacji w ZP
NOTE: Rodzaj [D] musi być bezpośrednio po pozycji [P].
Rodzaj linii: [K]
Zawiera dane pozycji korygowanej (Było) na fakturze sprzedaży NA
Rodzaj linii: [Z]
Zawiera linie dodatkowego opisu karty zlecenia w ZP
Rodzaj linii: [R]
Zawiera
a) dane ze specyfikacji operacji zlecenia produkcyjnego w ZP
lub
b) dane rozliczenia zaliczki na fakturze sprzedaży NA (końcowej)
Rodzaj linii: [B]
Zawiera dane ze specyfikacji materiałowej zlecenia produkcyjnego w ZP
Rodzaj linii: [#] linia komentarza
Dowolny komentarz, np. wyjaśnienie budowy wzorca dokumentu.
Widoczny tylko podczas redagowania wzorca. Pomijany na wydruku
2.3 Pole danych (maska)
Wartości pochodzące z bazy danych lub obliczane w programie, które umieszcza
się na wzorcu. Polem danych jest np. numer dokumentu lub nazwa płatnika.
Pola danych powiązane są z rodzajami lini, np. nazwa płatnika
w nagłówku (T) a nazwa sprzedawanego asortymentu, w pozycji (P)
Pola wpisuje się do wzorca jako maski, np. ş---- Firma--miasto ----ş
Definicje pól zapisane są w tabeli pól dla wzorców (opis jest dalej).
Pola danych można przekształcać przy użyciu funkcji TrExtLang.
Funkcje TrExtLang
2.4 Ramka
Znaki stosowane do budowania tabelek i ramek na wzorcach.
Pozwala na tworzenie tabelek i obramowań tekstu.
2.5 Funkcje TrExtLang
Służą do wyróżnienia fragmentów dokumentów poprzez zmianę koloru, kroju
i rozmiaru czcionki. Pozwalają też na wstawianie grafiki np. logo firmy.
Przy pomocy funkcji można także zmieniać strukturę wydruku,
np. pomijać linie (tCofnijWiersz), wykonywać obliczenia, itp.
Funkcje pozwalają drukować wiele powiązanych ze sobą dokumentów
(wydruki kaskadowe), drukować kod kreskowy, wysyłać e-mailem wydruki
dokumentów, np. ofert sprzedaży razem ze wskazanym plikiem (załącznikiem)
zawierającym np. aktualny katalog wyrobów.
Patrz szczegóły:
Wzorce Kaskadowe i składaneWzorce dokumentówWzorce etykiet
Funkcje wpisuje się do pliku wzorca klawiszem F2-t{}
lub wybiera z listy wyboru: F3-element > Funkcje > Specjalne
Funkcje zostały szczegółowo opisane w oddzielnym dokumencie:
Wzorce Funkcje TrExtLang
2.6 Bloki danych
Służą do wstawiania dodatkowych informacji bezpośrednio podczas drukowania.
Przykładem bloku danych jest zestawienie faktur dotychczas wystawionych
kontrahentowi, które jest automatycznie dołączane na koniec wydruku każdej
faktury.
Blok danych wywoływany jest specjalnym kodem umieszczonym na wzorcu
faktury, np. [oFVDEVELOP] (skrót od: Deweloper budowlany)
Bloki danych
[oFVDEVELOP] Kronika poprzednich faktur (developer budowlany)
[oDEKRET] Pieczątka dekretacyjna
Dokumenty poleceń księgowania
[oWYNIKIQA] Wyniki testów kontroli jakości QA
QA System kontroli jakości
[oOPCJEZAM] Opcje zamówionego produktu (zapisane w zam sprzedaży)
BOM Konfigurator produktu
[QRPay] Pole na wzorcu: s-- qr platnosc --s
Linia polecenia przelewu płatności zapisana w kodzie 2-wymiarowym 2D (QR)
Zawiera dane zapisane zgodnie z rekomendacją Związku Banków Polskich.
Dane QRPay można użyć w metodzie Skanuj i Płać przy użyciu urządzeń mobilnych.
Kod zawiera:
id odbiorcy
nr rachunku odbiorcy
kwota
nazwa odbiorcy
tytuł płatności (RefNo)
Warunki:
- forma płatności przelew [P]
- wypełniony nr rachunku firmy/oddziału
w polu: s--------- Rachunek - numer -----------s)
- kwota > 0.00
NOTE:
Dodatkowe informacje można także wstawić do wydruku przy użyciu funkcji.
Np. funkcje ţRekord{}, ţKontakt{}, ţSłownie{}, itp.
Funkcje TrExtLang
2.7 Wstawianie elementów graficznych
W dokumentach można umieścić elementy graficzne. Służy do tego funkcja: ţWstawObraz{}
Elementy graficzne mogą znajdować się na stronach internetowych:
ţWstawObraz{https://www.tres.pl/themes/tres/assets/images/logo.png}
Funkcja: tWstawObraz pozwala umieścić w tle wydruku np. grafikę papieru firmowego.
Funkcja: tPrzezroczystość pozwala wstawić znak wodny (en: Digital watermark)
tj. obraz graficzny nałożony na inny obraz graficzny.
Wzorce Funkcje TrExtLang
2.8 Drukowanie kodów kreskowych
Kod kreskowy można umieścić na wszystkich dokumentach i etykietach,
których postać można definiować (wg wzorców), np. na fakturach sprzedaży,
zamówieniach, specyfikacji wysyłki, dokumentach rozchodu itp.
Wzorce dokumentów PrzykładyWzorce etykiet Przykłady
Także pojedyńcze kody, np. kody kreskowe identyfikujące pracowników,
asortyment, miejsca składowania, itp. można drukować z użyciem mechanizmu wzorców.
Kody kreskowe umieszcza się na wzorcach przy pomocy funkcji:
EAN 13 - ţEan13{ean13;[grubość kreski];[wysokość]}
EAN 128 - ţEan128{tekst;[grubość kreski];[wysokość]}
DataMatrix - ţDataMatrix{şIndeks towaru şşNumer partii şş-- Ilosc ---ş;}
QR Code - ţQR{https://www.tres.pl/produkty/ş---EAN13---ş; 50;}
Wzorce Funkcje TrExtLang
3. Tabele pól dla wzorców
Aby ułatwić redagowanie wzorca, wiele pól danych (masek) zostało
zgromadzone w tabelach pól dla wzorców. Oddzielne tabele znajduja się
w poszczególnych systemach (modułach) i zawierają pola tam stosowane.
Patrz szczegóły:
Pola dla wzorców. Systemy. OpisPola dla wzorców MG
Np. w systemie MG są pola: magazyn, ilość rozchodu, miejsce składowania, itp.
Takie pola można umieszczać na dokumentach w systemie MG.
Pola (maski) zapisane są w tabelach, w poszczególnych systemach, np.
MG > Tabele > Pola danych dla wzorców [MG_TWZ20]
Wzorce w Trawers ERP - Skrócony Przewodnik1. Czym są wzorce
Wzorzec to definicja treści i wyglądu dokumentu lub etykiety (np. faktury, WZ, etykiety towarowej).
Łączy teksty, elementy graficzne i dane z bazy Trawers w jeden szablon,
który można drukować lub wysyłać.
Pliki wzorców: format XML
Edytor: Edytor wzorców dokumentów (menu programu)
Gotowe wzorce: dostępne na `https://ftp.tres.pl/`
2. Elementy wzorca
| Nr | Element | Opis | Przykład |
| -- | ------------------- | ----------------------------------------------------------------------------- | --------------------------------------- |
| 1 | Rodzaj linii | Określa miejsce i sposób drukowania (nagłówek, stopka, pozycja itd.) | `[T]` nagłówek, `[P]` pozycja sprzedaży |
| 2 | Pole danych (maska) | Dane z bazy lub obliczenia programu | `ş---- Firma--miasto ----ş` |
| 3 | Ramka | Znaki do tworzenia tabelek/obramowań | `o-----` |
| 4 | Funkcje | Polecenia specjalne (grafika, obliczenia, zmiana czcionki, wydruki kaskadowe) | `ţWstawObraz{logo.png}` |
| 5 | Blok danych | Wstawiane dynamicznie zestawienia lub informacje dodatkowe | `[oFVDEVELOP]` kronika faktur |
| 6 | Elementy graficzne | Logo, tło, znak wodny | `ţWstawObraz{adres_URL}` |
| 7 | Kody kreskowe | EAN, DataMatrix, QR Code | `ţEan128{12345;2;50}` |
3. Rodzaje linii
| Kod | Funkcja | Uwagi |
| --- | -------------------------------------------------- | ----------------------------- |
| T | Nagłówek i stopki dokumentu | Drukowane jeden raz |
| S | Dane na każdej stronie | np. numer dokumentu, strona |
| P | Pozycje dokumentu | Powtarzane dla każdej pozycji |
| O | Pozycje opakowań zwrotnych lub opis technologiczny | |
| D | Dodatkowy opis pozycji | Musi być po `[P]` |
| K | Dane pozycji korygowanej | Faktury korygujące |
| Z | Opis karty zlecenia | Produkcja |
| R | Rozliczenie zaliczki lub specyfikacja operacji | |
| B | Specyfikacja materiałowa | Produkcja |
| # | Komentarz techniczny (nie drukuje się) | |
Zasady:
* Pierwszy znak w linii = kod rodzaju linii
* Niektóre kody mogą wystąpić tylko raz w grupie (np. [P])
* Maska pola musi mieścić się w jednej linii
4. Pola danych (maski)
* Pobierane z tabel pól wzorców (w każdym module inne)
* Mogą być przekształcane funkcjami TrExtLang
* Przykład:
```
ş---- Data wystawienia ----ş
ş--- Nr faktury ---ş
```
5. Funkcje TrExtLang - przykłady
| Funkcja | Działanie |
| --------------------- | ----------------------- |
| `ţWstawObraz{URL}` | Wstawia grafikę lub tło |
| `tPrzezroczystość` | Znak wodny |
| `ţEan128{tekst;gr;k}` | Kod kreskowy EAN 128 |
| `ţQR{adres;50}` | Kod QR |
| `tCofnijWiersz` | Pomija linię wydruku |
| `ţSłownie{kwota}` | Kwota słownie |
6. Bloki danych - przykłady
| Kod | Opis |
| -------------- | ------------------------------- |
| `[oFVDEVELOP]` | Kronika faktur kontrahenta |
| `[oDEKRET]` | Pieczątka dekretacyjna |
| `[oWYNIKIQA]` | Wyniki kontroli jakości |
| `[QRPay]` | QR do płatności (Skanuj i Płać) |
7. Najczęstsze błędy
| Problem | Przyczyna | Rozwiązanie |
| --------------------------- | ----------------------------------- | --------------------------------- |
| Niewłaściwy rodzaj linii | Brak kodu w 1. kolumnie lub zły kod | Sprawdź strukturę wzorca |
| Pole danych się nie drukuje | Zła maska lub brak pola w tabeli | Użyj poprawnej maski z tabel pól |
| Funkcja się nie wykonuje | Błąd w składni (`ţ`, `{}`) | Sprawdź poprawność zapisu funkcji |
8. Przykład prostego wzorca faktury
```
T ş---- Faktura sprzedaży ----ş
T Data: ş--- Data wystawienia ---ş Nr: ş--- Nr faktury ---ş
S Strona: ş--- Nr strony ---ş
P ş--- Nazwa towaru ---ş ş--- Ilość ---ş ş--- Cena ---ş
D Opis: ş--- Opis towaru ---ş
T Razem do zapłaty: ş--- Kwota brutto ---ş
```
NOTE: 08/2025 Na bazie podanego opisu elementów wzorców ChatGPT4
Utworzył edytor przeglądarkowy. FS uzupełnił rozwiązanie w dialogu z Chatem.
Ocena FS: #00053812 Prawie działa. Dobrze rozumie mechanizm wzorców.
Możemy zbudować Edytor do redagowania wzorców z pomocą chata w T7.
Wygenerowany edytor jest napisany w HTML+JavaScript więc tam będzie działał.
Trzeba dodać do SOA zapytania dotyczące wzorców i pól dla wzorców.
Chat zaproponował edytor na podstawie opisu dla użytkownika, to zbyt mało,
nie wszystkie reguły są tam opisane.
Aby utworzyć edytor za pomocą chata to trzeba:
a) napisać prompt w którym dokładnie określamy reguły jak działa mechanizm
b) pytać chata krok po kroku i na bieżąco korygować jego działanie