Opis elementów zawartych w xml do układania stron.
====== I. Typy xmli ======
A. Formatka (07, 11)
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)
i. Opis znaczników:
a) columns – kolumny w części browsera.
====== II. Typy układów: ======
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.
====== III. Kolorowanie pól ======
A. Przykładowy xml
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 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:
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ę.
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:
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.
Przykład:
====== IV. Browser spraw ======
A. Przykładowy xml, który jest odczytywany z /var/lib/tomcat/ca (default lub uzytkownik)
Uwaga, fragment:
wyświetla dymki z opisami w browserze spraw.
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
====== 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
.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;
}