Różnice

Różnice między wybraną wersją a wersją aktualną.

--- opis_plikow_xml_ukladaczki [2013/05/07 11:02]
marek
+++ opis_plikow_xml_ukladaczki [2015/10/15 10:13] (aktualna)
kostek [III.Kolorowanie pól]
@@ Linia 1: / Linia 1: @@
 Opis elementów zawartych w xml do układania stron.
+======  I.	Typy xmli ======
-====== I.	Typy xmli ======
+ A.	Formatka (07, 11)
-A.	Formatka (07, 11)
+  <?xml version="1.0" encoding="UTF-8"?>
+  <firmatic arrange_params="" arrange_type="absolute_xml" startFocusField="Fnd_HX_PartnerIdent">
+  <inputs/>
+  <buttons/>
+  <logicals/>
+  <radio_sets/>
+  <textareas/>
+  <colors/>
+  </firmatic>
+ i.	Opis atrybutów:
+ a)	znacznik firmatic
+•	arrange_params – obecnie nieużywany, przeznaczony na parametry układu (np. jeżeli byłaby automatyczna układaczka to na ile kolumn należy rozłożyć elementy).
+•	arrange_type – typ układu, typy opisane są w punkcie II.
+•	startFocusField – nazwa pola, na którym ma być ustawiony focus po pierwszym wejściu w stronę. Wartość pusta oznacza automatyczne ustawienie na pierwszym edytowalnym polu.
+ii.	Opis znaczników:
+ a)	firmatic – korzeń xml-a,
+ b)	inputs – standardowe pola tekstowe w formularzu,
+ c)	buttons – przyciski dodatkowe (obecnie wszędzie wyświetlane pod formularzem),
+ d)	logicals – pola logiczne w formularzu,
+ e)	radio_sets – pola radio w formularzu,
+ f)	textareas – duże pola tekstowe w formularzu,
+ g)	colors – opis kolorowania pól.
+ B.	Twx (04, 05, 06, 10, 19)
 <code>
-//
+  <?xml version="1.0" encoding="UTF-8"?>
-//
+  <firmatic arrange_params="" arrange_type="absolute_xml" startFocusField="Fnd_HX_PartnerIdent">
-//
+  <columns/>
-//
+  <inputs/>
-//
+  <buttons/>
-//
+  <logicals/>
-//
+  <radio_sets/>
-//
+  <textareas/>
-//
+  <colors/>
+  </firmatic>
 </code>
+ i.	Opis znaczników:
-i.	Opis atrybutów:
+ a)	columns – kolumny w części browsera.
+======  II.	Typy układów: ======
-a)	znacznik firmatic
+ A.	absolute_xml – układ w którym wszystkie parametry brane są z pliku xml. Wyjątkiem są twxy (04, 05, 06) dla, których z xml-a odczytywane są jedynie parametry związane z kolorowaniem pól i startowym położeniem focusa.
-•	arrange_params – obecnie nieużywany, przeznaczony na parametry układu (np. jeżeli byłaby automatyczna układaczka to na ile kolumn należy rozłożyć elementy).
+ B.	absolute_firmatic – układ w którym wszystkie parametry brane są z pliku xml, ale interpretowane są jako parametry przesyłane z firmatica. Uwaga związana z twxami dalej obowiązuje.
+ C.	simple – układ w którym pomijane są parametry dotyczące ułożenia elementów, i są one układane jeden pod drugim.
-•	arrange_type – typ układu, typy opisane są w punkcie II.
+ D.	dowolna inna wartość – układ domyślny, tzn. absolute_firmatic dla twxów oraz simple dla formatek i 19.
+====== III.	Kolorowanie pól ======
-•	startFocusField – nazwa pola, na którym ma być ustawiony focus po pierwszym wejściu w stronę. Wartość pusta oznacza automatyczne ustawienie na pierwszym edytowalnym polu.
+A.	Przykładowy xml
-ii.	Opis znaczników:
+<code>
+<field name="Fnd_HX_FromDateNumber" styleName="field-danger" type="empty" argument="" />
-a)	firmatic – korzeń xml-a,
+</code>
+B.	Opis xmla
-b)	inputs – standardowe pola tekstowe w formularzu,
+i.	znacznik: field (obowiązkowy)
-c)	buttons – przyciski dodatkowe (obecnie wszędzie wyświetlane pod formularzem),
+ii.	name – nazwa pola/kolumny
-d)	logicals – pola logiczne w formularzu,
+iii.	styleName – nazwa stylu zgodna ze stylami zawartymi w pliku stylów dla pól - dla każdego "type" można sobie zdefiniować własny styleName i odpowiednio się na niego powoływać w xml-u i css-sie.
-e)	radio_sets – pola radio w formularzu,
-f)	textareas – duże pola tekstowe w formularzu,
+iv.	type – typ pola zgodnie z określonymi typami
-g)	colors – opis kolorowania pól.
+v. argument - argument stosowany w niektórych regułach
-B.	Twx (04, 05, 06, 10, 19)
+C.	Typy pól
-<code>
+i.	empty – styl zostanie ustawiony jeżeli pole będzie puste, lub będzie się znajdować w nim wartość niedozwolona dla takiego formatu pola (np. '/ /' dla daty),
-//
-//
-//
-//
-//
-//
-//
-//
-//
-//
-</code>
-i.	Opis znaczników:
+ii.	fempty – styl zostanie ustawiony jeżeli pole będzie puste,
-a)	columns – kolumny w części browsera.
+iii.	not_empty – styl zostanie ustawiony jeżeli pole nie będzie puste, oraz będzie zawierać poprawną wartość dla takiego formatu pola,
-====== II.	Typy układów: ======
+iv.	fnot_empty – styl zostanie ustawiony jeżeli pole nie będzie puste,
-A.	absolute_xml – układ w którym wszystkie parametry brane są z pliku xml. Wyjątkiem są twxy (04, 05, 06) dla, których z xml-a odczytywane są jedynie parametry związane z kolorowaniem pól i startowym położeniem focusa.
+v.	lt_zero – styl zostanie ustawiony jeżeli pole będzie zawierać wartość liczbową i będzie ona mniejsza od zera,
-B.	absolute_firmatic – układ w którym wszystkie parametry brane są z pliku xml, ale interpretowane są jako parametry przesyłane z firmatica. Uwaga związana z twxami dalej obowiązuje.
+vi.	eq_zero – styl zostanie ustawiony jeżeli pole będzie zawierać wartość liczbową i będzie ona równa zero,
-C.	simple – układ w którym pomijane są parametry dotyczące ułożenia elementów, i są one układane jeden pod drugim.
+vii.	gt_zero – styl zostanie ustawiony jeżeli pole będzie zawierać wartość liczbową i będzie ona większa od zera.
-D.	dowolna inna wartość – układ domyślny, tzn. absolute_firmatic dla twxów oraz simple dla formatek i 19.
+viii.  regular -  zawsze
-====== III.	Kolorowanie pól ======
+ix. eq_str_val - styl zostanie ustawiony jeżeli pole będzie posiadać wartość równą tej która zawarta jest w atrybucie argument (np. argument="Zmian")
-A.	Przykładowy xml
+D. Kolory dla linii
+W sekcji <line_colors> xml-a dodawane są reguły, które będą stosowane w całej linii. Ma to zastosowanie np. w sprawach.
+Przykładowy xml to:
-<field name="Fnd_HX_FromDateNumber" styleName="field-danger" type="empty" argument=_fckg_QUOT__fckg_QUOT_ />   B.	Opis xmla   i.	znacznik: field (obowiązkowy)   ii.	name – nazwa pola/kolumny   iii.	styleName – nazwa stylu zgodna ze stylami zawartymi w pliku stylów dla pól - dla każdego "type" można sobie zdefiniować   ''własny styleName i odpowiednio się na niego powoływać w xml-u i css-sie. ''
-iv.	type – typ pola zgodnie z określonymi typami   v. argument - argument stosowany w niektórych regułach   C.	Typy pól   i.	empty – styl zostanie ustawiony jeżeli pole będzie puste, lub będzie się znajdować w nim wartość niedozwolona dla takiego formatu pola (np. '/ /' dla daty),   ii.	fempty – styl zostanie ustawiony jeżeli pole będzie puste,   iii.	not_empty – styl zostanie ustawiony jeżeli pole nie będzie puste, oraz będzie zawierać poprawną wartość dla takiego formatu pola,   iv.	fnot_empty – styl zostanie ustawiony jeżeli pole nie będzie puste,   v.	lt_zero – styl zostanie ustawiony jeżeli pole będzie zawierać wartość liczbową i będzie ona mniejsza od zera,   vi.	eq_zero – styl zostanie ustawiony jeżeli pole będzie zawierać wartość liczbową i będzie ona równa zero,   vii.	gt_zero – styl zostanie ustawiony jeżeli pole będzie zawierać wartość liczbową i będzie ona większa od zera.   viii.  regular -  zawsze   ix. eq_str_val - styl zostanie ustawiony jeżeli pole będzie posiadać wartość równą tej która zawarta jest w atrybucie argument (np. argument="Zmian")   D. Kolory dla linii   W sekcji <line_colors> xml-a dodawane są reguły, które będą stosowane w całej linii. Ma to zastosowanie np. w sprawach.   Przykładowy xml to:   <item type="lt_curr_time" styleName="font-red" argument="13" />   Reguły dla tej sekcji to:   i. lt_curr_time - reguła ta porównuje wartości kolumn podanych numerycznie z bieżącym czasem. Jeżeli bieżący czas jest późniejszy niż ten w kolumnach to stosowany jest styl. argument może mieć wartość "liczba" lub "liczba;liczba", w tym drugim przypadku druga kolumna zawiera dokładną godzinę.  ======  IV.	Browser spraw ======    A.	Przykładowy xml   <firmatic arrange_params=_____fckg_QUOT__fckg_QUOT_ arrange_type=_fckg_QUOT__fckg_QUOT_____startFocusField=_fckg_QUOT__fckg_QUOT_>
 <code>
-   //
+<item type="lt_curr_time" styleName="font-red" argument="13" />
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-    //
-   //
-  //
-  //
-  //
-  //
-  //
-  //
-    //
-    //
-  //
-  //
 </code>
+Reguły dla tej sekcji to:
-B.	Opis atrybutów dla pól
+i. lt_curr_time - reguła ta porównuje wartości kolumn podanych numerycznie z bieżącym czasem. Jeżeli bieżący czas jest późniejszy niż ten w kolumnach to stosowany jest styl. argument może mieć wartość "liczba" lub "liczba;liczba", w tym drugim przypadku druga kolumna zawiera dokładną godzinę.
-i.	labelText – nazwa opisu kolumny (tylko do pomocy w układaniu),
+ii. eq_true - styl zostanie ustawiony jeżeli pole wskazane jako argument będzie miało wartość "Tak".
+Przykład, zamknięte sprawy są pokolorowane na czerwono:
-ii.	name – nazwa pola
+<code>
+<item argument="Flag_Close" styleName="font-red" type="eq_true"/>
+</code>
+iii. - special_aff - reguła stworzona na potrzeby ZKS stosowana w sprawach. Porównuje wartości pól Date_Close i Date_Realize i przypisuje im jeden z 3 stylów: aff-ok, aff-late, aff-overdue. Jeżeli Date_Realize < Date_Close i sprawa jest zamknięta, to działa aff-ok. Jeżeli Date_Close > Date_Realize i sprawa jest zamknięta, to działa aff-late. Jeżeli sprawa niezamknięta, lub brak jest Date_Close, to działa styl aff-overdue.
-iii.	order – kolejność (od 1 do n)
+Przykład:
+<code>
+<item argument="Date_Close;Date_Realize" styleName="aff-ok;aff-late;aff-overdue" type="special_aff"/>
+</code>
-iv.	visible – widoczność
+======  IV.	Browser spraw ======
-v.	width – szerokość w pikselach
+ A.	Przykładowy xml, który jest odczytywany z /var/lib/tomcat/ca (default lub uzytkownik)
+<code>
+    <?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<firmatic arrange_params="" arrange_type="absolute_xml" startFocusField="">
+  <columns>
+    <column labelText="Lp" name="WorkHeadAff.Lp" order="1" visible="true" width="32"/>
+    <column labelText="Numer" name="WorkHeadAff.Number" order="2" visible="true" width="56"/>
+    <column labelText="" name="WorkHeadAff.NumberSuffix" order="3" visible="false" width="18"/>
+    <column labelText="Założył" name="TempUserData_From.UserIdent" order="4" visible="true" width="68"/>
+    <column labelText="Zmk" name="WorkHeadAff.Flag_Close" order="5" visible="true" width="38"/>
+    <column labelText="Tytuł" name="WorkHeadAff.Tytul" order="6" visible="true" width="254"/>
+    <column labelText="Adresat" name="TempUserData_To.UserIdent" order="7" visible="true" width="78"/>
+    <column labelText="Założono" name="WorkHeadAff.Date_Create" order="8" visible="true" width="91"/>
+    <column labelText="Kontrahent" name="TempPartners.PartnerShortName" order="9" visible="true" width="142"/>
+    <column labelText="Dotyczy" name="TempAffair.CodeAffairIdent" order="10" visible="true" width="90"/>
+    <column labelText="Odebrano" name="WorkHeadAff.Date_Message" order="11" visible="false" width="18"/>
+    <column labelText="Przeczytano" name="WorkHeadAff.Date_Read" order="12" visible="false" width="18"/>
+    <column labelText="Zamknięto" name="WorkHeadAff.Date_Close" order="13" visible="false" width="18"/>
+    <column labelText="D.realizacji" name="WorkHeadAff.Date_Realize" order="14" visible="true" width="95"/>
+    <column labelText="Ważne od" name="WorkHeadAff.Date_ValidateFrom" order="15" visible="false" width="18"/>
+    <column labelText="godziny" name="WorkHeadAff.Time_ValidateFrom" order="16" visible="false" width="16"/>
+    <column labelText="do dnia" name="WorkHeadAff.Date_ValidateTo" order="17" visible="false" width="18"/>
+    <column labelText="godziny" name="WorkHeadAff.Time_ValidateTo" order="18" visible="false" width="16"/>
+    <column labelText="Treść" name="WorkHeadAff.Description" order="19" visible="true" width="322"/>
+    <column labelText="Odpowiedź" name="WorkHeadAff.Commentary" order="20" visible="true" width="386"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[1]" order="21" visible="true" width="26"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[2]" order="22" visible="true" width="26"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[3]" order="23" visible="true" width="26"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[4]" order="24" visible="true" width="26"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[5]" order="25" visible="true" width="26"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[6]" order="26" visible="true" width="26"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[7]" order="27" visible="true" width="26"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[8]" order="28" visible="true" width="33"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[9]" order="29" visible="true" width="33"/>
+    <column labelText="Słowa klucze" name="WorkHeadAff.Tags[10]" order="30" visible="true" width="33"/>
+    <column labelText="Czas pracy" name="WorkHeadAff.Hours" order="31" visible="true" width="18"/>
+    <column labelText="Dokument połączony" name="WorkHeadAff.HeaderIdent" order="32" visible="true" width="33"/>
+    <column labelText="Załączników" name="WorkHeadAff.QtyNotesHeader" order="33" visible="true" width="19"/>
+    <column labelText="Il. zał." name="WorkHeadAff.QtyNotesAff" order="34" visible="true" width="16"/>
+  </columns>
+  <inputs/>
+  <buttons/>
+  <logicals/>
+  <radio_sets/>
+  <textareas/>
+   <colors>
+      <field name="TempAffair.CodeAffairIdent" styleName="label label-failure" type="eq_str_val" argument="Awaria" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-error" type="eq_str_val" argument="Błąd" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-docs" type="eq_str_val" argument="Dokumentów" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-delivery" type="eq_str_val" argument="Dostawy" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-invoice" type="eq_str_val" argument="Faktury" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-info" type="eq_str_val" argument="Inne" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-modification" type="eq_str_val" argument="Modyfikacja" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-new" type="eq_str_val" argument="Nowa" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-complaint" type="eq_str_val" argument="Reklamacji" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-service" type="eq_str_val" argument="Serwisu" />
+	  <field name="TempAffair.CodeAffairIdent" styleName="label label-payment" type="eq_str_val" argument="Zapłaty" />
+	  <field name="WorkHeadAff.Description" styleName="left" type="tooltip" />
+	  <field name="WorkHeadAff.Commentary" styleName="left" type="tooltip" />
+	  <field name="WorkHeadAff.Tytul" styleName="right" type="tooltip" />
+  </colors>
+  <line_colors>
+    <item type="lt_curr_time" styleName="font-red" argument="13" />
+  </line_colors>
+</firmatic>
+</code>
-====== V.	Pliki i katalogi ======
+Uwaga, fragment:
+<code>
+<field name="WorkHeadAff.Description" styleName="left" type="tooltip" />
+<field name="WorkHeadAff.Commentary" styleName="left" type="tooltip" />
+<field name="WorkHeadAff.Tytul" styleName="right" type="tooltip" />
+</code>
-A.	WEB-INF/ca – główny katalog z plikami do układania
+wyświetla dymki z opisami w browserze spraw.
+ B.	Opis atrybutów dla pól
-B.	WEB-INF/ca/default – domyślne pliki do układania
+ i.	labelText – nazwa opisu kolumny (tylko do pomocy w układaniu),
+ ii.	name – nazwa pola
+ iii.	order – kolejność (od 1 do n)
+ iv.	visible – widoczność
+ v.	width – szerokość w pikselach
+======  V.	Pliki i katalogi ======
+ A.	/var/lib/tomcat/ca – główny katalog z plikami do układania
+ B.	/var/lib/tomcat/ca/default – domyślne pliki do układania
+ C.	resources/deploy/css/colors.css – plik ze stylami dla pól, np.
+ 	Przykładowy colors.css
+<code>
+.field-danger {
+	background-color: #F2DEDE !important;
+    border-color: #EED3D7 !important;
+    color: #B94A48 !important;
+}
+.field-start {
+	background-color: #c5dff6 !important;
+    border-color: #f6680a !important;
+    color: #B94A48 !important;
+}
+.field-info {
+	background-color: #dee100 !important;
+    border-color: #ef0718 !important;
+    color: #B94A48 !important;
+}
+.font-red {
+	color: rgb(221, 75, 57);
+	font-family: 'tgb gothic', 'helvetica neue', helvetica, arial, sans-serif;
+}
+.label-delivery {
+  background-color: #990099 !important;
+}
+.label-payment {
+  background-color: #7ODB93 !important;
+}
+.label-service {
+  background-color: #ff6600 !important;
+}
+.label-info {
+  background-color: #66cccc !important;
+}
+.label-failure {
+  background-color: #ff0033 !important;
+}
+.label-error {
+  background-color: #ff3366 !important;
+}
+.label-docs {
+  background-color: #8C7853 !important;
+}
+.label-invoice {
+  background-color: #6699ff !important;
+}
+.label-modification {
+  background-color: #66cc99 !important;
+}
+.label-new {
+  background-color: #33cc66 !important;
+}
+.label-complaint {
+  background-color: #ff6666 !important;
+}
+</code>
-C.	resources/css/colors.css – plik z stylami dla pól

Narzędzia użytkownika

Narzędzia witryny

Różnice

Narzędzia strony