Skróty do punktów w menu w lewej górnej części ekranu

Istnieje możliwość definiowania skrótów znajdujących się w lewej górnej części ekranu. Ikonek jest piętnaście i do każdej z nich można przypisać dla każdego użytkownika oddzielnie określone działanie. Działanie to może polegać na natychmiastowym przejściu do podanego punktu w menu oraz wykonaniu sekwencji kilku klawiszy funkcyjnych (jeśli jest taka potrzeba)

W pliku: ../var/lib/tomcat/help/WebFirmatic/shortcut/user.xml (default.xml) można zapisać plik z definicją działania skrótów:

<root>
	<item id="1" menuId="" title="Menu główne" keys="" enable="true" />
	<item id="2" menuId="1016" title="Dokumenty własne" keys="" enable="true" />
	<item id="3" menuId="1016" title="Faktury własne" keys="401" enable="true" />
	
	<item id="4" menuId="2373" title="Wyszuk. tech." keys="309, 401" enable="true" />
	<item id="5" menuId="2349" title="Składniki majątku" keys="" enable="true" />
	<item id="6" menuId="2687" title="Sprawy" keys="401" enable="true" />
	
	<item id="7" menuId="1047" title="Dok. mag. przyjęcia" keys="" enable="true" />
	<item id="8" menuId="1058" title="Wypłaty" keys="" enable="true" />
	<item id="9" menuId="1057" title="Wpłaty" keys="" enable="true" />
</root>

Wartości menuId=„1057” ;keys=„309, 401” wstawiamy na podstawie informacji uzyskanych za pomocą programu serwisowego WebFirmatic-debug. Aby go uruchomić należy w oknie przeglądarki wpisać np. http://192.168.1.250:8080/WebFirmatic-debug/ uruchomienie tego programu spowoduje, że każde przesłanie informacji z przeglądarki (naciśnięcie klawisza lub kliknięcie myszką) wymaga potwierdzenia w specjalnym wyskakującym okienku, w którym można odczytać wartości jak wyżej.

title=„Dok. mag. przyjęcia” jest dowolnym tytułem ikonki, który wyświetli się na ekranie.

Podczas logowania do systemu najpierw jest wyszukiwany plik user.xml (np. grzsla.xml) a jeżeli nie istnieje wtedy wczytywany jest default.xml

**Opis menu wraz z numerami**

Skróty wykonujące sekwencję czynności

Istnieje możliwość zdefiniowania skrótów, które wykonują sekwencję „kliknięć”, np. przechodzą z nagłówka do treści dokumentu, a następnie wybierają którąś z funkcji dodatkowych i ją wykonują. Można też zdefiniować skrót, który wyśle wskazany klawisz a następnie kliknie wskazaną odpowiedź w signalu. Np. można zdefiniować skrót „Zapisz i wyjdź”, który wyśle klawisz Esc, a następnie da odpowiedź „tak” w okienku „Dane zostały zmodyfikowane - zapisać nowy stan?”.

Skróty pojawiają się w pasku ikon u góry ekranu.

Skróty definiuje się w tagu „menu” w pliku układaczki, w którym skrót ma się znajdować, np. 07 lub 11 dla formatki. Tag „menu” dopisywany jest na samym końcu plików układaczki, np:

...
<textareas>
<textarea buttonsCount="2" height="56" labelText="Opis s<C5><82>owny" 
labelTextNew="#unchg" name="Description" visible="true" width="602" 
x="150" y="401"/>
</textareas>
<colors/>
<menu>

<item icon="END-ERROR" id="1" title="Wyjdź i zapisz"> 
   <action canSkip="false" field="#CURR_FIELD_FIRST" key="END-ERROR" value="#CURR_FIELD_FIRST"/>
   <action canSkip="true" command="yes" expect="09"/> 
</item> 

</menu> 
</firmatic>

Dwa przykładowe skróty:

<item icon="END-ERROR" id="1" title="Wyjdź i zapisz"> 
   <action canSkip="false" field="#CURR_FIELD_FIRST" key="END-ERROR" value="#CURR_FIELD_FIRST"/>
   <action canSkip="true" command="yes" expect="09"/> 
</item> 
<item id="1" title="Kopiowanie linii zamówienia obcego" icon="LIGHT">
  <action key="PAGE-DOWN" field="#CURR_FIELD_FIRST" value="#CURR_FIELD_FIRST" />
  <action key="INSERT-FIELD" codeproc="106" field="#CURR_FIELD_FIRST" value="#CURR_FIELD_FIRST" expect="05" />
  <action key="GO" field="#CURR_FIELD_FIRST" value="#CURR_FIELD_FIRST" expect="07" />
</item>

Tag <item> obejmuje jeden skrót, a tagi <action> to kolejne „kliknięcia” w ramach skrótu.

Parametry <item>:

Parametry <action>:

Wartości parametrów command, codeproc oraz menuId odczytujemu za pomocą programu debug. W przypadku parametru key, musimy odczytać kod klawisza programem debug a potem znaleźć jego nazwę na poniższej liście.

Lista klawiszy:

Kod	Nazwa zmiennej	   Nazwa z help.xml						
1	F_ClipLine         "APPEND-LINE"       /* CTRL-A           
509	F_FieldLeft        "BACK-TAB"          /* SHIFT-TAB        
22	F_Copy             "BLOCK"             /* ALT-V            
1526    F_ChgFrames        "BOTTOM-COLUMN"     /* ALT-B            
502	F_Down             "CURSOR-DOWN"       /* CURSOR-DOWN      
504	F_Left             "CURSOR-LEFT"       /* CURSOR-LEFT      
503	F_Right            "CURSOR-RIGHT"      /* CURSOR-RIGHT     
501	F_Up               "CURSOR-UP"         /* CURSOR-UP        
310	F_Delete           "DELETE-LINE"       /* F10              
310	F_DelLine          "DELETE-LINE"       /* F10              
2	F_Notes            "EDITOR-BACKTAB"    /* CTRL-B           
1050    F_Bottom           "END"               /* END              
?	F_Exit             "END-ERROR"         /* ESC              
403	F_Enter_Menubar    "ENTER-MENUBAR"     /* F3               
6	F_List             "FIND"              /* CTRL-F           
305	F_Get              "GET"               /* F5               
401	F_Start            "GO"                /* F1               
1095    F_GoTo             "GOTO"              /* ALT-G            
402	F_Help             "HELP"              /* F2               
?	F_Top              "HOME"              /* HOME             
1097    F_Insert           "INSERT-FIELD"      /* ALT-I            
1094    F_Search           "INSERT-FIELD-DATA" /* ALT-F            
510	F_InsertMode       "INSERT-MODE"       /* INS              
1528    F_LeftEnd          "LEFT-END"          /* ALT-CURSOR-LEFT  
1101    F_Menu             "MAIN-MENU"         /* ALT-M            
1110    F_ClipField        "MOVE"              /* ALT-S            
309	F_InsLine          "NEW-LINE"          /* CTRL-N           
1093    F_NextError        "NEXT-ERROR"        /* ALT-E            
15	F_FirstFree        "OPTIONS"           /* ALT-O            
508	F_PageDown         "PAGE-DOWN"         /* PAGE-DOWN        
507	F_PageUp           "PAGE-UP"           /* PAGE-UP          
1040    F_Pick             "PICK"              /* ALT-P            
1105    F_Keys             "PICK-BOTH"         /* ALT-Q            
306	F_Put              "PUT"               /* F6               
1106    F_Replace          "REPLACE"           /* ALT-R            
13	F_Enter            "RETURN"            /* ENTER            
1527    F_RightEnd         "RIGHT-END"         /* ALT-CURSOR-RIGHT 
1108    F_Scroll_Mode      "SCROLL-MODE"       /* ALT-T            
9	F_FieldRight       "TAB"               /* TAB              
1525    F_Clip             "TOP-COLUMN"        /* ALT-C            

Nazwy, które mogą pojawiać się w expect:

oraz inne - takie jak początek nazwy pliku XML układaczki.