Rys. 1
eDokumenty umożliwiają obsługę szablonów pism. Procedura ich tworzenia jest prosta, a sam system zawiera kilka predefiniowanych szablonów. Szablony dostępne są w każdym miejscu w systemie, w którym możemy stworzyć nowy dokument z menu Nowy / Utwórz z szablonu -> wybór właściwego szablonu.
Praca z szablonami, zarządzanie nimi oraz sposób ich tworzenia opisana jest w sekcji dotyczącej szablonu pisma firmowego?.
W procesie tworzenia szablonów bardzo przydatna jest możliwość wykorzystania znaczników, które to podczas generowaniu dokumentu z szablonu są zamieniane na właściwe dane zarejestrowane w systemie. System zawiera szereg predefiniowanych znaczników. Ich lista widoczna jest w oknie dostępnym ze ścieżki Ustawienia / Panel sterowania/ Szablony dokumentów/ zakładka Import znaczników
Rys. 1
Znaczniki, które uznamy za użyteczne w tworzeniu szablonów należy przenieść do zakładki Znaczniki szablonów poprzez ich zaznaczenie i użycie przycisku Zaimportuj znacznik. Znaczniki znajdujące się w tej zakładce są dostępne dla operatora, z poziomu edytora tekstu, do wykorzystania podczas tworzenia szablonów.
Rys. 2
Rys. 3
W przypadku gdy lista jest pusta lub wymaga aktualizacji należy wykonać operację Pobierz listę , spowoduje to udostępnienie do wykorzystywania wszystkich znaczników znajdujących się w wyżej opisanej zakładce Znaczniki szablonów z okna Szablony dokumentów . Wstawienie wybranego znacznika do dokumentu następuje poprzez wykonanie operacji Wstaw znacznik .
Szablony implementują standardowy mechanizm znaczników, znany z innych systemów. Tworzenie szablonu polega więc na tworzeniu dokumentów i wstawianiu w odpowiednie miejsca znaczników. Tak utworzony szablon można bezpośrednio zapisać w systemie do ponownego użycia bezpośrednio z poziomu edytora tekstu.
Dostepne są 3 rodzaje znaczników:
Na start dostępna jest lista predefiniowanych znaczników, które należy zaimportować do aktywnej listy. Po instalacji dostępnych jest kilka znaczników których można używać od razu
W praktyce wystarczy się posługiwać kilkoma znacznikami aby utworzyć większość szablonów. Takimi znacznikami są np.:
#JEDNOSTKA.MIASTO# dnia: #DATA.DZISIAJ#
Znak sprawy: #SPRAWA.SYMBOL#
#JEDNOSTKA.NAZWA#
#PRACOWNIK.JEDNOSTKA_ORG#
#JEDNOSTKA.ULICA# #JEDNOSTKA.NUMER_DOMU#
#JEDNOSTKA.KOD# #JEDNOSTKA.MIASTO#
#KONTAKT.SAM_ADRES=bloczek#
Wezwanie do zapłaty
Wzywam Pana/Panią #KONTAKT.NAZWA# legitymującego się numerem PESEL: #KONTAKT.PESEL#
do uregulowania zaległej płatności w wysokości:
#KONTAKT.SALDO#
Z poważaniem
#PRACOWNIK.STANOWISKO#
#PRACOWNIK.IMIE_NAZWISKO#}}}
Z powyższego szablony obsługiwanymi znacznikami są :
Istnieje możliwość zdefiniowania reszty użytych w powyższym szablonie znaczników przez wdrożeniowca lub programistę.
Oprócz tego istnieje możliwość tworzenia własnych znaczników na podstawie struktury bazy danych i tworzonych cech. Poniżej opisany jest mechanizm tworzenia dla każdego rodzaju znaczników.
Format takiego znacznika to #NAZWA_TABELI.NAZWA_POLA#.
W celu zdefiniowania takiego znacznika należy na oknie "Szablony dokumentów" na zakładce "Znaczniki dokumentów" wybrać z górnego menu przycisk "Nowy znacznik"
Rys. 1
Poniżej znajduje się przykład znacznika wyciągającego pole opis z tabeli dokumentów.
Rys. 2
Sposób definiowania tego typu znacznika jest bardzo podobny do poprzedniego z różnicą ostatniego pola "Cecha:"
Definiowania znacznika z pomocnikiem (helperem):
Górna część definicji znacznika pozostaje taka sama jak w poprzednich. Nowością jest lista predefiniowanych pomocnych znaczników (helperów). Jest to najprostszy sposób definiowania znacznika gdyż nie wymaga znajomości tabel jednak ma ograniczenie gdyż pomocnik jest definiowany tylko przez programistę.
w przypadku tego pola znacznik może produkować dowolnie zdefiniowaną treść jak np.: generowanie tabelki z wykazem zadłużenia.
Znaczniki z helperów mogą (nie wszystkie) udostępniać różne sposoby wyświetlania. Aby spowodować wyświetlenie odpowiedniego formatowania w obrębie znacznika dodajemy odpowiedni token np. #KONTAKT.ADRES=bloczek#
Znacznik ten daje największe możliwości jeśli chodzi o pobieranie danych z bazy.
Przykład wykorzystania tego znacznika
Jako przykład niech posłuży pobranie numeru nip jednej ze stron umowy. Zapytanie wygląda następująco:
select nip_ _ _ from contacts where contid = (select toctid from contract where ctrcid={CONTEXT})
Kroki tworzenia takiego zapytania są następujące:
Podzapytanie tworzymy podobnie jak zwykłq zapytanie sql ale jako warunek 'WHERE' wybieramy z listy kontekstów konkretny kontekst. W naszym przypadku będzie to kontekst 'Umowa'. Po wybraniu tego kontekstu w miejsce kursora w polu zapytania sql pojawi się definicja ctrcid={CONTEXT}. Aby zmienić kontekst usuwamy fragment ctrcid={CONTEXT} i ponownie wybieramy kontekst.
Aby obsłużyć brak danych i wypisać własny komunikat należy użyć formy np.
SELECT COALESCE((SELECT nip_ _ _ FROM contacts WHERE contid=c.toctid)::text , 'brak numeru nip') FROM contract c WHERE ctrcid={CONTEXT}
Powodzenia.
UWAGI
W przypadku szablonów tworzonych w formacie rtf należy pamiętać, iż możliwe jest aby tekst w znaczniku był formatowany tak jak sobie tego życzy użytkownik. Znacznik można standardowo sformatować poprzez pogrubienie itd, jednak formatowaniu musi być poddany cały znacznik wraz z znakami '{{' lub '#'.
Nowe znaczniki:
WINDYKACJA.DATA.WYMAGALNOSCI.ZOBOWIAZANIA
KONTAKT.NUMER.NIP
WINDYKACJA.CENA_OBLICZONA
WINDYKACJA.CENA_OBLICZONA_SLOWNIE
WINDYKACJA.WIERZYCIEL.NUMER_NIP
WINDYKACJA.WYDATKI_TYPY_KOSZTOW
WINDYKACJA.WYDATKI_DATY_KOSZTOW
WINDYKACJA.WYDATKI_KWOTY_KOSZTOW
WINDYKACJA.PRZYCHOD_DATY_WPLYWU
WINDYKACJA.PRZYCHOD_KWOTY_WPLYWU
WINDYKACJA.SUMA_ZADLUZENIA_SLOWNIE
WINDYKACJA.DLUZNIK_NUMER_KRS
WINDYKACJA.DLUZNIK_NUMER_NIP
WINDYKACJA.DLUZNIK_NUMER_REGON
WINDYKACJA.ZYSK_BRUTTO
WINDYKACJA.ZYSK_NETTO
WINDYKACJA.ZYSK_VAT
SPRAWA.SYMBOL_SPRAWY_NADRZEDNEJ
WINDYKACJA.DATA_WYSTAWIENIA_PIERWSZEJ_FAKTURY
WINDYKACJA.DATA_WYSTAWIENIA_OSTATNIEJ_FAKTURY
PISMO.OPIS