Jobs

:!: Attention! This module is licensed separately and can be not included in your package.

A job is a set of actions which are performed by schedule. A job can be instruction execution, sending reports by e-mail or something else.

To create, edit and delete jobs, click Jobs in the top menu. On the left you will see the list of all jobs created before, information on their state, and the button to create a new job.

Creating a Job

To create a new job, press the green plus button. In the dialog choose one of job types:

Then follow instructions in the dialog. For any type you have to select units to apply this job to and set the basic parameters like activation time and schedule. For each type of job adjust also individual parameters described below.

Selecting Units

By default, only units which are on the work list at the moment are displayed in the dialog (the list is taken from monitoring in the units mode even if the groups mode is activated). To switch between units and groups use the selector on the left. To show all available units or unit groups, check the box Display all available units/groups on the top.

Mark units/groups to apply the notification to. If you select a group, it means the job will be applied to all units in this group.

While editing a job, this page contains units selected for the job (they are checked) and units displayed on the work list at the moment. You can attach more units to the job or remove some.

Depending on job type and your access to different units, some units can be skipped on the list. For example, when creating a job to execute a command or reset traffic, units to which you have view access cannot be shown because these actions require execute commands rights and higher. A job about changing users access can be created only for units to which you have manage access.

Basic Parameters for Jobs

These parameters are adjusted in the last page of the dialog:

Job name
The name can contain four and more symbols. It will be used on jobs list or as mail topic if the job is to send some information by e-mail.

Job description
Job description is optional. Is can appear in job tooltip.

Execution schedule
Two ways to set schedule exist:
(1) Periodic execution: each … hours and minutes.
(2) On schedule. Key in time in the format of hours:minutes or just hours. If you need to indicate several points in time, separate them by spaces.

Activation time
Date and time when the job will be activated.

Maximum executions
Enter the number of job executions after which it will automatically deleted. If you leave this field empty, the job will be executed endlessly until you delete it or disable manually.

Enable
This check box indicated whether the job is on or off. When creating a job, enable this check box to activate the job just after creation. If this check box is not marked, the job will appear on the list anyway, and you can activate it later.

Time limitations
In the right part of the dialog one can define time limitations by days, months, time, etc. For instance, the job can be assigned to a unit just on weekdays and within working hours from 9 AM to 6 PM. Or you may want to reset traffic counter once a month on the first day of the month. To do this, select the day 1.

Job name and schedule are required fields, other parameters are optional.

Execute a Command over a Unit

While creating a job of this type, you have to choose a command to be executed from the given list of commands supported by selected units. The contents of the list depends on your equipment and its configuration.

Not all of selected units may support a chosen command, and it is seen from the indicator:
a green sign means that all selected units support this command;
a yellow triangle means that not all of selected units can perform this job. In a popup window you can see the list of units which do not support it.

If the selected command is not an alias, you can choose also link type: Auto, TCP, UDP, Virtual, SMS. Supported link types can vary in different units. That is why if you assign the job to several units, it is useful to set Auto link type. Then the program will automatically define it for each unit.

For some commands you should set additional parameters like input/output number, online report interval, etc.
More about executing commands...

GPRS Traffic Accounting

This job is aimed to (1) automate traffic counter reset and/or (2) store GPRS traffic counter value in unit's history. For example, you can assign to reset the traffic counter once a month and register each reset with the current value in unit history.

Indicate the status of the option Store counter value in unit history. If the option is activated, each reset is registered in the system, and then you can generate a report on events or report on traffic to see traffic consumption. If the option is not activated, resets are not registered anywhere.

The option Reset GPRS traffic counter is to set the counter to 0 each time when the job is performed.

Modify Users Access Level

  This job is aimed to change user right when needed, for example, if you want to give someone demo access for several days.

To configure this job, select users and assign them a new level of access. On the list there are only users to which you have manage rights.

Check necessary users and select access level from the list of available levels:

  • none (deny access),
  • view,
  • execute commands,
  • edit.

Mileage Accounting

This kind of job can help you to fulfill control over mileage counter automatically, according to schedule. With this job you can store mileage counter value in unit history, reset mileage counter, set a new value for it, save its value as parameter in data message.

To set a new value or to reset the counter, choose the option Set new value for mileage counter and input the desired value below (in kilometers). The counter will obtain this value each time when the job is executed.

Set the flag Store counter value as parameter of unit data message to save the counter value as parameter in data message. Later on it can be used to get initial and final mileage for trips. It is recommended to store the counter while the unit is parked, for example, once a day at night time.

The option Store counter value in unit history can be used to store current mileage counter value. It is especially recommended if according to the job properties, the counter has to be reset or altered.

Engine Hours Accounting

This is analogue of the previous type of job but it is applied to engine hours sensors.

If you store engine hours sensor as parameter in data message, you can use this parameter to create engine hours sensor on its basis.

:!: Counters' values (traffic, mileage, engine hours) are stored in unit history as registered events, which is needed for creating reports - Events or Chronology.

Send Information about Fuel

You can get information about fuel (fillings, thefts, fuel level) by e-mail or SMS according to predefined schedule. This information is given in liters only.

To detect fuel fillings and thefts, the appropriate unit settings are used (see Unit Properties => Fuel Consumption).

Additional parameters to configure this report are:

Event type: filling, theft, fuel level (all three can be chosen). Fuel level means fuel level at the beginning and at the end of the interval (the interval is set later).

Method of delivery: by e-mail and/or SMS. On the right enter your e-mail(s) and phone number(s). When all slots to enter e-mails and phones are filled, additional slots appear automatically.

Message type: one unit in one message or all units in one message.

Time offset (in minutes). This parameter allows you to analyze messages from the black box. In this case, time offset value is subtracted from interval beginning and end.

:!: Note.
Information about fuel filling and thefts is sent only in case if any has been detected. Information about fuel level is given in any case.

SMS format:

Unit Name
x a/b/c

where

  • Unit Name is unit name as set in unit properties (to save traffic it is recommended to use no other letters but Latin);
  • x - sensor number;
  • a - fuel level (in liters);
  • b - fuel filling (in liters);
  • c - fuel theft (in liters).

For example, SMS message

Iveco_1501
1 66/-/-
2 100/-/10

means that according to the first sensor the unit Iveco_1501 has 66 lt of fuel, and no fillings and thefts were detected; according to the sencond sensor (fuel in the second tank, for example) fuel level is 100 lt, no fillings were found, and 10 lt theft was detected.

Dashes may mean one of the following:

  1. The corresponding flag is not ticked in job parameters. For example, it is not chosen to send fuel level.
  2. There are no valid data (it may happen with fuel level).
  3. Required events were not detected (it may happen with fillings and thefts).

Send a Report by E-mail

This job can be used to automatically generate and send reports about units activity to your e-mail(s).

Set additional parameters:

  • On the dropdown list select a report template from available items.
  • File format: HTML, PDF, Excel, XML, CSV.
  • Compress report files or not.
  • Attach the map image to the report or not. Note that the image will make a report larger. Only WebGIS map can be attached to the report.
  • Report interval: a specified interval or previous … days/weeks/months/years.
  • Recipients: enter e-mail address(es) where to send reports.

After you have received a letter with a report, extract the file to some folder and open it with the appropriate application depending on the file format.

:!: Note.
If in your company the workday sometimes finished after midnight (because some vehicles may arrive late at night), then you can adjust the parameters for the daily report in the following way. Select report interval 'for previous 24 hours' and set job activation time at 4 AM. Then the report will be automatically generated every day at 4 AM. It will contain data for the last day, and the trips which finished after midnight will not be broken into two parts.

Assign Route

:!: This kind of job is available only in you have Routes Control module.

Using this job, you can set automatic route assignment according to the given schedule. Set parameters to create a new route: name, description, geofence and others. See Route Control for details.

When the time comes to do the jobs, the new route will be created. It will appear in the Routes Control panel and can be tracked online or in reports.

Remove Route

Routes removal can be used to automatically clean Routes Control panel. For instance, once a day in a certain time all routes assigned to the unit can be deleted.

This is especially actual for finished routes. To remove only finished routes, set the option Remove finished routes only.

Jobs Management

The list of jobs contains the following information: job type, job name (in a popup window there is a full information); job state (enabled/disabled); how many time the job has been already executed and the number of maximum executions allowed.

— command execution;
— sending report by e-mail;
— sending information about fuel;
— access management;
— GPRS traffic accounting;
— mileage accounting;
— engine hours accounting;
— assign route;
— remove route.

Hover a mouse pointer over a job to view its properties in a tooltip. On the list you see job state (on/off), the number of executions already made, and the number of maximum executions provided for this job.

Clicking on job state sign at the header of the table, you can enable/disable all jobs at once (if you have access rights on them). Enable or disable a certain job.

One can also handle jobs in the following way:

Change job properties.
Create a new job on the basis of this one.
Delete a job.

If a job belongs to some account to which your access is view, it will be still executed, but you will not be allowed to change it in any way. In his situation, the buttons look different:
job is enabled, but you cannot disable it,
job is disabled, but you cannot enable it,
view job properties (edition not available),
impossible to delete the job.

The dynamic filter will save your time when managing jobs. Input job name or its part into the search box and see the results.

The other way to filter jobs can be used if you have access to more than one account. Then on the dropdown list choose account name to display only jobs belonging to this account. Note that if you have just view rights to an account, you cannot edit or delete these jobs.

Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2017 Gurtam