Zmiany pomiędzy wersją 23 and wersją 24 dla UserGuide/AdvancedConfiguration/CreatingTemplates

Data i czas:

04/18/12 12:25:02 (12 years temu)

Autor:

lglomb (IP: 213.227.67.33)

Komentarz:

--

UserGuide/AdvancedConfiguration/CreatingTemplates

@@ -8 +8 @@
 == Wykorzystanie  znaczników w tworzeniu szablonów ==
 
-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.  
+W procesie tworzenia szablonów bardzo przydatna jest możliwość wykorzystania znaczników, które to podczas generowania 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'' 
 
-[[Image(ImportZnacznikow.2.PNG)]][[br]]''Rys. 1''
+[[Image(szablony_dokumentów.PNG)]][[br]]''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. 
 
-[[Image(Word_ListaZnacznikow.PNG)]][[br]]''Rys. 2''
+[[Image(lista_znacznikow.PNG)]][[br]]''Rys. 2''
 
 
-[[Image(Word_ListaZnacznikow2.PNG)]][[br]]''Rys. 3''
+[[Image(lista_znacznikow_pokaz.PNG)]][[br]]''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ę we wcześniej opisanej zakładce  ''Znaczniki szablonów'' z okna  ''Szablony dokumentów ''. 
@@ -49 +49 @@
 W przypadku, gdy zdefiniowane w systemie znaczniki, nie wyczerpują potrzeb klienta w tym temacie, istnieje możliwość stworzenia znaczników dodatkowych. W tym celu należy wybrać opcje ''Nowy znacznik'' z zakładki ''Znaczniki szablonów'' na oknie ''Szablony dokumentów''. 
 
-[[Image(NowySzablon.PNG)]][[br]]''Rys. 4''
+[[Image(znaczniki_szablonow.PNG)]][[br]]''Rys. 4''
 
 Znaczniki mogą być tworzone metodami: 
@@ -64 +64 @@
  *  ''Znacznik'' - powinno określać definicje znacznika z uwzględnieniem zasad - kolejne człony nazwy oddzielamy kropką i wszystko piszemy z dużą literą[[BR]]
  *  ''Opis'' - określa opisową definicje znacznika[[BR]]
- *  ''Tabela'' - określa tabelę bazy z której będą pobierane dane przy tworzeniu dokumentu[[BR]]
- *  ''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]]
- *  ''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. Obecnie jest dostępne tylko formatowanie daty.
+ *  ''Tabela'' - określa tabelę bazy, z której będą pobierane dane przy tworzeniu dokumentu[[BR]]
+ *  ''Klucz główny'' - odnosi się do nazwy klucza głównego z tabeli, na którą wskazuje pole ''Tabela''. Jeśli pole tabela wskazuje na widok należy wskazać klucz główny w tym widoku[[BR]]
+ *  ''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]] * dokument [[BR]] * dzienniki [[BR]] * umowa [[BR]] * sprawa [[BR]] * sprawa windykacyjna [[BR]] * kontakt [[BR]] * osoby kontaktowe [[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. Obecnie jest dostępne formatowanie daty, kwoty numerycznie oraz kwoty słownie.
 
 Poniżej znajduje się przykład znacznika wyciągającego pole opis z tabeli dokumentów. 
 
-[[Image(ZnacznikZtabeli.PNG)]][[br]]''Rys. 5'' 
+[[Image(znaczniki_dokumentow.PNG)]][[br]]''Rys. 5'' 
 
 === Znacznik tworzony z cechy ===
 Sposób definiowania tego typu znacznika jest bardzo podobny do poprzedniego z różnicą ostatniego pola ''Cecha''[[BR]]
- *  ''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.
+ *  ''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.
 
 === Znacznik z pomocnikiem ===
-W 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]]
+W przypadku definiowania znacznika metodą z pomocnikiem górna część definicji znacznika pozostaje taka sama jak w poprzednich przypadkach. Użyteczna pozostaje także lista predefiniowanych, pomocnych znaczników. Jest to najprostszy sposób definiowania znacznika, gdyż nie wymaga znajomości tabel jednak ma jedno ograniczenie. 
+Pomocnik jest definiowany tylko przez programistę.[[BR]]
  *  ''Znacznik'' - definicja znacznika wraz z ewentualnymi opcjami wyświetlania[[BR]]
  *  ''Pomocnik'' - typ pomocnego znacznika z jakiego chcemy korzystać[[BR]]
-w przypadku tego pola znacznik może produkować dowolnie zdefiniowaną treść jak np.: generowanie tabelki z wykazem zadłużenia.
+W przypadku tego pola znacznik może produkować dowolnie zdefiniowaną treść jak np.: generowanie tabelki z wykazem zadłużenia.
 [[BR]]
 W 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#
  * Kontakt: dane adresowe: nazwa, adres, wszystko, bloczek.[[BR]]
  * Kontakt: sam adres:  wiersz1, wiersz2, wszystko, bloczek.[[BR]]
- * Sprawa: strona sprawy: strona ?? <o co chodzi dokładnie?>[[BR]]
+ * Sprawa: strona sprawy: strona, adres, bloczek.[[BR]]
  * Sprawa: wierzyciel: nazwa, adres, wszystko, bloczek.[[BR]]
  * Sprawa: dłużnik: nazwa, adres, wszystko, bloczek.[[BR]]
@@ -95 +96 @@
 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
+ * ''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
+  * kwota numerycznie
+  * kwota słownie
   * 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
+
+W przypadku jeśli ma być nagłówek wtedy pierwszy wiersz wyniku jest nagłówkiem
 
 Dodatkowo dla formatowanie typu kwota (MONEY) - zapytanie musi być postaci
@@ -123 +126 @@
  * 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'. 
+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.
+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]]