Wprowadzenie do wydruków (Altum, Enterprise, XL)

W aplikacji Comarch POS dostępne są standardowe wydruki, które można modyfikować i dostosowywać do wymagań Klienta. Definicje wydruków dostępnych na stanowisku POS znajdują się standardowo w lokalizacji: C:\Retail\POS2\Printouts.

• Korekty faktury zaliczkowej
• Faktury zaliczkowej
• Protokołu przyjęcia zwrotu/reklamacji
• Noty debetowej
• Przesunięcia międzymagazynowego
• Operacji kasowych
• Zamknięcia zmiany kasjera
• Protokołu rozbieżności
• Paragonu
• Korekty ilościowej paragonu
• Faktury sprzedaży
• Korekty ilościowej faktury sprzedaży
• Zamówienia sprzedaży
• Oferty sprzedaży
• Tax Free

• Data.xml
• Layout.xml
• logo.png
• Styles.xml

Dodawanie nowej definicji wydruku dokumentu

• Printouts – zawiera informacje o podpiętych wydrukach do danego stanowiska POS, a także aktywności danego wydruku i ilości kopii jakie ma tworzyć
• PrintoutAvailability – zawiera informacje o dostępnych definicjach wydruków i ich miejscu w systemie

Aplikacja Printouts Editor

Z górnego menu dostępne są przyciski w sekcji Baza:

• [Połączenie] – otwiera okno z danymi do połączenia z bazą, należy uzupełnić:
  • Nazwę serwera – serwer SQL z bazą danych POS
  • Nazwę użytkownika – nazwa użytkownika SQL
  • Hasło – hasło użtkownika SQL
  • Nazwę bazy danych – nazwa zrestorowanej bazy POS

• [Wczytaj Bazę] – umożliwia bezpośrednie wczytanie bazy z wybranej lokalizacji. Należy wybrać plik o rozszerzeniu .mdf

• [Nowy] – umożliwia tworzenie nowego wydruku, po wybraniu przycisku otwiera się standardowy format wydruku składający się z kilku zakładek

• [Otwórz] – otwiera do podglądu/modyfikacji wybraną definicję wydruku
• [Zapisz] – zapis wprowadzonych zmian w otwartym wydruku

Podgląd definicji wydruku

• Data – prezentowane są dane z pliku Data.xml
• Layout – prezentowane są dane z pliku Layout.xml
• Style – prezentowane są dane z pliku Style.xml
• Parameters – należy wprowadzić parametr wydruku, jest to ID odpowiedniego dokumentu istniejącego w bazie POS

Zakładka Parameters

Parametrem wydruku jest ID dokumentu z tabeli Documents.TradeDocuments z bazy POS, ponieważ podgląd jest możliwy na przykładowym dokumencie.

Po załadowaniu parametrów wydruku, na konkretnym dokumencie widzimy jakie dane wyświetlane są na podglądzie wydruku. Z tego poziomu jesteśmy w stanie modyfikować dane w zakładkach Data, Layout i Style.

• Szczegóły faktury sprzedaży
• Szczegóły paragonu
• Szczegóły operacji kasowo-bankowej
• Szczegóły korekty ilościowej faktury sprzedaży
• Szczegóły korekty ilościowej paragonu
• Szczegóły zmiany kasjera
• Raport dzienny
• Szczegóły reklamacji sprzedaży
• Szczegóły MM-
• Szczegóły dokumentu PRP

Nagłówek aplikacji

• Kod(pole wymagane) – unikalne oznaczenie wydruku
• Nazwa– nazwa danego wydruku, maksymalna długość nazwy to 255 znaków
• Organizacja– organizacja, do której zostanie przypisany wydruk
• Kanał sprzedaży– kanał sprzedaży, dla którego będzie dostępny wydruk

• Kod – FS
• Nazwa – Wydruki handlowe – faktura sprzedaży
• Organizacja – 00000
• Kanał sprzedaży – DK
• KStore – Documents à POS à Printouts (ścieżka w repozytorium wiedzy, w której przechowywane są wydruki)
• Liczba kopii – 1

Obszar roboczy

• Widok– pozwala na wskazanie widoku aplikacji odpowiadającego danemu obszarowi stanowiska POS, w którym dany wydruk będzie wykorzystany.

• Dla cyfrowych lub papierowych wydruków– umożliwia wskazanie czy wydruk ma być cyfrowy czy papierowy, jeden wydruk może być dodany zarówno jako cyfrowy jak i papierowy
• Domyślny– wydruk będzie traktowany jako domyślny dla wskazanego kanału sprzedaży lub organizacji
• Dostępne przy zatwierdzaniu– zaznaczenie parametru powoduje, że wydruk jest dostępny podczas zatwierdzania dokumentu na stanowisku POS. Jeżeli dla danego widoku dostępnych jest wiele wydruków, użytkownik musi wybrać który ma zostać wydrukowany.

• Lista dokumentów handlowych - możliwy wydruk dokumentu paragonu, faktury sprzedaży, korekty ilościowej paragonu, korekty ilościowej faktury
• Podgląd dokumentu uruchomiony z listy dokumentów handlowych – wydruk dokumentu który aktualnie jest w podglądzie. możliwy wydruk dokumentu paragonu, faktury sprzedaży, korekty ilościowej paragonu, korekty ilościowej faktury.
• Zatwierdzenie dokumentu handlowego - w zależności czy instalacja jest polska czy nie polska (przykładowo we Francji i Niemczech nie ma fiskalizacji na drukarce fiskalnej) zostanie podjęta następująca akcja:
  • Jeśli zatwierdzimy paragon czy fakturę na instalacji polskiej, wydruk zostanie uruchomiony albo na drukarce fiskalnej (w przypadku paragonu) albo na zwykłej drukarce (w przypadku faktury).
  • Jeśli zatwierdzimy paragon czy fakturę na innej instalacji niż polska, wydruk paragonu i faktury zostanie uruchomiony na drukarce zwykłej.
• Zatwierdzenie dokumentu reklamacji - Dodatkowo wydruk reklamacji jest dostępny z poziomu listy reklamacji oraz z poziomu podglądu dokumentu.
• Zamknięcie dnia - w trakcie zamykania dnia po zatwierdzeniu zamknięcia uruchamiany jest wydruk
• Podsumowanie dnia w przypadku wybrania zamkniętego już dnia.
• Zatwierdzenie dokumentu KP/KW -  dodatkowo wydruk jest możliwy z poziomu podglądu dokumentu.
• Zatwierdzenie edycji dokumentu MM- -  dodatkowo wydruk jest możliwy z poziomu podglądu dokumentu.
• Przyjęcie towaru z dokumentu MM- - dodatkowo wydruk jest możliwy z poziomu podglądu dokumentu.

Wstęp

Źródło danych

Przykładowy plik Data.xml

<?xml version="1.0" encoding="utf-8"?>
<data>
  <setf>
    <set>
      <name>SummaryAmount</name>
      <query>
        SELECT
        FORMAT(Value,'N2','pl-PL') as Amount, c.Symbol as Currency
        from Configuration.Currencies c, [Documents].[TradeDocuments] ts
        join Documents.Payments dp on dp.DocumentId = ts.Id
        where ts.Id = {0} and c.IsSystem = 1
      </query>
    </set>      
    <set>
      <name>DocumentRates</name>
      <query>
        SELECT cvr.Name as Name,
        FORMAT(dva.NetValue,'N2','pl-PL') as NetValue,
        FORMAT(dva.GrossValue,'N2','pl-PL') as GrossValue,
        FORMAT(dva.VatValue,'N2','pl-PL') as Vat
        FROM Documents.VATAggregates dva
        JOIN Configuration.VATRates cvr ON cvr.id = dva.VATRateId
        where DocumentId={0}
      </query>
    </set>
  </setf>
</data>>

Parametry źródła danych

Układ wydruku

Wygląd wydruku

<font name="title" face="Arial" size="20" color="#9fc54c"/>

• name - określa nazwę czcionki
• face - nazwa kroju czcionki
• size - rozmiar w punktach
• color - kolor
• style - style czcionki. Może zawierać jedną (lub więcej wartości oddzielonych znakiem spacji) z wartośći bold, italic, underline.

<fonts>
        <font face="Trebuchet MS" size="10"/>
        <font name="title" face="Arial" size="20" color="#9fc54c"/>
        <font name="header" face="Tahoma" size="8" color="#999999"/>
        <font name="summary_value" face="Trebuchet MS" size="15" color="#9fc54c" style="bold"/>
</fonts>

<selektor>
        <reguła/>
        <reguła/>
        [...]
</selektor>

<p>
        <margin top="5"/>
</p>

<p>
        <text font="normal"/>
</p>
<p class="title">
        <text font="title"/>
</p>

Układ wydruku

• Zawartość - opisuje jakie elementy podrzędne można umieścić wewnątrz danego elementu.
• Parametry - opisuje wszystkie dostępne atrybuty jakie można dodać do elementu i co oznaczają.
• Elementy stylujące - zawiera listę selektorów, które dopasowują dany element w pliku Styles.xml
• Elementy podrzędne - opcjonalna sekcja opisująca elementy, które mogą wystąpić tylko wewnątrz danego elementu. Dla każdego elementu podrzędnego zachowany jest układ opisu taki sam jak dla głównego elementu.
• Przykład - zawiera fragment kodu z przykładowym wykorzystanie opisywanego elementu.

Elementy

Barcode

<barcode type="Code 93"><data set="DocumentHeader" var="EAN" /></barcode>

Body

<?xml version="1.0" encoding="utf-8"?>
<document>
        <title><data set="DocumentHeader" var="NumberString" /></title>
        <body>
                 [zawartość wydruku]
        </body>
</document>

Br

<p>Tekst<br/> w wielu<br/>liniach</p>

Data

<barcode type="Code 93"><data set="DocumentHeader" var="EAN" /></barcode>

Footer

<?xml version="1.0" encoding="utf-8"?>
<document>
        <footer page="last">
                 <p>Stopka ostatniej strony</p>
       </footer>

Header

<?xml version="1.0" encoding="utf-8"?>
<document>
       <header>
                 <p>Nagłówek</p>
        </header>
        <body>
[...]

Horizontal i Section

Horizontal

Section

Przykład dla Horizontal i Section

<horizontal>
        <section><p class="sign">Dokument wystawił</p></section>
        <section weight="0,1"></section>
        <section><p class="sign">Towar wydał</p></section>
        <section weight="0,1"></section>
        <section><p class="sign">Data odbioru</p></section>
        <section weight="0,1"></section>
        <section><p class="sign">Towar odebrał</p>
<p class="footer">Strona<pageNumber/> z <numOfPages/></p></section>

</horizontal>

Hr

<p>tekst1</p>
<hr />
<p>tekst2</p>

If

Test

True

False

Przykład dla If

<if>
        <test><data set="DocumentsPositions" var="Id" /> &lt; 3123</test>
        <true>
                 <horizontal>
                         <section weight="2">
                                  <p><data set="DocumentsPositions" var="Name" /></p>
                                  <p><data set="DocumentsPositions" var="Barcode" /></p>
                         </section>                         <section weight="3">
                                  <p><data set="DocumentsPositions" var="Name" /></p>
                                  <p><data set="DocumentsPositions" var="Barcode" /></p>
                         </section>                 </horizontal>        
</true>        
<false>
                 <p><data set="Header" var="CompanyName" /></p>
        </false>
</if>

Image

<image path="logowms.png" />
<image set="Header" var="Logo" />

PageNumber

<footer>
        <p class=”footer”>Strona<pageNumber/> z <numOfPages/></p>
</footer>

P

<p class="date">Data wystawienia:&#160;<data set="DocumentHeader" 
var="DocumentCreationDate" /></p>

RowNumber

<table set="DocumentPositions">
        <column weight="2" description=”N." class="number">
                 <rowNumber />
        </column>
        <column weight="12" description=”[Kod] Nazwa towaru">
                 [<tableData var="Code" />] <tableData var="Name" />
        </column></table>

StaticTable

Head

Column

Row

Cell

Przykład

<staticTable class="customer">
        <head>
                 <column weight="1"><p class="tableHead">Odbiorca</p></column>
                 <column weight="1"><p class="tableHead">Nabywca</p></column>
        </head>
        <row>
                 <cell>
                         <p class="customer"><data set="DocumentHeader" var="CustomerName" /><br/>
                         <data set="DocumentHeader" var="Street" /><br/>
                         <data set="DocumentHeader" var="ZipCode" />&#160;<data set="DocumentHeader" var="City" /><br/>
                         IVA: <data set="DocumentHeader" var="Tin" /><br/>
                         </p>
                 </cell>
                 <cell>
                        <p class="customer"><data set="DocumentHeader2" var="CustomerName" /><br/>
                         <data set="DocumentHeader2" var="Street" /><br/>
                         <data set="DocumentHeader2" var="ZipCode" />&#160;<data set="DocumentHeader2" var="City" /><br/>
                         IVA: <data set="DocumentHeader2" var="Tin" /><br/>
                         </p>
                 </cell>
        </row>
        <row>
                <cell collspan="2">
                         <p>...</p>
                 </cell>
        </row>
</staticTable>

Table

Column

Dynamic-columns

If

TableData

Przykład 1 – Kolumny statyczne i warunkowe

<table set="DocumentPositions">
        <column weight="2" description="N." class="number">
                 <rowNumber />
        </column>
        <column weight="12" description="[Kod] Nazwa towaru">
                 [<tableData var="Code" />] <tableData var="Name" />
        </column>
                 <if>
                         <test>
                                  <hasColumn var="Column15" /> = 1
                         </test>
                         <true>
                                  <column weight="2" description="Test" class="number">
                                          <tableData var="Column15" />
                                  </column>
                         </true>
                 </if>
        <column weight="4" description="Ilość" class="number">
                 <tableData var="RealizedQuantity" />
        </column>
        <column weight="4" description="Jm. (podstawowa)">
                 <tableData var="BasicUnitSymbol" />
        </column>
        <column weight="4" description="Ilość" class="number">
                 <tableData var="SecondaryQuantityRealized" />
        </column>
        <column weight="4" description="Jm. (pomocnicza)">
                 <tableData var="SecondaryUnitSymbol" />
        </column>
</table>

Przykład 2 - Kolumny dynamiczne

<table set="DocumentPositions">
        <column weight="2" description="N." class="number">
                <rowNumber />
        </column>
        <column weight="12" description="[Kod] Nazwa towaru">
                 [<tableData var="Code" />] <tableData var="Name" />
        </column>
        <dynamic-columns weight="4" description="Waluta {{1}}" names="Currency(.+)">
                 <tableData var="{{0}}" /> {{1}}
</dynamic-columns>
</table>

Title

Wygląd wydruku

Atrybuty zawężające

• index="0" - dopasuje pierwszy wiersz w tabeli
• index="first" - dopasuje pierwszy wiersz w tabeli
• index="last" - dopasuje ostatni wiersz w tabeli
• index="5" - dopasuje szósty wiersz w tabeli
• index="2n" - dopasuje parzyste wiersze tabeli tzn. z indeksem równym 0,2,4... czyli wiersze pierwszy, trzeci, piąty...
• index="3n+1" - dopasuje wiersze z indeksem 1, 4, 7...
• index="3n+2" - dopasuje wiersze z indeksem 2, 5, 8...

Selektory

Barcode

Body

Cell

DataCell

Footer

HeadCell

Header

Hr

Image

P

Section

StaticTable

Table

Reguły

Background

• color - kolor tła elementu. Może on być w formacie #RRGGBB lub 0xRRGGBB lub 0xAARRGGBB

Border

• left - szerokość lewego obramowania.
• right - szerokość prawego obramowania.
• top - szerokość górnego obramowania.
• bottom - szerokość dolnego obramowania.
• color - kolor obramowania elementu. Może on być w formacie #RRGGBB lub 0xRRGGBB lub 0xAARRGGBB
• borderStyle - styl obramowania. Może przyjmować jedną z wartości:
  • dashdot
  • dashdotdot
  • dashlargegap
  • dashsmallgap
  • dot
  • none
  • single

• borderLeft
• borderRight
• borderTop
• borderBottom

• width - szerokość obramowania
• color - kolor obramowania
• borderStyle - styl obramowania

Fit

• width - szerokość elementu
• height - wysokość elementu

Margin

• left - lewy margines
• right - prawy margines
• top - górny margines
• bottom - dolny margines

Page

• orientation - orientacja strony
• size - rozmiar strony
• width - szerokość strony
• footer-distance - odległość stopki od dołu strony
• header-distance - odległość nagłówka od góry strony

Text

• align - wyrównanie tekstu. Przyjmuje jedną z wartości:
  • right - wyrównanie do prawej
  • left - wyrównanie do lewej
  • justify - wyjustowanie tekstu
  • center - wyśrodkowanie tekstu
• indent - wcięcie pierwszej linii tekstu.
• leftIndent - wcięcie tekstu z lewej.
• rightIndent - wcięcie tekstu z prawej.
• font - nazwa fontu zdefiniowana wcześniej w sekcji fonts.
• color - kolor tekstu. Może on być w formacie #RRGGBB lub 0xRRGGBB lub 0xAARRGGBB

Width

• percentage - procentowa szerokość elementu bazująca na szerokości elementu-rodzica.