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ć.
Opis elementów zawartych w xml do układania stron.

======  I.	Typy xmli ======


 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.

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


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


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


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

======  IV.	Browser spraw ======


 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

======  V.	Pliki i katalogi ======


 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
Narzędzia użytkownika

Narzędzia witryny

Narzędzia strony
