This document is the reference about the concepts of the graphical user interface (also known as Tryton client ) of the Tryton application framework.
tryton - Graphical user client of the Tryton application framework
tryton [options] [url]
After startup, there raises the `login dialog`__ and optionally a `tips dialog`__.
--version | Show program version number and exit |
-h, --help | Show help message and exit |
-c FILE, --config=FILE | |
Specify alternate configuration file | |
-v, --verbose | Enable basic debugging |
-d LOG_LOGGER, --log=LOG_LOGGER | |
Specify channels to log (ex: rpc.request, rpc.result, ...) | |
-l LOG_LEVEL, --log-level=LOG_LEVEL | |
Specify the log level: INFO, DEBUG, WARNING, ERROR, CRITICAL | |
-u LOGIN, --user=LOGIN | |
Specify the login user | |
-p PORT, --port=PORT | |
Specify the server port | |
-s SERVER, --server=SERVER | |
Specify the server hostname |
When an url is passed, the client will try to find already running client that could handle it and send to this one to open the url. If it doesn’t find one then it will start the GUI and open the url itself.
The url schemes are:
tryton://<hostname>[:<port>]/<database>/model/<model name>[/<id>][;parameters]
tryton://<hostname>[:<port>]/<database>/wizard/<wizard name>[;parameters]
tryton://<hostname>[:<port>]/<database>/report/<report name>[;parameters]
where parameters are the corresponding fields of actions encoded in JSON.
Note
model is for act_window
Note
report must have at least a data parameter with ids, id and model name
The following schematic illustration of the Tryton client shows the names of all important visual parts.
Figure: Tryton client application:
Client Window ________________________________________________________________
| Tryton _ o x|
|----------------------------------------------------------------|
Menu bar | File User Options Plugins Shortcuts Help |
|________________________________________________________________|
| | ______ |
Tabs | Menu | [Tab1] |[Tab2]| [Tab3]... |
|-------------| +-------+ +--------------------------------+|
| + | | Tab2 ||
| |-+ | |-----------------------------------------------||
Tool bar | | |- | | New Save|Delete|Find Previous Next Switch v ||
| | |- | |-----------------------------------------------||
| + | | ||
| |-+ | | ||
| | |- | | ||
| | |- | | ||
| + | | ||
View | |-+ | | ||
| |- | | ||
| |- | | ||
| | | ||
| | | ||
| | | ||
| | | ||
| | | ||
|_____________| |_______________________________________________||
|________________________________________________________________|
Status bar |username company Waiting requests... login@...|
|________________________________________________________________|
This part of the client contains all the related contents and functions provided by the Tryton server modules. All aspects inside the main frame depend at least on the individual set of installed modules.
The main frame provides a `tabbed document interface`__ to arrange different views side by side. New tabs are opened by special actions, like choosing a menu item or clicking some action buttons. All tabs include titles which show the name of the provided view.
Tabs can be arranged by Drag and Drop.
Note
Inside views there can be tabs, too.
A tab opens during the startup of the Tryton client: the home. It is usually an item of the Menu opening when the user calls his `Home`__ action defined in the `preferences`__.
The status bar provides general informations of the state of the Tryton client. It is divided in three parts.
On its left side the real name and company name of the users actual company is shown.
In the center of the status bar the number of waiting requests for the actual user are displayed.
On its right side are details of the server connection shown including database and user informations if connected. It is also noted there, if there is no connection to a Tryton server at all. The right side information of the status bar is build with the following pattern:
<user-name>@<tryton-server-address>:<port>/<database-name>
If the client is connected to the server with an SSL-secured connection, an additional lock icon appears rightmost some certificate details in a mouse hover popup.
The Status bar can be enabled and disabled in the menu at Options > Form > Status bar
The tool bar contains the functionalities linked to the current tab. The tool bar contains functions for the current tab. Some operations are working with one record or with a selection of records. In form view the actual record is selected for operations. In tree view all selected records are used for operations.
Opens a dialog for finding fields with search criteria and operators.
Note
To search for deactivated records the Active search criteria must be set to No.
Switches the actual view aspect to:
Not all views provide all aspects.
Export of current/selected records into CSV-file or open it in Excel.
Import records from CSV-file.
~/.config/tryton/x.y/tryton.conf # General configuration
~/.config/tryton/x.y/accel.map # Accelerators configuration
~/.config/tryton/x.y/known_hosts # Fingerprints
~/.config/tryton/x.y/ca_certs # Certification Authority (http://docs.python.org/library/ssl.html#ssl-certificates)