106 Ridgeway Suite F Hot Springs, Arkansas 71901
(501) 762-6745
Owner:
Show Address:
Yes No


Save
Close

Jobs

A job is a set of actions to be performed on a predefined schedule. A job can be command execution, sending reports by e-mail, changing access to units, etc.

To configure jobs, open the Jobs panel choosing a corresponding name in the top panel or clicking on the necessary item in the main menu customizer. Here you can see the list of all jobs created, information on their state, and the button to create a new job. In the list, jobs are sorted by name. Use the dynamic filter to save your time when looking for a certain job.

Input job name or its part into the search box and observe the results. The other way to filter jobs can be used if you have access to more than one resource. Then, on the dropdown list, choose a resource to display only jobs belonging to it.

Direct a mouse pointer over a job to view details in the tooltip: job type, parameters, schedule, last execution time (whether successful or not), resource (if there is access to several), and other parameters depending on job configuration. In columns on the right, you can see job state (on/off), the number of executions already made, and the number of maximum executions allowed.

In the panel, the following icons and buttons are used:

Job type Different kinds of jobs are marked with special icons in the first column: — command execution; — sending report by e-mail; — sending information about fuel by e-mail or SMS; — access management; — job on engine hours counting; — job on mileage counting; — job on GPRS traffic counting.
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.
The first (left) column shows how many successful executions there were; the second (right) column shows maximum executions allowed.
Buttons to view and/or alter job properties (depending on your access).
Create a new job on the basis of this one.
Delete selected job.


:!:Note. If a job belongs to some resource to which you do not have access rights to Create, edit, and delete jobs, then some kind of actions towards this job, such as enable/disable, edit or delete will be unavailable.

Configuring Jobs

:!:To make manipulations with jobs, you should have at least one resource with the access right Create, edit, and delete jobs.

To create a new job, press the New button. In the dialog choose job type:

  • Execute a command over unit(s),
  • Change access to units,
  • Send a report by e-mail,
  • Send fuel information by e-mail or SMS,
  • Mileage counters,
  • Engine hours counters,
  • GPRS traffic counters.

Then follow instructions in the dialog. For any type, you must 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 for Jobs and Notifications

:!:Access required: Use unit in jobs, notifications, routes, retranslators (resource's creator where the job belongs is supposed to have this access to units to assign then this job).

Dialog of choosing units for a job or notification consists of the units currently displayed in the work list of the Monitoring panel.

If you see no units, press the 'Display all' button . If it does not help, it means there is not enough access to any of units.

You can switch between units and groups by clicking the switch-button / . If a unit group have been selected, then the action is applied to all the units the group contains on the moment of action implementation. The list of current units you can find in a group's tooltip.

Mark units/groups to apply a job/notification to. Put the flag in the header of the table to select all items.

Please note that if there are more than a hundred units on this page, their icons are not displayed.

While editing a job or notification, this page contains units selected for the job (they are checked) and units displayed on the work list currently. You can add more units for the action or remove some. However, only unit with Use unit in jobs… flag can be displayed here. If a job or notification that you are editing contains units to which you have not enough rights, you will be warned about it and in case you save the job/notification, those units will be lost.

Parameters for Jobs

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

Name: It is used in the list of jobs or as mail topic if the job is to send some information by e-mail.

Description: Job description is optional. Is can appear in job's tooltip.

Execution schedule: Use one of two ways to set job's schedule:

(1) Periodic execution — each N hours and/or minutes. (2) On schedule. Execution time is set in 24-hour format hours: minutes or just hours. If you need to indicate several points in time, separate them with spaces. Example:

8:00 22:00

In this case, the job will be executed at 8 AM and 10 PM daily (if other conditions concerning execution days are not set on the Time Limitation tab).

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

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

Enabled: 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 limitation: 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, choose a command to be executed from the given list. The list consists of all commands that are configured in selected units (if you have Execute commands rights to these units).

Not all selected units may be able to execute a chosen command, and it is seen from the indicator:

  • a green sign means that all the selected units support this command;
  • a yellow triangle means that not all the selected units can perform it (see details in the tooltip)

Restrictions can be placed due to access rights or device type used.

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

:!:Attention! When the time comes to execute a command as a job, all kinds of rights are checked beforehand. The user who is a creator of a resource where the job belongs should have the following access flags to unit: 'Execute commands' and the set of flags specified in properties of this command.

Change Access to Units

This job is aimed to change users' access rights automatically, for example, if you want to give someone demo access for several days or restrict access to working hours.

To configure this job, select users and assign them new access. On the list, there are only users to which you have access Manage user's access rights.

Check necessary users on the left and indicate access flags on the right. You can set flags, remove flags, or leave them untouched.

:!:Attention! This type of job can be performed successfully only if at the time of its execution necessary rights are OK. The user who is a creator of the resource where the job belongs should have unit ACL flag 'Manage access to this item'.

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).

Choose report template, file format(s) and parameters. Specify time interval — for previous … minutes/days/weeks/months/years. In the Recipients section enter e-mail address(s) where to send reports.

In the list of report templates, only those that belong to the same resource as the job are displayed. Depending on template type, you choose appropriate objects for report generation in the next page of the dialog — units, groups, users, drivers, routes, resources, or retranslators. To apply the job for those objects, you should have a special access to them — Query messages or reports (besides, units are taken here from the work list of the Monitoring panel).

Only compressed files of reports can be sent as a job. Subject for the e-mail is taken from the name of job, and the repository itself derives its name from the report template name plus data (yyyy-mm-dd). After you have received a letter with a report, extract files to some folder and open them with appropriate applications depending on file formats.

:!:Note. If the workday sometimes finishes 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 finished after midnight will not be divided into two parts.

Send Information about Fuel

You can get information about fuel (fillings, thefts, fuel level) by e-mail or SMS per 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) in the international format. When all slots to enter e-mails and phones are filled, additional slots appear automatically. Note that if the flag 'Can send SMS' is not chosen in user properties, then the corresponding delivery method becomes unavailable.
  • Message form: one unit in one message or all units in one message.
  • Time offset (in minutes): a parameter which allows you to analyze messages from the black box. In this case, time offset value is subtracted from interval beginning.

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

<copy> Unit Name x a/b/c </copy> 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;
  • b — fuel filling;
  • c — fuel theft.

For example, SMS message

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


means that per the first sensor the unit Iveco_1501 has 66 lt of fuel, and no fillings and thefts were detected; per the second 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).

:!:Note. Whether fuel volume will be sent in liters or gallons, depends on resource settings (where the job belongs) and not on units' settings.

Jobs about Counters

Counters of three types are used in G4L tracking system: counters of GPRS traffic, mileage, and engine hours. They can be set up in unit properties.

Jobs about counters allow you to automate accounting of mileage, engine hours, and GPRS traffic.

Mileage Counters

This kind of job can help you to fulfill control over mileage counter automatically, per the 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. The counter will obtain this value each time when the job is executed. Depending on resource settings, different measurement systems can be used.

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 event history can be used to store current mileage counter value. It is especially recommended if per the job properties, the counter must be reset or altered.

Engine Hours Counters

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.

:!:Attention! This types of job can be performed successfully only if at the time of its execution all necessary rights are OK. The user who is a creator of the resource where the job belongs should have unit ACL flag 'Edit counters'.

Counters' values (traffic, mileage, engine hours) are stored in unit history as registered events, which is needed for creating reports – Events or Chronology. When counter values are stored as parameters, it means new data messages are added to unit database. Those messages bear data message type, and mileage and engine hours are displayed there in meters or feet (depending on unit's properties) and seconds correspondingly.

GPRS Traffic Counters

This job is aimed to:

  1. Automate traffic counter reset;
  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.