Zmiany pomiędzy wersją 18 and wersją 19 dla UserGuide/AdvancedConfiguration/CreatingTemplates

Pokaż
Ignoruj:
Data i czas:
12/02/09 11:54:39 (14 years temu)
Autor:
jbedlicka (IP: 213.227.67.33)
Komentarz:

--

Legend:

Bez zmian
Dodane
Usunięte
Zmienione
  • UserGuide/AdvancedConfiguration/CreatingTemplates

    v18 v19  
    6262W oknie definicji takiego znacznika mamy do dyspozycji następujące pola:  
    6363 
    64  *  "Znacznik:" powinno określać definicje znacznika z uwzględnieniem zasad - kolejne człony nazwy oddzielamy kropką i wszystko piszemy z dużą literą[[BR]] 
    65  *  "Opis:" określa opisową definicje znacznika[[BR]] 
    66  *  "Tabela:" określa tabelę bazy z której będą pobierane dane przy tworzeniu dokumentu[[BR]] 
    67  *  "Klucz główny:" odnosi się do nazwy klucza głównego z tabeli na która wskazuje pole "Tabela". Jeśli pole tabela wskazuje na widok należy wskazać klucz główny w tym widoku[[BR]] 
    68  *  "Kolumna danych:" wskazuje na interesujące nas dane które chcemy aby znalazły się w miejscu pojawienia się znacznika w szablonie[[BR]] 
    69  *  "Kontekst" w przypadku wyboru tabel lub widoków które są specyficzne różne od głównych: [[BR]] * podmioty [[BR]] * documents [[BR]] * users [[BR]] * organization_units [[BR]] * orgtree_view [[BR]] * processes [[BR]] * vindication.vind_proc [[BR]] należy wyspecyfikować kontekst i tak na przykład aby pobrać dane z widoku vindication.vind_proc_view np.: kolumne vat należy wybrać kontekst sprawy windykacyjnej [[BR]] 
    70  *  Pole "Formatowanie" w przypadku jeśli chcemy aby wymusić na pobieranych danych formatowanie określonego typu tzn. jeśli pobierana jest data w formacie 2000-01-01 08:00:00 jednak chcemy aby tylko pobrać z tego datę wtedy należy wybierać formatowane[[BR]] 
    71 [[BR]] 
     64 *  ''Znacznik'' - powinno określać definicje znacznika z uwzględnieniem zasad - kolejne człony nazwy oddzielamy kropką i wszystko piszemy z dużą literą[[BR]] 
     65 *  ''Opis'' - określa opisową definicje znacznika[[BR]] 
     66 *  ''Tabela'' - określa tabelę bazy z której będą pobierane dane przy tworzeniu dokumentu[[BR]] 
     67 *  ''Klucz główny'' - odnosi się do nazwy klucza głównego z tabeli na która wskazuje pole ''Tabela''. Jeśli pole tabela wskazuje na widok należy wskazać klucz główny w tym widoku[[BR]] 
     68 *  ''Kolumna danych'' - wskazuje na interesujące nas dane które chcemy aby znalazły się w miejscu pojawienia się znacznika w szablonie[[BR]] 
     69 *  ''Kontekst'' - w przypadku wyboru tabel lub widoków które są specyficzne różne od głównych: [[BR]] * podmioty [[BR]] * documents [[BR]] * users [[BR]] * organization_units [[BR]] * orgtree_view [[BR]] * processes [[BR]] * vindication.vind_proc [[BR]] należy wyspecyfikować kontekst i tak na przykład aby pobrać dane z widoku vindication.vind_proc_view np.: kolumnę vat należy wybrać kontekst sprawy windykacyjnej [[BR]] 
     70 *  ''Formatowanie'' - w przypadku jeśli chcemy aby wymusić na pobieranych danych formatowanie określonego typu tzn. jeśli pobierana jest data w formacie 2000-01-01 08:00:00 jednak chcemy aby tylko pobrać z tego datę wtedy należy wybierać formatowane 
    7271 
    73 Poniżej znajduje się przykład znacznika wyciągającego pole ''opis'' z tabeli ''dokumentów''.  
     72Poniżej znajduje się przykład znacznika wyciągającego pole opis z tabeli dokumentów.  
    7473 
    7574[[Image(ZnacznikZtabeli.PNG)]][[br]]''Rys. 5''  
    7675 
     76=== Znacznik tworzony z cechy === 
     77Sposób definiowania tego typu znacznika jest bardzo podobny do poprzedniego z różnicą ostatniego pola ''Cecha''[[BR]] 
     78 *  ''Cecha'' - określa z jakiej cechy zostaną pobrane dane jeśli wartość cechy będzie uzupełniona dla klucza określonego w polu ''Klucz główny''.W przypadku cech kontaktów (contacts) klucz główny to contid natomiast w przypadku dokumentów jest to doc_id. 
    7779 
    78  
    79 == Znacznik tworzony z cechy == 
    80 Sposób definiowania tego typu znacznika jest bardzo podobny do poprzedniego z różnicą ostatniego pola "Cecha:"[[BR]] 
    81 - Pole "Cecha:" określa z jakiej cechy (kontaktu/dokumentu) zostaną pobrane dane jeśli wystąpi klucz główny z pola "Klucz główny". W przypadku cech kontaktów (contacts) klucz główny to contid natomiast w przypadku dokumentów jest to doc_id.[[BR]] 
    82 [[BR]] 
    83  
    84 == Znacznik z helperem == 
    85 Definiowania znacznika z pomocnikiem (helperem):[[BR]] 
    86 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ę.[[BR]] 
    87 - Pole "Znacznik:" definicja znacznika wraz z ewentualnymi opcjami wyświetlania[[BR]] 
    88 - Pole "Pomocnik:" typ helpera (pomocnego znacznika)z jakiego chcemy korzystać[[BR]] 
     80=== Znacznik z pomocnikiem === 
     81W przypadku definiowania znacznika metodą z pomocnikiem górna część definicji znacznika pozostaje taka sama jak w poprzednich przypadkach. Nowością jest lista predefiniowanych pomocnych znaczników. Jest to najprostszy sposób definiowania znacznika gdyż nie wymaga znajomości tabel jednak ma ograniczenie gdyż pomocnik jest definiowany tylko przez programistę.[[BR]] 
     82 *  ''Znacznik'' - definicja znacznika wraz z ewentualnymi opcjami wyświetlania[[BR]] 
     83 *  ''Pomocnik'' - typ pomocnego znacznika z jakiego chcemy korzystać[[BR]] 
    8984w przypadku tego pola znacznik może produkować dowolnie zdefiniowaną treść jak np.: generowanie tabelki z wykazem zadłużenia. 
    9085[[BR]] 
    91 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# 
     86W niektórych przypadkach, znaczniki utworzone metoda z pomocnikiem, mogą udostępniać różne sposoby wyświetlania. Aby spowodować wyświetlenie odpowiedniego formatowania w obrębie znacznika dodajemy odpowiedni token np. #KONTAKT.ADRES=bloczek# 
    9287 * Kontakt: dane adresowe: nazwa, adres, wszystko, bloczek.[[BR]] 
    9388 * Kontakt: sam adres:  wiersz1, wiersz2, wszystko, bloczek.[[BR]] 
     
    9691 * Sprawa: dłużnik: nazwa, adres, wszystko, bloczek.[[BR]] 
    9792  
    98 [[BR]] 
    99 == Znacznik jako SQL == 
    100  
     93=== Znacznik jako SQL === 
    10194Znacznik ten daje największe możliwości jeśli chodzi o pobieranie danych z bazy. [[BR]] 
    102 - Pole "Warunek SQL" definicja zapytania SQL jakie ma pobrać dane[[BR]] 
    103 - Pole "Kontekst:" typ kontekstu z jakiego będą pobrane dane[[BR]] 
     95W metodzie tej, poza standardowymi, dostępne są pola : [[BR]] 
     96 *  ''Warunek SQL'' - definicja zapytania SQL jakie ma pobrać dane[[BR]] 
     97 *  ''Kontekst'' - typ kontekstu z jakiego będą pobrane dane[[BR]] 
    10498Przykład wykorzystania tego znacznika [[BR]] 
    10599Jako przykład niech posłuży pobranie numeru nip jednej ze stron umowy. Zapytanie wygląda następująco: [[BR]] 
     
    116110W 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 '#'. 
    117111 
    118 ---- 
    119 '''Nowe znaczniki:'''[[BR]] 
    120 '''WINDYKACJA.DATA.WYMAGALNOSCI.ZOBOWIAZANIA''' 
    121        - można dodać indeks [1] gdzie 1 oznacza, że będzie brana pod uwagę data 1 zobowiązania z listy (według pola daty mtdate w vindication.obligations_view), jeśli nie będzie indeksu wtedy zostanie brane pod uwagę 1 wpis[[BR]] 
    122 '''KONTAKT.NUMER.NIP''' 
    123        - numer nip kontaktu[[BR]] 
    124 '''WINDYKACJA.CENA_OBLICZONA''' 
    125        - Windykacja - cena obliczona - vind_proc_view(cvalue)[[BR]] 
    126 '''WINDYKACJA.CENA_OBLICZONA_SLOWNIE''' 
    127        - Windykacja - cena obliczona słownie[[BR]] 
    128 '''WINDYKACJA.WIERZYCIEL.NUMER_NIP''' 
    129        - Windykacja - numer NIP wierzyciela[[BR]] 
    130 '''WINDYKACJA.WYDATKI_TYPY_KOSZTOW''' 
    131        - Windykacja: Do podsumowania - typy kosztów[[BR]] 
    132 '''WINDYKACJA.WYDATKI_DATY_KOSZTOW''' 
    133        - Windykacja: Do podsumowania - daty kosztów[[BR]] 
    134 '''WINDYKACJA.WYDATKI_KWOTY_KOSZTOW''' 
    135        - Windykacja: Do podsumowania - kwoty kosztów[[BR]] 
    136 '''WINDYKACJA.PRZYCHOD_DATY_WPLYWU''' 
    137        - Windykacja: Do podsumowania - daty wpłat[[BR]] 
    138 '''WINDYKACJA.PRZYCHOD_KWOTY_WPLYWU''' 
    139        - Windykacja: Do podsumowania - kwoty wpłat[[BR]] 
    140 '''WINDYKACJA.SUMA_ZADLUZENIA_SLOWNIE''' 
    141        - Windykacja - suma zadłużenia słownie[[BR]] 
    142 '''WINDYKACJA.DLUZNIK_NUMER_KRS''' 
    143        - Windykacja: numer KRS dłużnika[[BR]] 
    144 '''WINDYKACJA.DLUZNIK_NUMER_NIP''' 
    145        - Windykacja: numer NIP dłużnika[[BR]] 
    146 '''WINDYKACJA.DLUZNIK_NUMER_REGON''' 
    147        - Windykacja: numer REGON dłużnika[[BR]] 
    148 '''WINDYKACJA.ZYSK_BRUTTO''' 
    149        - Windykacja: zysk ze sprawy brutto (tabela: vindication.vind_proc_view, klucz główny: prc_id, kolumna danych: brutto)[[BR]] 
    150 '''WINDYKACJA.ZYSK_NETTO''' 
    151        - Windykacja: zysk ze sprawy netto( tabela: vindication.vind_proc_view, klucz główny: prc_id, kolumna danych: profit2)[[BR]] 
    152 '''WINDYKACJA.ZYSK_VAT''' 
    153        - Windykacja: zysk ze sprawy - kwota VAT (tabela: vindication.vind_proc_view, klucz główny: prc_id, kolumna danych: vat)[[BR]] 
    154 '''SPRAWA.SYMBOL_SPRAWY_NADRZEDNEJ''' 
    155        - Sprawa: symbol sprawy nadrzędnej zdefiniowany jako znacznik SQL[[BR]] 
    156 '''WINDYKACJA.DATA_WYSTAWIENIA_PIERWSZEJ_FAKTURY''' 
    157        - Windykacja: data wystawienia pierwszej faktury z listy zobowiązań zdefiniowany jako znacznik SQL[[BR]] 
    158 '''WINDYKACJA.DATA_WYSTAWIENIA_OSTATNIEJ_FAKTURY''' 
    159        - Windykacja: data wystawienia ostatniej faktury z listy zobowiązań zdefiniowany jako znacznik SQL[[BR]] 
    160 '''PISMO.OPIS''' 
    161        - Pismo: opis dokumentu typu pismo bez nazwy kontrahenta (wszystko co jest po Od: lub Do: jest wycinane)[[BR]]