Working with Messages

Working with Messages

Working with messages is query messages, view and filter them, and delete them.

Requesting Messages from Server

The request is formulated in the Messages, in the top left corner of the window. Specify the following parameters:

  1. Select a unit. The dropdown list contains not all the units available to you, but only the units from the work list of the monitoring panel. In case the work list is empty (when the dynamic work list is used or when units were deleted from the work list manually), the units to which you possess the corresponding rights are displayed. The button in the shape of a spanner located to the right of the dropdown list serves to open the Unit Properties dialog.
  2. Specify the time interval to show messages for. The principle of interval adjustment is the same as in the reports (see Query and View Reports). The second and fourth steps can be combined if you choose one of the quick intervals (the buttons Today, Yesterday, Week, and Month).
  3. Select the message type from the dropdown list (each type is described in detail below):
  4. At the end, press the Execute button. The table will be generated in the right part of the window. To clear the table (and the map), press Clear.


Note.
There are alternative ways to query messages:


Note that to display the messages track on the map, you should check if the corresponding layer is active.

Viewing Messages

Messages of any type are displayed in the form of a table.

If a long time interval is selected, there can be many messages. In this case they are presented on several pages. Use the navigation panel (blue arrows) to move from page to page, or enter the page number manually and press Enter to display a certain page. Apart from that, in the dropdown list you can set the number of messages to be displayed on one page: 25, 50, 100, 500, 1000.


The width of the columns can be adjusted. To do this, move the cursor to the border of the column, click the left mouse button and, while holding it, drag the border to the desired direction. If you want to expand the table, press the Set column auto width button so that the letter A appears there . In this case, the column width will be set according to contents in the cells. To save the column width when moving through the pages, make the button inactive . Note that when loading many messages (500, 1000 per page), it is better to disable the column auto width because it can considerably slow down the loading process especially if the number of parameters differs from one message to another.

The contents of the table are adjustable. It is possible to hide and display any column. To display the columns, click the button in the right corner of the header of the table. Then select the columns you need in the dropdown list. Note that all the columns cannot be hidden simultaneously. If sensors are displayed, each of them has its own column that can be enabled or disabled. By default, only visible sensors are displayed (the rest can be enabled manually). The set of columns and their width are only saved for one unit during one session. If the unit or message type is changed, or the page is refreshed, the settings are reset.

Messages Filter

To quickly find a necessary message, use a special filter. Data messages (with parameters displayed as raw data) can be filtered by parameter names and parameter values, SMS messages and registered events — by message/event text, sent commands — by values of additional parameters, log — by the description of the action. The filter is disabled for data messages with the parameters shown as sensor values.

The rules for setting the filter were given above. You can use wildcard characters (* or ?) or input your query without them. For example, to find all messages with images enter 'image'. Other available parameters depend on the type of equipment used.

To search for several parameters at once, enter their masks separated by commas. In this case, the results are highlighted in different colours and moved to the beginning of the line. Their order corresponds to the entered masks.

For parameter values, the usage of the * and ? signs is supported if string values are compared. That is, the search can be specified as: adc? = 0.5 *. Only operators = (equal) and <> (not equal) are used in this case.

In addition, the filter supports the following operations: =, >, <, >=, <= <>. For instance, a search can be specified as follows:

  • param = 3.1415 (equal);
  • param > 3.14 (more);
  • param < 3.14 (less);
  • param >= 3.14 (more o equal);
  • param <= 3.14 (less or equal);
  • param <> 3.1415926535 (not equal);
  • 2.71 < param < 3.15 (more …, but less …).

The characters * and ? can be used for parameter names. Therefore, a search can be specified as: adc? > 0.5.

The search of input/output values is carried out according to the principle if any of the values is equal, greater or less, that is, the query I / O <2 will include I/O = 0/2 among the results, since there is a value 0, which is less than 2.

To apply the filter, press Enter or the Apply button on the right of the filer. After this, messages that contain the requested parameters or text will be displayed in the table. To remove the filter and show all available messages again, clear the query text field and apply the filter again. If the filter is applied, the number of found (filtered) messages is displayed on the left.


Attention!
The filter only works on the current page with messages. However, when you go through the pages, the filter is applied to each new page automatically.


Deleting Messages

The message can be deleted if you think it is invalid. To delete messages you need to have enough the appropriate access to the unit.

In the last column of the table, mark the messages that should be deleted (one or more). Then click the Delete button and confirm your intentions. If the checkbox in the header of the table is ticked, all messages on the current page will be selected.

After the operation, the newly deleted messages still remain in the table, but become inactive. The next time when you load messages, the deleted messages will be completely removed from the database.


Note.
It is impossible to delete the last incoming message, as well as the last message with the position (valid coordinates). That is why the delete checkbox for these messages is always dimmed.





Follow us on
Facebook Gurtam Wialon Twitter Gurtam Wialon


    • Related Articles

    • Data Messages

      If you request messages with data, the table of messages will contain information about the message time, speed, coordinates, location, and available parameters. In addition, in the Statistics section you can find summary information. There you will ...
    • Messages

      The Messages panel gives access to the units database. Here you can view all messages received from units (coordinates, parameters, speed, etc.), as well as SMS messages received from them, commands sent to units and events registered in units ...
    • Working with Accounts

      Working with accounts and resources is possible only in CMS Manager. Click on Accounts in the navigation panel. Here you can: create new accounts and resources; find and display existent accounts and resources; control the balance of a client, add ...
    • SMS Messages

      SMS messages can be sent by a unit while executing a command, generating an alarm or in other cases, which depend on the device type. The table generated for this request consists of three columns: the time when the message was received, the text of ...
    • Messages Tracing

      The main objective of this report is to facilitate the work with the parameters from the messages. That is why the parameter values are presented not as a single data array, but have a particular structure. It means that every parameter is located in ...