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>

<p>
<em><</em>field name="Fnd_HX_FromDateNumber" styleName="field-danger" type="empty" argument=_fckg_QUOT<u>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ć


<code>
      własny styleName i odpowiednio się na niego powoływać w xml-u i css-sie.
</code>
<span class='np_break'> </span>


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


Przykładowy xml to:


<em><</em>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

    &lt;firmatic arrange_params=_fckg_QUOT</u>fckg_QUOT_ arrange_type=_fckg_QUOT<u>fckg_QUOT_ startFocusField=_fckg_QUOT</u>fckg_QUOT_&gt;
</p>
<pre class="code">   &lt;columns&gt;
    &lt;column labelText="Numer" name="HeadAff.Number" order="1" visible="true" width="5"/&gt;
    &lt;column labelText="Założył" name="TempUserData_From.UserIdent" order="2" visible="true" width="20"/&gt;
    &lt;column labelText="Tytuł" name="HeadAff.Tytul" order="3" visible="true" width="39"/&gt;
    &lt;column labelText="Adresat" name="TempUserData_To.UserIdent" order="4" visible="true" width="20"/&gt;
    &lt;column labelText="Założono" name="HeadAff.Date_Create" order="5" visible="true" width="10"/&gt;
    &lt;column labelText="Kontrahent" name="TempPartners.PartnerShortName" order="6" visible="true" width="10"/&gt;
    &lt;column labelText="Dotyczy" name="TempAffair.CodeAffairIdent" order="7" visible="true" width="10"/&gt;
    &lt;column labelText="Odebrano" name="HeadAff.Date_Message" order="8" visible="true" width="10"/&gt;
    &lt;column labelText="Przeczytano" name="HeadAff.Date_Read" order="9" visible="true" width="10"/&gt;
    &lt;column labelText="Zamknięto" name="HeadAff.Date_CLose" order="10" visible="true" width="10"/&gt;
    &lt;column labelText="D.realizacji" name="HeadAff.Date_Realize" order="11" visible="true" width="10"/&gt;
    &lt;column labelText="Ważne od" name="HeadAff.Date_ValidateFrom" order="12" visible="true" width="10"/&gt;
    &lt;column labelText="godziny" name="HeadAff.Time_ValidateFrom" order="13" visible="true" width="8"/&gt;
    &lt;column labelText="do dnia" name="HeadAff.Date_ValidateTo" order="14" visible="true" width="10"/&gt;
    &lt;column labelText="godziny" name="HeadAff.Time_ValidateTo" order="15" visible="true" width="8"/&gt;
    &lt;column labelText="Treść" name="HeadAff.Description" order="16" visible="true" width="30"/&gt;
    &lt;column labelText="Odpowiedź" name="HeadAff.Commentary" order="17" visible="true" width="30"/&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="TempUserData_From.UserIdent" styleName="field-danger" type="regular"/&gt;
    &lt;field name="HeadAff.Description" styleName="field-danger" type="empty"/&gt;
  &lt;/colors&gt;
  &lt;/firmatic&gt;

</pre><p> </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.	WEB-INF/ca – główny katalog z plikami do układania
</p>

<p>
 B.	WEB-INF/ca/default – domyślne pliki do układania
</p>

<p>
 C.	resources/css/colors.css – plik z stylami dla pól
</p>

</div>
Narzędzia użytkownika

Narzędzia witryny

Narzędzia strony
