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)

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

i. Opis znaczników:

a) columns – kolumny w części browsera.

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.

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.

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

A. Przykładowy xml

<field name=„Fnd_HX_FromDateNumber” styleName=„field-danger” type=„empty” argument=”” />

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

A. Przykładowy xml

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

B. Opis atrybutów dla pól

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

A. WEB-INF/ca – główny katalog z plikami do układania

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

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