This chapter describes the different input editors. In principle, all editors (except the base editor) constist out of a listview with different (grouped) enties and a few input fields on top of that listview.
Selecting a listview-entry enables appropriate input fields (e.g. fill the combobox with the respective type list and makes it accessable.
Data is stored into a temporary copy of the data set and only copied into the
global data, when confirmed with the OK button ( or with the save-button
in case of a cancel
selection.
In future versions a check whether all required data has been entered, will be executed.
This chapter describes the input methods and the data handling of the basic items. The base editor is reached from the the programs toolbar. The toolbar shows some iconified tools.
The user has to fill in the following entries.
Pressing the OK button confirms and saves the changes and closes the editor, Cancel just closes the editor. No data is stored.
Hint
If base currency entry is changed, the user has to confirm the recalculation
of all costs relevant data. If canceled, the base currency is restored to
the old value.
Note, that a change of the base currency to and back from another valuta can cause different results (factors are from thousands to milli).
This chapter describes the input methods and the data handling of the currency
list. The currency editor is reached from the the programs toolbar using the
$$-button
.
If the user selects the append button, a new entry is appended to the list. The insert button will insert an entry on top of the selected entry, the change button will change the selected entry. To enter/change the entry the currency editor is opened.
The delete button deletes entry from the list (after a warning).
The sync-button starts the internet synchronisation with the YAHOO web page for exchange rates (see subchapter below). The synclist button opens a listview with all availble currencies on the YAHOO web page.
Hint!!!
At the moment, only fixed exchange rates are possible. When this is changed, this
chapter will be redocumented (new methods).
The editors part has an extra disabled lineedit, which contains the actual base currency string.
The user has to fill in the following entries.
Pressing the OK button confirms and saves the changes and closes the editor, Cancel just closes the editor. No data is stored.
All expenses are recalculated, when currency entries were changed.
Pressing the sync button starts the synchronisation with the YAHOO's exchange web page.
To do this some requirements have to be fulfilled.
If everything is prepared, the program forks while starting wget with appropriate parameters and waits until the page has transfered. The page is stored into a file in the data directory. The filename is defined in the configuration file qtravel (entry : EXFILE).
If the file is transfered (timeout is 30 secs), the program strips all used information out of the HTML page and gets the exchange rate.
This transfer / stripping is done for every single exchange rate used automattically.
The transfered files for all exchange rates contain also a list of all available exchange rates (more than 100).
Pressing the synclist button will open a listview with all available rates. The user can select one or more to insert them into its local currency list.
Pressing OK will append them to the currency list. A syncronization will get the correct factors.
Note, that this feature only works, when a exchange file is already existing.
This chapter describes the input methods and the data handling of the costs list. The costs editor is reached from the the tabwidgets costs page.
If the user selects the append button, a new entry is appended to the list. The change button will change the selected entry. To enter/change the entry the costs editor is opened. The Delete Button will delete the selected entry. The user has to confirm this action.
The doubleArrowRight copies the content of the selected entry into the paste buffer. The leftArrowIntoBox pastes the content of the paste buffer into the list (above the selected entry).
If case of userflag is set (base dialog), the costslist first column shows a pixmap, that indicates, whether the costs are already shared between the users or not. A green hook indicates that the cost is already shared. A red CallSign indicates, that this cost is not yet shared.
The user has to fill in the following entries into the costs editor.
Pressing the OK button confirms and saves the changes and closes the editor, Cancel just closes the editor. No data is stored.
All expenses are calculated on a total and perday base and visible in the tabwidgets overview.
If case of userflag is set (base dialog), pressing the User button opens the share dialog. Here the costs can be shared between the users.
The user can select/deselect single entries clicking on the empty box in the left column. The date string is transfered from the costs entry, bu maybe also entered using the date editor. The booking date is shown on the right top edge in a textlabel. On the left top corner, a textlabel containing the sharable value is shown.
A special "ShareAllButton" can be found left of the lineedit field (3 green arrows). Changing the selection will automatically calculate the results and show them in the list.
Pressing the OK button confirms and saves the changes and closes the editor, Cancel just closes the editor. No data is stored.
This chapter describes the input methods and the data handling of the tip list. The tip editor is reached from the the tabwidgets tip page.
If the user selects the append button, a new entry is appended to the list. The change button will change the selected entry. To enter/change the entry the tip editor is opened. The Delete Button will delete the selected entry. The user has to confirm this action.
The doubleArrowRight copies the content of the selected entry into the paste buffer. The leftArrowIntoBox pastes the content of the paste buffer into the list (above the selected entry).
This list view is organized in groups of information.
The user has to fill in the following entries.
***
ist the highest quality, while ---
is the lowest
one.+++
ist the best service, while ---
is the lowest
one. The service is only usefull e.g. for restaurants / hotels. For this
the service is optional.Pressing the OK button confirms and saves the changes and closes the editor, Cancel just closes the editor. No data is stored.
This chapter describes the input methods and the data handling of the user list. The user editor is reached by pressing the userbutton from the main menu.
If the user selects the append button, a new entry is appended to the list. The change button will change the selected entry. To enter/change the entry the user editor is opened. The Delete Button will delete the selected entry. The user has to confirm this action.
The DoubleDollar button leads to the account overview of the selected user. The green arrowRight opens a dialog for cash deposit entries. The purple leftArrow open a dialog for pay offs. Both (deposit / payoff) are actually only possible using the base currency. The foreign currency methods are only prepared, but not realised.
The black arrowDown close the userlist dialog.
This list view is organized in groups of information.
The user has to fill in the following entries.