Tworzenie pism w formacie PDF

Generowanie plików w formacie PDF

Szablon plikowy dla którego źródłem danych jest dokument w formacie PDF może być używany np. przy generowaniu certyfikatów potwierdzających uczestnictwo w szkoleniach. Za pomocą zewnętrznych programów do tworzenia dokumentów, Użytkownik może stworzyć własny wzór pisma (wykorzystujący tło z załączonego do szablonu pliku), do którego będą podstawiane znaczniki oraz tekst znajdujące się w treści szablonu.

Użytkownik musi samodzielnie określić parametry generowanego pisma, takie jak format wydruku, orientacja strony i pozycje znaczników (legenda wraz z konkretnymi objaśnieniami jest dostępna z poziomu zakładki „Treść” szablonu typu plik).

Definiując cały plik PDF, możliwe jest używanie parametrów:

• orientation orientacja strony P – pionowo, L – poziomo (domyślnie P)
• format Format strony np. A4 (domyślnie A4)
• boxx Przy wydrukach seryjnych: ile mm poziomo ma jeden blok (domyślnie 105)
• boxy Przy wydrukach seryjnych: ile mm pionowo ma jeden blok (domyślnie 40)
• countx Przy wydrukach seryjnych: ile bloków poziomo na stronie (domyślnie 2)
• county Przy wydrukach seryjnych: ile bloków pionowo na stronie (domyślnie 7)
• font domyślna czcionka tekstów w dokumencie np.dejavusans (domyślnie dejavusans)
• size domyślna wielkość czcionki tekstów w dokumencie (domyślnie 12)
• color domyślny kolor tekstów w dokumencie np.00FF00 zielony (domyślnie 000000)
• margint wysokość górnego marginesu w mm (domyślnie 0)
• marginl szerokość lewego marginesu w mm (domyślnie 0)
• marginb wysokość dolnego marginesu w mm (domyślnie 0)
• pgtemplate Przy wydrukach seryjnych: liczba stron szablonu (domyślnie 1)
• rotate Obracaj o 180° strony o numerach z określonym krokiem np. 1 – obraca pierwszą z danej serii; 1,2 – obraca pierwszą i drugą z danej serii
• step Przy obracaniu definuje co ile stron ma następować obrót strony (liczba stron w serii) (domyślnie 2)
• dir_rtl Ustawiaj bloki od prawej do lewej dla określonych stron np. 1 – dla pierwszej w danej serii; 1,2 – dla pierwszej i drugiej w danej serii
• dir_btt Ustawiaj bloki od dołu do góry dla określonych stron np. 1 – dla pierwszej w danej serii; 1,2 – dla pierwszej i drugiej w danej serii

Definiując tekst w pliku PDF, możliwe jest używanie parametrów:

• Dla plików PDF zdefiniuj tekst do wstawienia np.##x=200;y=300;size=12;font=Times#Tekst. Dostępne:
• font czcionka np. dejavusans
• size wielkość czcionki np. 12
• x współrzędna X w mm od lewego, górnego narożnika (domyślnie 50)
• y współrzędna Y w mm od lewego, górnego narożnika (domyślnie 50)
• width szerokość bloku (domyślnie nieustawiona)
• height wysokość bloku (domyślnie nieustawiona)
• page nr strony (domyślnie 1)
• color kolor np. FF0000 (czerwony)
• bold pogrubienie; gdy true – tekst pogrubiony; gdy false – tekst zwykły (domyślnie false)
• italic kursywa; gdy true – tekst pochyły; gdy false – tekst zwykły (domyślnie false)
• align wyrownanie (działa tylko przy ustawionym parametrze width); gdy L – lewa; gdy R – prawa; gdy C – wyśrodkowanie (domyślnie nieustawione)
• barcode drukuj zamiast tekstu kod kreskowy np. EAN13, C128, EAN8, POSTNET
• barcodewidth szerokość kodu kreskowego (domyślnie 100)
• barcodeheight wysokość kodu kreskowego (domyślnie 30)
• onetime pojedynczy tekst umieszczany niezależnie od seryjnych bloków. Jego wartość oznacza na której stronie ma znajdować się dany tekst. Wartość dodatnia liczona jest od początku dokumentu (np. 1 to pierwsza strona), wartość ujemna liczona jest od końca dokumentu (np. -1 to ostatnia strona)

Należy pamiętać, że dodawany plik PDF musi posiadać klasę tcpdf 4.0 lub wyższą.

Określając parametry szablonu należy pamiętać o następujących kwestiach:

• Obsługiwane są cztery czcionki określane w parametrze tekstu (font=x):

Ponadto, jeżeli parametr czcionki nie zostanie określony lub zostanie wpisana nieprawidłowa/nieobsługiwana czcionka, wtedy zostanie podstawiona domyślna czcionka dejavusans.

• Możliwe jest wgranie nowych czcionek w formacie .ttf. W parametrze „font=x” Użytkownik może podać nazwę czcionki. Nowa czcionka powinna być zapisana jednowyrazowo (bez spacji).
• Wgrywane przez Użytkownika czcionki muszą mieć wbudowaną obsługę dodatkowych parametrów: pogrubienia, kursywy etc. W innym wypadku analogiczne parametry dostępne w edytorze treści pdf w systemie mogą nie być obsługiwane.
• Parametry czcionek są również uwzględnianie przy podstawianych znacznikach w tekście.

Wgrywanie własnych czcionek nie jest standardową usługą systemu. Możliwość wgrania czcionki musi być indywidualnie rozpatrzona i skonsultowana z pracownikiem firmy Bs4 i może podlegać dodatkowej opłacie za konfigurację.

• Obsługiwane są znaki specjalne HTML tylko wtedy, gdy zostaną bezpośrednio skopiowane do generowanej treści w szablonie. Znaki podawane za pomocą kodu szesnastkowego czy dziesiętnego nie są obsługiwane. Część znaków specjalnych nie jest obsługiwana w połączeniu z konkretnymi znakami. Jeżeli wybrany znak nie jest wyświetlany, zaleca się wybranie innej czcionki.