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

Pokaż
Ignoruj:
Data i czas:
12/07/10 09:15:10 (14 years temu)
Autor:
TS (IP: 213.227.67.33)
Komentarz:

--

Legend:

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

    v19 v20  
    6868 *  ''Kolumna danych'' - wskazuje na interesujące nas dane które chcemy aby znalazły się w miejscu pojawienia się znacznika w szablonie[[BR]] 
    6969 *  ''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 
     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. Obecnie jest dostępne tylko formatowanie daty. 
    7171 
    7272Poniżej znajduje się przykład znacznika wyciągającego pole opis z tabeli dokumentów.  
     
    9292  
    9393=== Znacznik jako SQL === 
    94 Znacznik ten daje największe możliwości jeśli chodzi o pobieranie danych z bazy. [[BR]] 
    95 W 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]] 
     94Znacznik ten daje największe możliwości jeśli chodzi o pobieranie danych z bazy. 
     95Poza standardowymi polami, dostępne są dodatkowe: [[BR]] 
     96 * ''Zapytanie SQL'' - definicja zapytania SQL, które zostanie wykonane 
     97 * ''Kontekst'' - typ kontekstu z jakiego będą pobrane dane 
     98 * ''Źródło danych'' - jeśli chcemy aby dane były pobierane z innego systemu możemy to zrobić poprzez określenie źródła danych. Aby zdefiniować źródło danych należy przejść do Panelu sterowania -> Pozostałe ustawienia -> Źródła danych 
     99 * ''Formatowanie'' - aby określić sposób wyświetlenia pobranych danych należy wybrać odpowiednie formatowanie. Obecnie dostępne sposoby formatowania dla znacznika SQL to: 
     100  * data 
     101  * kwota 
     102  * tabelka (z nagłówkiem i lp) 
     103  * tabelka bez lp (z nagłówkiem) 
     104  * tabelka bez nagłówka (z lp) 
     105  * tabelka bez nagłówka i bez lp 
     106W przypadku jeśli ma być nagłówek wtedy 1 wiersz wyniku jest nagłówkiem 
     107 
     108Dodatkowo dla formatowanie typu kwota (MONEY) - zapytanie musi być postaci 
     109{{{ 
     110SELECT 123, 'PLN' 
     111}}} 
     112 
     113    * 1 kolumna to kwota 
     114    * 2 kolumna to waluta  
     115 
    98116Przykład wykorzystania tego znacznika [[BR]] 
    99117Jako przykład niech posłuży pobranie numeru nip jednej ze stron umowy. Zapytanie wygląda następująco: [[BR]] 
    100 select nip_ _ _ from contacts where contid = (select toctid from contract where ctrcid={CONTEXT}) [[BR]] 
    101 Kroki tworzenia takiego zapytania są następujące: [[BR]] 
    102 - fraza pobierająca dane select nip_ _ _ from contacts [[BR]] 
    103 - fraza warunku where contid [[BR]] 
    104 - fraza podzapytania (select toctid from contract where ctrcid={CONTEXT}) [[BR]] 
    105 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. [[BR]] 
     118 * Zapytanie SQL: SELECT nip_ _ _ FROM contacts WHERE contid = (SELECT toctid FROM contract WHERE ctrcid={CONTEXT}) [[BR]] 
     119 
     120Kroki tworzenia takiego zapytania są następujące: 
     121 * fraza pobierająca dane: SELECT nip_ _ _ FROM contacts 
     122 * fraza warunku: WHERE contid 
     123 * fraza podzapytania: (SELECT toctid FROM contract WHERE ctrcid={CONTEXT}) 
     124 
     125Podzapytanie tworzymy podobnie jak zwykłe zapytanie sql ale jako warunek 'WHERE' wybieramy z listy kontekstów konkretny kontekst. W naszym przypadku będzie to kontekst 'Umowa'.  
     126 
     127Po 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. 
     128 
    106129Aby obsłużyć brak danych i wypisać własny komunikat należy użyć formy np.[[BR]] 
     130{{{ 
    107131SELECT COALESCE((SELECT nip_ _ _ FROM contacts WHERE contid=c.toctid)::text , 'brak numeru nip') FROM contract c WHERE ctrcid={CONTEXT} [[BR]] 
     132}}} 
     133 
    108134Powodzenia. [[BR]] 
     135 
    109136'''UWAGI'''[[BR]] 
    110137W 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 '#'.