You can configure some elements of a SAYMON web interface in a configuration file ( is a SAYMON installation directory). This article contains a description of all fields of this file along with configuration examples for each of these fields.
Configuring a header for tabs and the web interface
SAYMON is a default title displayed in tabs' headers. The same title is shown in the left-upper corner of the web interface. If you need to change this title, you can set a new one in a corresponding field:
Along with HTTP, SAYMON utilizes Comet to exchange data between the client and the server. You can set the following fields in the configuration file:
The milliseconds. Otherwise, data is requested from the REST server every milliseconds.field is a port number that the Comet server listens. If a connection between the client and the Comet server is available, data is requested from the server every
In the configuration file, you may set parameters for the Grid View:
Theparameter corresponds to the number of objects placed in one row of a grid. If the value of this parameter is greater than 0, then the number of objects in each row will the equal to this number. The width of the objects will be changed automatically. If the value is equal to 0, then the width of all objects will be a fixed number equal to . The parameter corresponds to the height of an object, – the size of an ident between the objects.
SAYMON allows binding objects to their geographical location and browsing them of a map. You can configure the following fields in a configuration file:
The filed is the name of a server used to display a map. By default, openstreetmap.org is used. You may also use a local OSM server. The field sets an initial position on a map in the format [longitude, latitude]. The default value corresponds to Saint Petersburg, Russia. The field sets an initial zoom of a map.
Displaying empty objects
When you choose some object, by default SAYMON shows detailed information about this object. The same rule applies when you choose an object without nested entities. In the configuration file, you can set a list of class ids for which SAYMON will display the standard view if a chosen object is empty:
In thesection, you can configure how data is displayed on plots and activate some additional elements used for plotting:
The Main controls, the downsampling section). The field activates an option that allows adding annotations for plots.field allows activating a slider that you can use to set a time range in which data will be displayed. In the list, you can configure downsampling parameters (see
In the configuration file, you can tune a grid for objects:
Thefield corresponds to the grid size, sets a grid color in the RGBA format, specifies the maximum border size between objects and grid borders.
Pie chart colors
The Circle):field allows you to set default colors for a pie chart (or
(Un)activating sections for a detailed display mode
Using thefield, you can remove sections shown in a detailed display mode in the upper part of the web interface:
Here is a list of all available sections:
SAYMON allows embedding information about objects into external resources. The configuration file contains the following fields:
Thefield contains a URL to which a widget refers, the field sets a widget's name.
Standard class icons
Thefield allows you to set a standard icon and its size for objects of a particular class. Below is an example of such configuration:
Thefield corresponds to the class ID, – to an image relative path (a root directory is the same where the configuration file is located), – to an image size.
Using thefield, you can add a new language to SAYMON:
In the above example, the first field (e.g) corresponds to the name of a directory, where a translation for a particular language is located. All the directories with translations are located in the directory in the SAYMON installation root. The field contains a short language title, sets a standard language name. The last is displayed in the SAYMON web interface in the configuration panel.
Thefield is used to configure SAYMON themes:
The Light theme is used by default. There is one more theme available in SAYMON called Dark. CSS files with the themes are located in the directory ( is a path to a SAYMON installation directory).
Using thefield, you can configure links to various SAYMON documentation:
The fieldsand of the section contain links to English and Russian versions of user documentation. The same fields of the section set links to documentation about notification templates.
Other configuration options
The remaining options not described before are presented below: