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; }