opis_plikow_xml_ukladaczki [Firmatic]

Ta strona jest tylko do odczytu. Możesz wyświetlić źródła tej strony ale nie możesz ich zmienić.

<p>
Opis elementów zawartych w xml do układania stron.
</p>

<h1>I.	Typy xmli</h1>
<div class="level1">

<p>
 A.	Formatka (07, 11)
</p>
<pre class="code">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;firmatic arrange_params="" arrange_type="absolute_xml" startFocusField="Fnd_HX_PartnerIdent"&gt;
&lt;inputs/&gt;
&lt;buttons/&gt;
&lt;logicals/&gt;
&lt;radio_sets/&gt;
&lt;textareas/&gt;
&lt;colors/&gt;
&lt;/firmatic&gt;

</pre><p> </p>

<p>
 i.	Opis atrybutów:
</p>

<p>
 a)	znacznik firmatic
</p>

<p>
•	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).
</p>

<p>
•	arrange_type – typ układu, typy opisane są w punkcie II.
</p>

<p>
•	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.
</p>

<p>
ii.	Opis znaczników:
</p>

<p>
 a)	firmatic – korzeń xml-a,
</p>

<p>
 b)	inputs – standardowe pola tekstowe w formularzu,
</p>

<p>
 c)	buttons – przyciski dodatkowe (obecnie wszędzie wyświetlane pod formularzem),
</p>

<p>
 d)	logicals – pola logiczne w formularzu,
</p>

<p>
 e)	radio_sets – pola radio w formularzu,
</p>

<p>
 f)	textareas – duże pola tekstowe w formularzu,
</p>

<p>
 g)	colors – opis kolorowania pól.
</p>

<p>
 B.	Twx (04, 05, 06, 10, 19)
</p>
<pre class="code">  &lt;?xml version="1.0" encoding="UTF-8"?&gt;
  &lt;firmatic arrange_params="" arrange_type="absolute_xml" startFocusField="Fnd_HX_PartnerIdent"&gt;
  &lt;columns/&gt;
  &lt;inputs/&gt;
  &lt;buttons/&gt;
  &lt;logicals/&gt;
  &lt;radio_sets/&gt;
  &lt;textareas/&gt;
  &lt;colors/&gt;
  &lt;/firmatic&gt;

</pre><p> </p>




<p>
i.	Opis znaczników:
</p>

<p>
 a)	columns – kolumny w części browsera.
</p>

</div>

<h1>II.	Typy układów:</h1>
<div class="level1">

<p>
 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.
</p>

<p>
 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.
</p>

<p>
 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.
</p>

<p>
 D.	dowolna inna wartość – układ domyślny, tzn. absolute_firmatic dla twxów oraz simple dla formatek i 19.
</p>

</div>

<h1>III.	Kolorowanie pól</h1>
<div class="level1">

<p>
A.	Przykładowy xml
</p>
<pre class="code">
&lt;field name="Fnd_HX_FromDateNumber" styleName="field-danger" type="empty" argument="" /&gt;


</pre><p> </p>




<p>
B.	Opis xmla
</p>

<p>
i.	znacznik: field (obowiązkowy)
</p>

<p>
ii.	name – nazwa pola/kolumny
</p>

<p>
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.
</p>

<p>
iv.	type – typ pola zgodnie z określonymi typami
</p>

<p>
v. argument - argument stosowany w niektórych regułach
</p>

<p>
C.	Typy pól
</p>

<p>
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),
</p>

<p>
ii.	fempty – styl zostanie ustawiony jeżeli pole będzie puste,
</p>

<p>
iii.	not_empty – styl zostanie ustawiony jeżeli pole nie będzie puste, oraz będzie zawierać poprawną wartość dla takiego formatu pola,
</p>

<p>
iv.	fnot_empty – styl zostanie ustawiony jeżeli pole nie będzie puste,
</p>

<p>
v.	lt_zero – styl zostanie ustawiony jeżeli pole będzie zawierać wartość liczbową i będzie ona mniejsza od zera,
</p>

<p>
vi.	eq_zero – styl zostanie ustawiony jeżeli pole będzie zawierać wartość liczbową i będzie ona równa zero,
</p>

<p>
vii.	gt_zero – styl zostanie ustawiony jeżeli pole będzie zawierać wartość liczbową i będzie ona większa od zera.
</p>

<p>
viii.  regular -  zawsze
</p>

<p>
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")
</p>

<p>
D. Kolory dla linii
</p>

<p>
W sekcji <em><</em>line_colors> xml-a dodawane są reguły, które będą stosowane w całej linii. Ma to zastosowanie np. w sprawach.
</p>

<p>
Przykładowy xml to:
</p>
<pre class="code">&lt;item type="lt_curr_time" styleName="font-red" argument="13" /&gt;

</pre><p> </p>




<p>
Reguły dla tej sekcji to:
</p>

<p>
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ę.
</p>

<p>
ii. eq_true - styl zostanie ustawiony jeżeli pole wskazane jako argument będzie miało wartość "Tak".
</p>

<p>
Przykład, zamknięte sprawy są pokolorowane na czerwono: 
</p>
<pre class="code">&lt;item argument="Flag_Close" styleName="font-red" type="eq_true"/&gt;

</pre><p> </p>




<p>
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.
</p>

<p>
Przykład:
</p>
<pre class="code">&lt;item argument="Date_Close;Date_Realize" styleName="aff-ok;aff-late;aff-overdue" type="special_aff"/&gt;

</pre><p> </p>




</div>

<h1>IV.	Browser spraw</h1>
<div class="level1">

<p>
 A.	Przykładowy xml, który jest odczytywany z /var/lib/tomcat/ca (default lub uzytkownik)
</p>
<pre class="code">    &lt;?xml version="1.0" encoding="UTF-8" standalone="no"?&gt;
&lt;firmatic arrange_params="" arrange_type="absolute_xml" startFocusField=""&gt;
  &lt;columns&gt;
    &lt;column labelText="Lp" name="WorkHeadAff.Lp" order="1" visible="true" width="32"/&gt;
    &lt;column labelText="Numer" name="WorkHeadAff.Number" order="2" visible="true" width="56"/&gt;
    &lt;column labelText="" name="WorkHeadAff.NumberSuffix" order="3" visible="false" width="18"/&gt;
    &lt;column labelText="Założył" name="TempUserData_From.UserIdent" order="4" visible="true" width="68"/&gt;
    &lt;column labelText="Zmk" name="WorkHeadAff.Flag_Close" order="5" visible="true" width="38"/&gt;
    &lt;column labelText="Tytuł" name="WorkHeadAff.Tytul" order="6" visible="true" width="254"/&gt;
    &lt;column labelText="Adresat" name="TempUserData_To.UserIdent" order="7" visible="true" width="78"/&gt;
    &lt;column labelText="Założono" name="WorkHeadAff.Date_Create" order="8" visible="true" width="91"/&gt;
    &lt;column labelText="Kontrahent" name="TempPartners.PartnerShortName" order="9" visible="true" width="142"/&gt;
    &lt;column labelText="Dotyczy" name="TempAffair.CodeAffairIdent" order="10" visible="true" width="90"/&gt;
    &lt;column labelText="Odebrano" name="WorkHeadAff.Date_Message" order="11" visible="false" width="18"/&gt;
    &lt;column labelText="Przeczytano" name="WorkHeadAff.Date_Read" order="12" visible="false" width="18"/&gt;
    &lt;column labelText="Zamknięto" name="WorkHeadAff.Date_Close" order="13" visible="false" width="18"/&gt;
    &lt;column labelText="D.realizacji" name="WorkHeadAff.Date_Realize" order="14" visible="true" width="95"/&gt;
    &lt;column labelText="Ważne od" name="WorkHeadAff.Date_ValidateFrom" order="15" visible="false" width="18"/&gt;
    &lt;column labelText="godziny" name="WorkHeadAff.Time_ValidateFrom" order="16" visible="false" width="16"/&gt;
    &lt;column labelText="do dnia" name="WorkHeadAff.Date_ValidateTo" order="17" visible="false" width="18"/&gt;
    &lt;column labelText="godziny" name="WorkHeadAff.Time_ValidateTo" order="18" visible="false" width="16"/&gt;
    &lt;column labelText="Treść" name="WorkHeadAff.Description" order="19" visible="true" width="322"/&gt;
    &lt;column labelText="Odpowiedź" name="WorkHeadAff.Commentary" order="20" visible="true" width="386"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[1]" order="21" visible="true" width="26"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[2]" order="22" visible="true" width="26"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[3]" order="23" visible="true" width="26"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[4]" order="24" visible="true" width="26"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[5]" order="25" visible="true" width="26"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[6]" order="26" visible="true" width="26"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[7]" order="27" visible="true" width="26"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[8]" order="28" visible="true" width="33"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[9]" order="29" visible="true" width="33"/&gt;
    &lt;column labelText="Słowa klucze" name="WorkHeadAff.Tags[10]" order="30" visible="true" width="33"/&gt;
    &lt;column labelText="Czas pracy" name="WorkHeadAff.Hours" order="31" visible="true" width="18"/&gt;
    &lt;column labelText="Dokument połączony" name="WorkHeadAff.HeaderIdent" order="32" visible="true" width="33"/&gt;
    &lt;column labelText="Załączników" name="WorkHeadAff.QtyNotesHeader" order="33" visible="true" width="19"/&gt;
    &lt;column labelText="Il. zał." name="WorkHeadAff.QtyNotesAff" order="34" visible="true" width="16"/&gt;
  &lt;/columns&gt;
  &lt;inputs/&gt;
  &lt;buttons/&gt;
  &lt;logicals/&gt;
  &lt;radio_sets/&gt;
  &lt;textareas/&gt;
   &lt;colors&gt;
      &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-failure" type="eq_str_val" argument="Awaria" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-error" type="eq_str_val" argument="Błąd" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-docs" type="eq_str_val" argument="Dokumentów" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-delivery" type="eq_str_val" argument="Dostawy" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-invoice" type="eq_str_val" argument="Faktury" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-info" type="eq_str_val" argument="Inne" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-modification" type="eq_str_val" argument="Modyfikacja" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-new" type="eq_str_val" argument="Nowa" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-complaint" type="eq_str_val" argument="Reklamacji" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-service" type="eq_str_val" argument="Serwisu" /&gt;
	  &lt;field name="TempAffair.CodeAffairIdent" styleName="label label-payment" type="eq_str_val" argument="Zapłaty" /&gt;
	  &lt;field name="WorkHeadAff.Description" styleName="left" type="tooltip" /&gt;
	  &lt;field name="WorkHeadAff.Commentary" styleName="left" type="tooltip" /&gt;
	  &lt;field name="WorkHeadAff.Tytul" styleName="right" type="tooltip" /&gt;
  &lt;/colors&gt;
  &lt;line_colors&gt;
    &lt;item type="lt_curr_time" styleName="font-red" argument="13" /&gt;
  &lt;/line_colors&gt;
&lt;/firmatic&gt;

</pre><p> </p>




<p>
Uwaga, fragment:
</p>
<pre class="code">&lt;field name="WorkHeadAff.Description" styleName="left" type="tooltip" /&gt;
&lt;field name="WorkHeadAff.Commentary" styleName="left" type="tooltip" /&gt;
&lt;field name="WorkHeadAff.Tytul" styleName="right" type="tooltip" /&gt;

</pre><p> </p>




<p>
wyświetla dymki z opisami w browserze spraw.
</p>

<p>
 B.	Opis atrybutów dla pól
</p>

<p>
 i.	labelText – nazwa opisu kolumny (tylko do pomocy w układaniu),
</p>

<p>
 ii.	name – nazwa pola
</p>

<p>
 iii.	order – kolejność (od 1 do n)
</p>

<p>
 iv.	visible – widoczność
</p>

<p>
 v.	width – szerokość w pikselach
</p>

</div>

<h1>V.	Pliki i katalogi</h1>
<div class="level1">

<p>
 A.	/var/lib/tomcat/ca – główny katalog z plikami do układania
</p>

<p>
 B.	/var/lib/tomcat/ca/default – domyślne pliki do układania
</p>

<p>
 C.	resources/deploy/css/colors.css – plik ze stylami dla pól, np.
</p>

<p>
 	Przykładowy colors.css
</p>
<pre class="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;
}

</pre><p> </p>




</div>
Narzędzia użytkownika

Narzędzia witryny

Narzędzia strony
