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

Data i czas:

12/07/10 09:15:10 (15 years temu)

Autor:

TS (IP: 213.227.67.33)

Komentarz:

--

UserGuide/AdvancedConfiguration/CreatingTemplates

@@ -68 +68 @@
  *  ''Kolumna danych'' - wskazuje na interesujące nas dane które chcemy aby znalazły się w miejscu pojawienia się znacznika w szablonie[[BR]]
  *  ''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]]
- *  ''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
+ *  ''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.
 
 Poniżej znajduje się przykład znacznika wyciągającego pole opis z tabeli dokumentów. 
@@ -92 +92 @@
  
 === Znacznik jako SQL ===
-Znacznik ten daje największe możliwości jeśli chodzi o pobieranie danych z bazy. [[BR]]
-W metodzie tej, poza standardowymi, dostępne są pola : [[BR]]
- *  ''Warunek SQL'' - definicja zapytania SQL jakie ma pobrać dane[[BR]]
- *  ''Kontekst'' - typ kontekstu z jakiego będą pobrane dane[[BR]]
+Znacznik ten daje największe możliwości jeśli chodzi o pobieranie danych z bazy.
+Poza standardowymi polami, dostępne są dodatkowe: [[BR]]
+ * ''Zapytanie SQL'' - definicja zapytania SQL, które zostanie wykonane
+ * ''Kontekst'' - typ kontekstu z jakiego będą pobrane dane
+ * ''Ź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
+ * ''Formatowanie'' - aby określić sposób wyświetlenia pobranych danych należy wybrać odpowiednie formatowanie. Obecnie dostępne sposoby formatowania dla znacznika SQL to:
+  * data
+  * kwota
+  * tabelka (z nagłówkiem i lp)
+  * tabelka bez lp (z nagłówkiem)
+  * tabelka bez nagłówka (z lp)
+  * tabelka bez nagłówka i bez lp
+W przypadku jeśli ma być nagłówek wtedy 1 wiersz wyniku jest nagłówkiem
+
+Dodatkowo dla formatowanie typu kwota (MONEY) - zapytanie musi być postaci
+{{{
+SELECT 123, 'PLN'
+}}}
+
+    * 1 kolumna to kwota
+    * 2 kolumna to waluta 
+
 Przykład wykorzystania tego znacznika [[BR]]
 Jako przykład niech posłuży pobranie numeru nip jednej ze stron umowy. Zapytanie wygląda następująco: [[BR]]
-select nip_ _ _ from contacts where contid = (select toctid from contract where ctrcid={CONTEXT}) [[BR]]
-Kroki tworzenia takiego zapytania są następujące: [[BR]]
-- fraza pobierająca dane select nip_ _ _ from contacts [[BR]]
-- fraza warunku where contid [[BR]]
-- fraza podzapytania (select toctid from contract where ctrcid={CONTEXT}) [[BR]]
-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]]
+ * Zapytanie SQL: SELECT nip_ _ _ FROM contacts WHERE contid = (SELECT toctid FROM contract WHERE ctrcid={CONTEXT}) [[BR]]
+
+Kroki tworzenia takiego zapytania są następujące:
+ * fraza pobierająca dane: SELECT nip_ _ _ FROM contacts
+ * fraza warunku: WHERE contid
+ * fraza podzapytania: (SELECT toctid FROM contract WHERE ctrcid={CONTEXT})
+
+Podzapytanie 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'. 
+
+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.[[BR]]
+{{{
 SELECT COALESCE((SELECT nip_ _ _ FROM contacts WHERE contid=c.toctid)::text , 'brak numeru nip') FROM contract c WHERE ctrcid={CONTEXT} [[BR]]
+}}}
+
 Powodzenia. [[BR]]
+
 '''UWAGI'''[[BR]]
 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 '#'.