X-Rayl DOT Link Administratorhandbuch V2.12.en DOC001062018

®
X-Rayl DOT Link

Administrator Manual
X-Rayl® DOT-Link
Date: 11.09.2019
Dok. Nr.: DOC001062018
Version: 2.12 en Copyright © DOT Telematik und Systemtechnik GmbH. All rights reserved
The disclosure without authorization of DOT Telematik is not permitted
DOT Telematik GmbH, Revision 000, valid from 2019-04
FB 8 3 8 User Manual DOT-Link Web Portal
Firmensitz: Glanzinggasse 35/1/1D • A-1190 Wien • T: +43 1 990 86 13 • E-Mail: info@dot-telematik.com • www.dot-telematik.com
Betriebstätte: DOT-Solarpark • Im Atzersfeld 2 • A- 2100 Leobendorf / Niederösterreich • T: +43 2262 22375 • F: +43 2262 66065
Firmenbuch: FN 240567a • Handelsgericht: Wien • Bankverbindung: IBAN=AT842011128211981500, BIC=GIBAATWWXXX • UID: ATU57395116
Table of Contents
Introduction ................................................................................................................................................3
1.1 Target Group ........................................................................................................................................... 3
1.2 From Pointer to Asset .............................................................................................................................. 3
1.3 Terms and Definitions .............................................................................................................................. 4
1.4 Customer Login ....................................................................................................................................... 5
1.5 Main View ................................................................................................................................................ 6
1.6 General Operating Instructions ................................................................................................................ 6
Assets ........................................................................................................................................................8
2.1 Overview .................................................................................................................................................. 8
2.2 Details .................................................................................................................................................... 14
Pointer ......................................................................................................................................................18
3.1 Overview ................................................................................................................................................ 18
3.2 Details .................................................................................................................................................... 21
3.3 Graphs ................................................................................................................................................... 24
Sensors ....................................................................................................................................................27
4.1 Overview ................................................................................................................................................ 27
4.2 Graphs ................................................................................................................................................... 28
Settings ....................................................................................................................................................31
5.1 General Information ............................................................................................................................... 31
5.2 Groups ................................................................................................................................................... 32
5.3 Depots.................................................................................................................................................... 32
5.4 Geofencing............................................................................................................................................. 32
Administration ..........................................................................................................................................35
6.1 Asset Administration .............................................................................................................................. 35
6.2 Pointer Activation ................................................................................................................................... 35
6.3 Pointer Administration ............................................................................................................................ 35
6.4 User Administration ............................................................................................................................... 35
6.5 Receiver ................................................................................................................................................. 37
6.6 Notifications ........................................................................................................................................... 37
Language .................................................................................................................................................38
2 - 38
Introduction
The X-Rayl® DOT-LINK Portal is the online portal for retrieval of the data collected by the X-Rayl® Solar Pointer.
The X-Rayl® GPS positioning system is specially adapted to the needs of rail freight traffic. The user must log
on to an SSL-secured website using a user name and password. The data transfer is encrypted. Each X-Rayl®
locating device can be assigned to an object, so-called "ASSET" (e.g. wagon or container). The activation of the
devices and the assignment to an asset can be carried out independently by the user on the web portal.
Information about one or more assets can be displayed in real time and filtered according to various criteria. In
addition, different views (e.g. map view or list view) and numerous statistics are available. Data from third-party
devices can also be integrated. The data query contains both current and historical data.
1.1 Target Group

With DOT-Link it is possible to track various moving objects on which X-Rayl® pointers have been mounted.
The following functions are included:
• Current status (position, sensors, etc.)
• Time line up to 6 months back in time (more on request)
• Graphical representation of data on the time axis
• Statistical functions, such as usage rate based on depots
• Events that occur due to sensors
• Events that occur due to Geofences, e.g. the stay in predefined geographical areas.
1.2 From Pointer to Asset

The X-Rayl® Pointer is mounted on a moving object. This marriage or assignment can take place via app during
assembly in the factory or in DOT-Link under activation. DOT-Link then offers two views: The Asset View and
the Pointer View. Both differ considerably, as the Assets View shows stops and places and the Pointer View
shows time intervals and thus all pointer data. Both are displayed in the first view in tabular form one above the
other.
Figure 1 Aggregation of asset view

In the asset view, all position reports from the same location are summarized (aggregated). This difference
results in the Asset View showing a standstill at a location with only one line, whereas the Pointer View shows
as many lines as intervals fit into the length of stay. The Asset View provides a better overview and the Pointer
View a better detail resolution. This difference is reflected in all other views (map, etc.).
3 - 38
Figure 2 Standstills are shown as points in Asset View
1.3 Terms and Definitions

This section explains the most important terms that are necessary for understanding the following pages.
1.3.1 Interval
The interval is the time interval between two messages sent by the pointer. There are basically four different
intervals, which can have different lengths. The Send Interval (SDI) at which the pointer actually sends, the
Positioning Interval (POS) at which the pointer detects its position, the Wake-Up Interval (WKI) at which the
pointer wakes up to see if there is a configuration change, and the Sensor Interval (SSI) at which sensor values
are detected.
1.3.2 Asset
An asset is the object (freight wagon, container, etc.) on which the pointer is mounted, and which is to be
tracked and monitored.
1.3.3 Pointer
The pointer is the telematics system located on the asset (freight car, container, etc.). The pointer sends its data
and those of the paired sensors (optional) at intervals (e.g. 15 minutes).
1.3.4 Sensor
Sensors can be located in the pointer housing or connected to the pointer by radio. The latter requires the use
of the X-Rayl® Sensor Box, of which several can be paired to the pointer and with which e.g. boiler
temperatures, loading, etc. can be recorded. The Sensor Box is connected to the pointer via a radio interface
(2.4GHz) and has its own interval. The Sensor Box has its own processor and can intelligently recognize
thresholds, analyze measured values to the extent of changes (gradients) and react (transmit) on the basis of
remotely configurable limit values.
4 - 38
1.3.5 Energy reserve
Since most assets (freight wagons, containers, etc.) do not have a power supply, telematics systems require
their own self-sufficient power supply. In contrast to conventional products, the X-Rayl® Pointer draws its
energy from a solar cell, which in turn can store the energy to bridge times without daylight. This time is called
the energy reserve and is expressed as a percentage. With 100%, a pointer can transmit for around three
months at a transmission interval of 60 minutes without light. This energy reserve depends on many factors
(installation location, intervals, mobile phone supply, START/STOP automatic, etc.). In the period between
March and October, the pointer can be operated with a 3-minute interval between travel and transmission
without noticeably touching the energy reserve. During the rest of the period, driving intervals of 15 minutes are
possible. Naturally, the trip proportion is decisive.
1.3.6 Automatic Start/Stop Function

The X-Rayl® Pointer has a 3-axis acceleration sensor with which it detects with high precision whether it is
moving or at a standstill. This makes it possible to shorten the transmission interval during travel and extend it
when the vehicle is at a standstill, thus saving energy.
1.3.7 Position
The geoposition (short: position) is the geographical location of the asset/pointer and is determined by GPS,
Galileo and Glonass. In addition, mobile phone data can refine the position determination. The accuracy of the
position determination is determined by using the best products available on the market and is usually around
10m.
1.3.8 Time Base

The pointer can traverse time zones and, to avoid complexity, uses a single time base: GPS time and is
essentially identical to the so-called Coordinated World Time (UTC). Since the pointer sends its data to DOT-
Link, where the servers work with MEZ/CET or MESZ/CEST/CEDT, there is a time difference of up to 2 hours
between the times.
1.3.9 Entry timestamp

Time specification in CET/CET or CEST/CEDT of the entry of an incoming message in the DOT-Link database.
1.3.10 Last SMS

Date in UTC time of the last transmission of a pointer.
1.4 Customer Login

The customer login is located at www.dot-telematik.com and is secured by a password.
5 - 38
1.5 Main View
After logging in, the main view appears with the following menu items, which are explained in detail in this
manual:
Assets - Pointers - Sensors - Settings - Administration - Language
Figure 3 Main view
The most important menu items are Assets and Pointers. Assets are the objects (freight wagons, containers,
etc.) on which a pointer is mounted. While under "Assets" the view is "aggregated", i.e. a new row is displayed
during movement, the view "Pointer" is organized in regular time intervals. A pointer at standstill thus creates a
new line after each interval.
In the main view, a table is displayed at the top left. A connected map is displayed next to it on the right. The
statistics are displayed below it. These areas can be folded in and out. Please refer to "General Operating
Instructions".
1.6 General Operating Instructions

1.6.1 Notes on the map views
By clicking on Close/Open the whole map can either be shown or hidden.
The map can be zoomed with +/-.
In general, the map view is set to "Normal". By clicking on it, the map views Normal/Cluster/Heatmap are
available.
6 - 38
Figure 4 Display components of maps
Figure 5 Map mode selection
A detailed explanation can be found in the chapter "Assets".
1.6.1.1 Symbols for displaying the current position

For Assets the current position is either displayed as a point, if the asset is currently not moving, or as an arrow,
if the asset is currently moving, which points to the direction of the movement. Note: Display of arrows is not
possible in asset details due to the aggregation of the data.
For pointers the current position is displayed either as a point, circle or arrow. These symbols have the following
meaning:
• Point – the last report from the pointer has reported a speed of 0 km/h and the current position was
determined via satellite radiolocation. As the pointer is not moving the current position is depicted as a
point.
• Circle – the current position was determined via radiolocation from the mobile network. Neither speed
nor direction exist in this scenario.
• Arrow – the last report from the pointer has reported a valid speed and the current position was
determined via satellite radiolocation. Therefore, the pointer has a direction in which it moves and the
arrow points to this direction.
1.6.2 Notes on Symbols

By pointing with the mouse on one of the square symbols for approx. 2 seconds, the explanation for this symbol
is automatically displayed - see example "Details".
Figure 6 Display of tooltips
1.6.3 Screen layout

The size of the list in the left area, the map in the right area and the graphics in the lower area can be
individually adjusted by moving the boundary lines with the mouse.
7 - 38
1.6.4 Sorting
In all list views, you can sort by various criteria by clicking on the respective menu item at the top of the menu
bar, e.g. by driven KM or by country or by asset name.
Assets
The Assets view is displayed immediately after logging in. In this view, the assets (wagons, containers, etc.) and
their current locations, the periods of stay and the running performance are visible. The positions of an asset are
displayed aggregated in this view. This means that several position reports for the same location are combined
if the pointer moves only minimally, depending on the positioning interval set. This increases the clarity when
the
X-RAYL® Pointer of the asset sends multiple position reports from the same location.
2.1 Overview Actions
List
Map
Figure 7 View components
The overview displays the list and a map. The list shows all assets, their current locations, the times they have
been in a location, and their past performance. The data in this view is automatically updated every 60 seconds.
The Delta-KM column shows the distance travelled during the last stage (i.e. the time line of the locations shown
under Details).
8 - 38
2.1.1 Display Components
2.1.1.1 List
The list displays the data of this view in a tabular form. In the header of this list, a filter criterion for the list can be
entered for each column in the input field below the column name. For example, for the Country column, the
value "DE" can be entered to restrict the list to all assets currently located in Germany. These input fields
support regular expressions for extended filtering options. For example, the value "DE|AT" can be entered in the
Country input field to restrict it to all assets in Germany or Austria
Actions and Displays

Column Selection/ Opens a dialog for selecting the columns to be displayed. The columns
columns to be displayed are dragged with the mouse into the SHOW area or the
columns not to be displayed into the HIDE area. The width of the
column can also be entered in the SHOW area. The column width can
also be changed directly in the list with the mouse. To do this, click
with the mouse in the header line at the end of the column with the title
until <-||-> appears, then move the column border while holding down
the mouse button.
Set Filter/ Opens a dialog to save the filter criteria currently entered in the header
filters as a filter. A name is entered in the "Filter Name" field in order to save
it afterwards. Saved filters can be applied to the table by selecting
them from the "Active filters" list. The dialog also allows you to rename
filters or delete filters.
The Default selection specifies that this filter is automatically applied to
the list when the view is opened.
The Shortcut selection specifies that this filter is displayed as a button
next to the "Active filter" selection list in the table header.
Clear Filter/ This button removes all filter criteria applied to the table and displays
clear filter the contents of the table unfiltered.
Select Visible/ This button selects all records currently displayed in the table for
select visible further actions. If all rows are already selected, all rows are deselected.
CSV Export Exports the lines marked in the table to a CSV file and starts the
download of this file.
Update/ Triggers an update of the data.
reload
Details Opens the detail view for the selected assets. Please note that the
desired assets must first be selected in the overview list. Several
assets can be selected at the same time. In the detail view, you can
also freely select the time period for the details.
Pointer Opens the overview of pointers assigned to the selected assets.
Zoom Asset/Pointer Zooms the map to the location of the currently active row in the table.
The currently active row is the one with the framed field.
Zoom Map Zooms the map to the currently filtered rows in the table. This function
is only available for map modes “Normal” and “Cluster”.
Asset Grouping/ Opens a dialog to combine the selected assets into a group. These
car group groups can be applied to the table by selecting the group in the Active
Filter drop-down list.
9 - 38
Assign Color/ Opens a dialog to assign a color to the selected assets. This color is
car color used for the markers on the maps and is displayed next to the name of
an asset.
Reports Opens the dialog for creating reports. See section 2.1.1.4
Asset / pointer Opens the Asset / pointer associations view. See chapter 2.1.1.5
associations
Asset / tag Opens the Asset / tag associations view. See chapter 2.1.1.6
associations
Rows Displays the number of selected rows and the total number of rows
contained in the table, e.g. 2/168.
The selection of individual assets is done by clicking on the respective
asset in the list.
Active Filters Active Filter Displays the filter or asset group currently applied to the
list. This button only appears if a filter has been created.
Shortcuts If filters with the Shortcut flag have been saved, they are displayed as
a button next to the "Active filter" list. By clicking with the mouse on
such a button, the corresponding filter is applied to the table.
2.1.1.2 Map
The map displays the current position of the assets as a point or as an arrow. If the position is displayed as an
arrow, the asset is moving and the arrow points to the direction of this movement. In case the position is
depicted as a point, the asset is currently not moving. For more details on this see section 1.6.1.1 Symbols for
displaying the current position. A mouse click on a location marker displays a popup with the name of the asset,
10 - 38
the time since the asset has been in the current location, and the name of the location. At the same time, the
corresponding row in the list is highlighted.
Figure 8 Assets overview map
With the button shown in the upper left corner outside the map, the map can be collapsed to give the list more
space for the display. Another mouse click on this button opens the map again.
The map can be zoomed by +/-.
2.1.1.3 Map Mode

The map offers three different display modes. These can be set in the upper left corner of the map.
Normal: for each asset a blue dot is displayed at the current location. Items in this list can be selected by
clicking on the respective line in the asset list. When a location in the list is selected, it is marked on the map by
a red dot. In this way, several points on the map can be highlighted.
Cluster: Positions in the immediate vicinity are combined and displayed as larger points on the map. The
number of position points contained in each cluster point is displayed. In addition, the cluster points are also
displayed in different colors, depending on the number of position points contained. These points are labelled
with the number of positions that are represented. If the mouse pointer is moved over one of the points, a
polygon is displayed that describes the area in which the corresponding positions are located in more detail. In
addition, cluster points are colored in a gradient from green to yellow to red according to the number of positions
represented.
Heatmap: Aggregated position points are represented as a heat map by colored markings. Areas on the map
are displayed in different colors depending on the number of position points. Areas with fewer positions are
displayed in blue, areas with high density (many positions) in yellow and red. The color display of the heatmap
always depends on the currently selected zoom level of the map view.
11 - 38
Figure 9 Map modes
Map Type
In the Map type selection, you can choose between the display "OSM (OpenStreetMap)" or "Transport Map" to
display different topographic elements. See Figure 8 Assets overview map.
Furthermore, the Geofences or Depots can be shown or hidden in this selection.
2.1.1.4 Reports
Creation
In the Reports dialog (accessible via the Reports button in the toolbar) you can create a report. First select the
report to be created and then the desired output format. Then enter the other parameters and press the "Start"
button to start the report creation.
Figure 10 Dialog for creating reports

12 - 38
Mileage
This report lists the mileage for the selected assets for the specified time period.
Parameters
Name Optional Description
Output Format No Selection of the output format. This report supports the
output formats CSV, PDF and HTML.
File Name Yes File name used to save the file in the Downloads
folder. If not specified, the report will be saved with the
name Mileage
from Yes Date from which the mileage calculation is to be
performed.
to Yes Date up to which the mileage calculation is to be
carried out.
Output
Column Header Description
Vehicle No. Asset Name
Pointer No. Pointer Name
active since Date of activation of the pointer to the asset. For the output formats PDF and HTML,
this date is displayed in red if the activation date lies within the query period, i.e. the
assignment of asset to pointer was carried out after the parameter "from".
from First position date (arrival) within the query period. Corresponds to the "to" column
in the Assets view.
to Last Position Date (Departure) within the query period. This date may be outside
the query period if an asset arrives at a location within the query period and leaves
it after the query period.
Sum KM Sum of kilometres travelled within the time range from and to.
2.1.1.5 Asset pointer associations view

This view displays the timeline of car and pointer associations. The data table contains the timestamp “from”
and the timestamp “to” which show the time range when this association was valid. If the timestamp to is empty,
the association is still valid. Furthermore, does the table show the user who performed the association and if it
was done with the X-Rayl Scanner App. In case the association was done with the app the scan images are
displayed if available.
2.1.1.6 Asset tag associations view

This view shows the asset to tag associations done with the X-Rayl Scanner App. The data table shows the
asset and tag value, the timestamp and the user who performed the tag association. If a scan image is
available, it is displayed as well. With the input fields you can control the time range displayed in the data table.
13 - 38
2.2 Details
The detailed view shows the timeline of the locations and the mileage of the selected assets.
To get to the detail view, select one or more assets in the list in the main view "Assets" and press the symbol
„Detail“
Alternatively, the selection in the list can be made by a DOUBLE CLICK on the desired asset. A new tab opens
with the detailed view. The name of the selected asset(s) is displayed directly next to the number of rows in the
upper right corner.
Figure 11 Asset details
2.2.1 Display components
2.2.1.1 List
The list in the Details pane displays the data of the selected assets in tabular form. The name of the selected
assets is displayed in the rightmost icon row. As in the overview list, filter criteria for filtering the table (e.g. a
specific location or country) can also be entered in the header. See also the description of the list in the section
Overview.
Actions and displays

Column Selection/ Opens a dialog for selecting the columns to be displayed. To do this,
Columns drag the columns to be displayed with the mouse into the SHOW area
14 - 38
or the columns not to be displayed into the HIDE area. The width of the
also be changed directly in the list with the mouse. To do this, use the
mouse in the header line at the end of the column with the title
CLICKED, and then drag the column border while holding down the
mouse button.
Set up filter/ Opens a dialog to save the current filter criteria entered in the header
filters as a filter. A name is entered and saved in the "Filter Name" field.
Saved filters can be applied to the table by selecting them from the
"Active filters" list. The dialog also allows you to rename filters or
delete filters.
Clear Filter/ This button removes all filter criteria applied to the table and displays
Row selection/ This button selects all records currently displayed in the table for
select visible further actions. If all rows are already selected, all rows are deselected.
Update/ Triggers and update of the data.
reload
Pointer Opens the details of the pointers assigned to the selected assets. The
selected query period is also taken into account in the pointer detail
view.
Start/Begin Sets the start of the query period. Only locations whose "since" date is
later than the value in this field are displayed.
End/End Defines the end of the query period. Only locations are displayed
whose "since" date is before the value in this field.
Rows/Rows Displays the number of rows selected and contained in the table.
Assets Displays the name of the assets selected to access the page in the
Overview. If there are more than two assets, only the names of two
assets are displayed and the number of selected assets is shown in
parentheses.
Active Filter/acitve filter Displays the filter or asset group currently applied to the list.
buttons next to the Active Filters list. By clicking with the mouse on
such a button, the corresponding filter is applied to the table.
2.2.1.2 Map
The map shows the location of the assets as a point over the query period. In this view the positions are always
displayed as points. Displaying arrows to indicate the movement direction is not possible due to the
aggregation of locations. For more details on this see section 1.6.1.1 Symbols for displaying the 15 - 38
current position. A mouse click on a location point displays a popup with the name of the asset, the time since
the asset has been in the current location, and the name of the location.
Map Mode
Like the overview map, the map offers the three map modes "Normal", "Cluster" and "Heatmap" for positions.
In addition, the map offers the "Route statistics" map mode for displaying the positions in the detailed view. In
this mode, the frequency with which the routes are travelled in the selected period is displayed. Note: This map
mode does not take into account the filters applied to the table. The route statistics for the query period and the
selected vehicles are always displayed when the view is called up.
Figure 12 Route statistics
In addition to the card modes for positions, this card also offers a display of the events "Door openings",
"Journey detected", "Standstill detected" and "Shock detected" if a notification configuration is stored for these.
The Administration chapter describes how a notification configuration can be stored. The individual events are
displayed as position points.
Map Type
In the Map type selection you can choose between the display "OSM (OpenStreetMap)" or "Transport map".
Furthermore, the defined Geofences or Depots can be shown or hidden in this selection.
.
16 - 38
Time line
The detailed map offers the possibility to display the chronological history of a day on the map. To do this, enter
the date for which the time line is to be displayed in the "Time line" input field on the map. The position points of
the selected day will then no longer be displayed as points, but as small boxes containing the time of the "since"
column. Position points that are not on the selected day are still displayed as points. The selected query period
(as entered in the input fields "Start" and "End") is available as the time period for the time course.
The time course can also be activated by a mouse click on the rail symbol in the popup of a position point. The
date of the "since" field is transferred to the "Time course" input field and the course of the day is displayed.
Figure 13 Representation of a time line
17 - 38
Pointer
This view shows the pointers and various data about the pointers. The data in this view are not aggregated but
displayed according to the position reports.
3.1 Overview
In the overview, the pointers and their current location, as well as various other details according to the last
position report of the pointer, are displayed.
3.1.1.1 List
The list displays the data of this view in a tabular form. In the header of this list, a filter criterion for the list can be
entered for each column in the input field under the column name. For example, the value "Ham" can be entered
for the column Location in order to filter for locations beginning with "Ham". These input fields support regular
expressions for extended filtering possibilities. So, the value "Ham" can be entered in the input field for location
to restrict to all pointers in locations starting with Ham or Ber. For details on Regular Expressions, please refer
to the relevant literature.
Actions and Displays

Column Selection/ Opens a dialog for selecting the columns to be displayed. The columns
Columns to be displayed are dragged with the mouse into the SHOW area or the
columns not to be displayed into the HIDE area. The width of the
also be changed directly in the list. To do this, click the mouse in the
header line at the end of the column with the title CLICKED, and then
drag the column border while holding down the mouse button.
delete filters.
Clear filter/ This button removes all filter criteria applied to the table and displays
Row selection/ This button selects all records currently displayed in the table for
select visible further actions. If all rows are already selected, All rows are
deselected.
reload
Details Opens the detail view for the selected pointers.
Assets Opens the overview of assets assigned to the selected pointers.
18 - 38
Grouping Opens a dialog to set an indicator for the selected pointers. Pointers
can be freely grouped according to three indicators. For example, you
can set an indicator for certain pointers and filter the table to these
pointers. One of the three indicators is selected in the dialog and the
value of the indicator is entered in the input field.
Asset Grouping/ Car group Opens a dialog to group the assets assigned to the pointers.
Car group These groups can be applied to the table by selecting the group in the
Active Filter drop-down list.
Graphs Opens a view for the graphical representation of various pointer
parameters over a period of time that can be entered. A more detailed
description of this view can be found in the section "Graphs".
Rows/Rows Displays the number of selected rows contained in the table.
Aktiver Filter/active filter Shows the saved filter or group currently applied to the list.
Shortcuts If filters with the Shortcut flag have been saved, they are displayed
next to the list.
3.1.1.2 Map
The map shows the current position of the pointers as a point, circle or arrow. For more details on this see
section 1.6.1.1 Symbols for displaying the current position. A mouse click on a position point displays a popup
with the name of the pointer, the time of the last message, and the name of the assigned asset (if available).
Figure 14 Overview Map for Pointers

With the button shown at the top left of the map, the map can be collapsed to give the list more space for the
display. Clicking this button again opens the map again.
19 - 38
Map mode
The map offers three different display modes.
Normal: for each pointer a point is displayed at the current location.
Cluster: Position points of pointers are combined to clusters. The number of position points contained in each
cluster point is displayed. In addition, the cluster points are also displayed in different colors depending on the
number of position points contained.
Heatmap: Position points are displayed as a heat map. The area on the map is displayed in different colors
depending on the number of position points.
Figure 15 Map modes
Map type
In the Map type selection, you can choose between the display "OSM (OpenStreetMap)'" or "Transport map".
See Figure 8 Overview map for pointers.
Furthermore, Geofences or depots can be shown or hidden in this selection.
3.1.1.3 Statistics
In addition to the list and map, the pointer overview also offers a statistics area that displays certain parameters
as pie or column diagrams. These diagrams can also be used for filtering. For this purpose, a pie chart is filtered
for a section or a column in the bar chart and the list and map are filtered for the selected criterion. Several
criteria from the diagrams can also be used for equal filtering. To do this, click on a second section or a second
column.
Figure 16 Statistic area in the pointer overview
20 - 38
In the case of pie charts, the buttons next to the title can be used to switch between the view of the pie chart or
a list display. Thus the number of pointers can also be read for small areas.
Figure 17 List view of pie chart
3.2 Details
The detailed view shows the chronological course of the locations of the selected pointers.
3.2.1.1 List
The list displays the data of this view in tabular form. As in the overview list, filter criteria for filtering the table
can also be entered here in the header. See also the description of the list in the section Overview.

Column Selection/ Columns Opens a dialog for selecting the columns to be displayed.
Columns The columns to be displayed are dragged with the mouse into the
SHOW area or the columns not to be displayed into the HIDE area.
The width of the column can also be entered in the SHOW area. The
column width can also be changed directly in the list. To do this, click
the mouse in the header line at the end of the column with the title
CLICKED, and then drag the column border while holding down the
mouse button.
"Active filters" list. The dialog also allows you to rename filters or de
next to the "Active filter" selection list in the table header.lete filters.
Clear filtering/ This button removes all filter criteria applied to the table and displays
clear filters the contents of the table unfiltered.
Row selection/ This button selects all data records currently displayed in the table for
select visible further actions. If all rows are already selected, the selection is
deselected for all rows.
21 - 38
reload
Assets Opens the details of the assets assigned to the selected pointers. The
selected query period is also taken into account in the pointer detail
view.
Graphs Opens a view for the graphical representation of various pointer
parameters over a time period that can be entered. A more detailed
description of this view can be found in the section "Graphs".
Start/Begin Defines the start of the query period. Only locations whose "since" date
is after the value in this field are displayed.
End/End Defines the end of the query period. Only locations whose "since" date
is before the value in this field are displayed.
Rows/Rows Zeigt die Anzahl gewählter und in der Tabelle enthaltener Zeilen an.
Pointer Displays the number of rows selected and contained in the table.
Pointer The name of the pointers that were selected to call the page in
the overview is displayed. If there are more than two pointers, only the
names of two pointers are displayed and in parentheses the number of
pointers selected.
Active Filter/active filters Displays the saved filter or group currently applied to the list.
a button next to the Active filters list. By clicking on such a button with
the mouse, the corresponding filter is applied to the table.
3.2.1.2 Map
The map shows the position of the pointers over the query period as a point, circle or arrow. For more details on
this see section 1.6.1.1 Symbols for displaying the current position. A mouse click on a position point displays a
popup with the name of the pointer, the time of the last message, and the name of the assigned asset (if
available).
Map mode
The map offers, like the overview map, the three map modes "Normal", "Cluster" and "Heatmap" for positions.
In addition to the map modes for positions, this map also offers a display of events such as shock and other
parameters (such as speed) that can also be displayed in the list. These parameters are not displayed as
22 - 38
points, but at the location where the value was measured, a rectangle is displayed containing the measured
value of the parameter.
Figure 18 Display of the parameter Speed (SPD) on the map
Map mode
In the Map type selection, you can choose between the display "OSM (OpenStreetMap)" or "Transport map".
See Figure 8 Overview map for pointers.
Furthermore, Geofences or depots can be shown or hidden in this selection.
Time line
The detailed map offers the possibility to display the chronological course of a day on the map. To do this, enter
the date for which the time line is to be displayed in the input field "Time line" in the map. The position points of
the selected day will then no longer be displayed as points, but as small boxes containing the time of the "since"
column. Position points that are not on the selected day are still displayed as points. The selected query period
(as entered in the input fields "Start" and "End") is available as the time period for the time course.
The time course can also be activated by a mouse click on the rail symbol in the popup of a position point. The
date of the "since" field is transferred to the "Time course" input field and the course of the day is displayed.
Figure 19 Display of timeline 23 - 38

3.3 Graphs
This view allows the display of various pointer parameters such as energy reserve, speed, GSM signal, etc. as a
line diagram over a time range that can be entered. For example, the temperature reported by pointers can be
displayed. The data in this view is not updated automatically.
By clicking on a data point and holding the CTRL key the pointer belonging to the series is opened in the pointer
overview. When holding CTRL+SHIFT while clicking on a data point the details view is opened with the current
date range as selected in the graph and when holding the ALT key while clicking on a data point the pointer
belonging to the series is opened in another graph.
Figure 20 Temperature as graph over time
3.3.1.1 Actions and displays

Parameter selection Parameter selection This selection list contains the parameters that
can be displayed as line diagrams.
Start Defines the start of the query period. An input has the effect that
only vehicles whose date since is equal to or greater than the value
entered are displayed. This field is only available in the detail view.
End Defines the end of the query period. An input has the effect that
only vehicles whose date since is equal to or smaller than the value
Update Updates the displayed graphs.
Add Graph Opens another graph to be able to display different parameters at

the same time.
Close graphs Closes all graphs but the one currently selected.
Average line for all The average line is shown or hidden, depending on the current
graphs display on the selected graph, on all graphs.
Median line for all The median line is shown or hidden, depending on the current
Trend line for all graphs The trend line is shown or hidden, depending on the current display
on the selected graph, on all graphs.
24 - 38
Average per day for all Toggles dispaly of average per day and normal view, depending on
graphs the current display on the selected graph.
Displays the number of pointers selected for this graph. By clicking
on this element, a dialog is opened showing the selected pointers in
a list. From this dialog each pointer can be opened in the pointer
overview or in another graph.
Furthermore, various display options can be activated for each graph:

Select graph Selection of the graph for parameter selection. A parameter
selection is applied to the graph selected with this check mark if
more than one graph is selected.
Close graph Deletes this graph from the display
Split graph Splits the graph per pointer so that the curve per pointer is
displayed. Clicking this icon again "closes" the graph again and all
pointer curves will be displayed on top of each other again.
Increases the visibility and comparability of different pointers.
Show / hide points The points on the curves are shown or hidden
Show / hide line The line of the curves is shown or hidden.
Show / hide average The average line for each curve is shown or hidden.
Show / hide median The median line for each curve is shown or hidden.
Show / hide trend line The trend line (method: Least Squares) for each curve is shown or
hidden.
Average curve The curves are combined to form an average curve. The average
value of the selected parameter is displayed per day.
Pointer overview Opens the pointer overview for all pointers chosen for this graph.
Pointer details Opens the pointer details for all pointers chosen for this graph. The
date range for the details is preset to the range currently shown in
the graph.
25 - 38
Figure 21 Temperature as average line over time
26 - 38
Sensors
This view shows the sensors and their pointers and assets.
4.1 Overview
In the overview the sensors as well as the assigned pointer and the assigned asset are displayed.
4.1.1.1 List
The list displays the data of this view in a tabular form. In the header of this list, a filter criterion can be entered
for each column in the input field under the column name. These input fields support regular expressions for
extended filter options. For details on Regular Expressions, please refer to the relevant literature.
Figure 22 Overview of Sensors

Column Selection/ Opens a dialog for selecting the columns to be displayed. To do this,
Columns drag the columns to be displayed into the SHOW area or the columns
not to be displayed into the HIDE area. The width of the column can
also be entered in the SHOW area. The column width can also be
changed directly in the list. To do this, click the mouse in the header
line at the end of the column with the title CLICKED, and then drag the
column border while holding down the mouse button.
27 - 38
delete filters.
Clear filtering/ This button removes all filter criteria applied to the table and displays
clear filters the contents of the table unfiltered.
Row selection/ This button selects all data records currently displayed in the table for
select visible further actions. If all rows are already selected, the selection is
deselected for all rows.
reload
Graphs Opens a view for the graphical representation of various sensor
parameters over a time period that can be entered. A more detailed
description of this view can be found in the "Graphs" section.
4.2 Graphs
This view allows the display of various sensor parameters such as e.g: Sensor temperature as line diagram over
a time range that can be entered. The data in this view are not updated automatically.
By clicking on a data point and holding the CTRL key the pointer of the sensor which belongs to the series is
opened in the pointer overview. When holding the ALT key while clicking on a data point the sensor belonging to
the series is opened in another graph.
Figure 23 Sensor Temperature as line graph over time
28 - 38
4.2.1.1 Actions and displays
Parameter Selection This selection list contains the parameters that can be displayed as
line diagrams.
Start Defines the start of the query period. An input has the effect that
only vehicles whose date since is equal to or greater than the value
End Defines the end of the query period. An input has the effect that
only vehicles whose date since is equal to or smaller than the value
Update Updates the displayed graphs.
Add Graph Opens another graph to be able to display different parameters at

the same time.
Close graphs Closes all graphs but the one currently selected.
Average line for all The average line is shown or hidden, depending on the current
Median line for all The median line is shown or hidden, depending on the current
Trend line for all graphs The trend line is shown or hidden, depending on the current display
on the selected graph, on all graphs.
Average per day for all Toggles dispaly of average per day and normal view, depending on
graphs the current display on the selected graph.
Displays the number of sensors selected for this graph. By clicking
on this element, a dialog is opened showing the selected sensors in
a list. From this dialog each sensor can be opened in the sensor
overview or in another graph.
Furthermore, various display options can be activated for each graph:

Select Graph Selection of the graph for parameter selection. A parameter
selection is applied to the graph selected with this check mark if
more than one graph is selected.
Close graph Deletes this graph from the display
Split graph Splits the graph per pointer so that the curve per pointer is
displayed. Click this icon again to "close" the graph again and all
pointer curves will be displayed on top of each other again.
Increases the visibility and comparability of different pointers.
Show/Hide Points The points on the curves are shown or hidden.
Show / hide line The line of the curves is shown or hidden.
Show/hide average. The average line for each curve is shown or hidden.
Show / hide median The median line for each curve is shown or hidden.
Show / hide trend line The trend line (method: Least Squares) for each curve is shown or
hidden.
Average curve The curves are combined to form an average curve. The average
value of the selected parameter is displayed per day.
29 - 38
Pointer overview Opens the pointer overview for all pointers belonging to the sensors
chosen for this graph.
Pointer details Opens the pointer details for all pointers belonging to the sensors
chosen for this graph. The date range for the details is preset to the
range currently shown in the graph.
30 - 38
Settings
In this view, various general settings as well as groups, depots and geofences can be managed.
By clicking on the individual section names, they can be opened and closed. For this purpose, for example, the
mouse is clicked on the heading of the "General" section. The area is collapsed, and a list of all views is
displayed in the settings. By clicking on a title in this list, the selected area is expanded.
Figure 24 Overview of the Sections in the Settings
5.1 General Information

In this section, the default values for language, map mode and map type can be set. Three parameters can be
selected from a list for each of these values. These settings determine which value is automatically applied to
the parameter, i.e. in which mode the maps are automatically loaded when a view is opened.
In this section also display the authentication code for the X-Rayl Asset Scanner app. With this QR code you
can authenticate in the X-Rayl Asset Scanner app to assign X-Rayl Pointers to Assets. In addition, you can
assign X-Rayl Sensors to X-Rayl Pointers with NFC. The app can be loaded from the App Store and the
GooglePlay store to your mobile device. By pushing the button “New” you can generate a new authentication
code and simultaneously deactivating the current authentication code. This requires the reauthenticate for using
the app afterwards. By pushing the “Delete” button the current authentication code is deleted, and a new code
has to be generated before any assignments can be performed again with the app.
Figure 25 Settings
31 - 38
5.2 Groups
This section is used to manage static vehicle groups. New groups can be created, and existing groups can be
changed or deleted.
These vehicle groups are listed in the selection list "Active filter" in the views for vehicles and pointers.
To create a new group, click on the "New" button. A dialog for entering the name of the group is displayed. The
group is stored in the system by entering the name and CLICKING "Save".
To change the vehicle assignment of a group, select the group in the selection list and move the vehicles to the
"Selected" area to assign them to the group or to the "Not selected" area to remove them from the group.
To delete a group, it is selected in the selection list and then deleted with the "Delete" button.
5.3 Depots
This section is used to manage depot accounts.
Figure 26 Depots Overview

The "New" button CLICKED is used to create a new depot
account. The dialog for entering a depot account opens.
Enter the name of the depot account in the "Name" field
and draw the outline of the depot account on the map.
Press "Save" to save the new depot account in the
system.
To edit a depot account, press the "Edit" button. The
same dialog is opened as for the creation of a new depot.
The name and outline of the depot account can be
changed.
To delete a depot account, press the "Delete" button. A
confirmation dialog is displayed and by confirming the
depot is deleted.
5.4 Geofencing
This section is used to manage Geofences. These can
be used to trigger notifications to selected recipients Figure 27 Depot creation dialog
when the Geofences reaches, leaves or passes through.
32 - 38
5.4.1.1 Geofences
The button "New Geofence" must be pressed to create a
new geofence. The dialog for entering a Geofence is
opened. The name of the geofence is entered in the
Name field and the outlines of the geofence are drawn in
the map. Press "Save" to save the new geofence in the
system.
To edit a geofence, press the "Edit" button. The dialog is
opened is the same as for the creation of a geofence.
The name and outline can then be changed.
To delete a Geofence press the button "Delete". A
confirmation dialog is displayed to confirm the deletion in
this dialog. Then the geofence will be deleted.
Figure 28 Geofence creation dialog
Recipients
To create a new recipient, press the "New recipient" button. The dialog
for entering a recipient is opened. The values are entered, and the
recipient is stored in the system by pressing "Save".
To edit a recipient, select the recipient in the selection list and press the
"Edit recipient" button. The dialog is opened in the same way as when
creating a new recipient. The values of the recipient are changed, and
the changes are stored in the system using the "Save" button.
To delete a recipient, the recipient is selected in the selection list and
deleted by pressing the "Delete recipient" button.
A confirmation dialog is displayed and by confirming in this dialog the
Figure 29 Recipient creation dialog recipient is deleted.
Notifications
The "Notifications" button is pressed to set up notifications
for a Geofence.
The notification dialog is opened. In step one, the vehicle
groups or vehicles are selected which are to trigger a
notification or not and these are moved accordingly to the
area "Selected" or to the area "Not selected". Then the
button "Next" is pressed.
Figure 30 Notifications dialog (Step 1)
33 - 38
In the second step, the triggering event and the recipients
for the notification are selected.
With Event, you can choose between reaching Geofence,
leaving Geofence, or driving through Geofence.
The recipients can be specified whether they are to be
notified by SMS or e-mail. Only the configured notification
paths are offered for selection per recipient.
Figure 31 Notification dialog (Step 2)
34 - 38
Administration
In this view different objects can be managed. Assets can be managed, pointers activated, pointers managed,
users managed, notification recipients and notifications managed.
6.1 Asset Administration

Assets can be managed in this section. Assets can
be created, modified and deleted. Furthermore, the
assignment of pointers can be changed. To increase
the clarity, the assets can be filtered by entering them
in the Full Text field or by selecting the Pointer or
Group field. By pressing the "Reset filter" button, the
list is displayed unfiltered.
To create a new asset, press the "New" button. A
dialog opens in which the name of the asset and the
pointer assignment can be entered. Furthermore, the
asset can be assigned to a group.
In the overview list, the current assignment between
a pointer and an asset can be deleted by pressing
the "Remove Pointer" button. A confirmation prompt
is displayed to confirm the deletion.
The "Edit" button is used to manage the data of an
asset in the same dialog as when creating a new
asset.
The asset is deleted by pressing the "Delete" button. Figure 32 Asset creation dialog
A confirmation prompt is displayed before the actual
deletion. In this dialog, the irrevocable deletion of the asset is confirmed by entering the asset name and
pressing the "Delete" button again.
6.2 Pointer Activation

You can activate pointers in this section. This section only contains data if the business process Pointer
Activation is used. To activate a pointer, press the "Activate" button.
6.3 Pointer Administration

In this section, the assignment of an asset to a pointer is deleted or an asset is assigned to the pointer. This
assignment is equivalent to the assignment via the item "Asset Administration". In this view the pointer is
selected as starting point, in the menu item "Asset Administration" an asset is selected as starting point for the
selection. To increase clarity, the assets can be filtered by entering them in the Full text field or by selecting the
Status or Sensors field. By pressing the button "Reset filter" the list is displayed unfiltered.
Pressing the "Remove Pointer" button removes the assignment of the selected pointer to the assigned asset.
Pressing the "Assign Pointer" button displays a list of available assets in the Asset column. The desired asset is
selected, and the desired assignment is saved in the same row by pressing the "Save" button. Pressing the
Cancel button does not create an association and does not save any changes.
6.4 User Administration

In this section, users can be set up or managed. There are two types of users which can be managed in this
section. The first type are normal users who can log on to X-Rayl® DOT-LINK and view information regarding
the assigned assets. The second type are X-Rayl® scanner users who can sign on to the X-Rayl® scanner App
for editing assignments of assets to X-Rayl® pointers, X-Rayl® sensors to X-Rayl® pointers, and
35 - 38
assets to tags. In the users overview you can distinguish the two types of users by the display of an
authentication code (QR code), which only exists for X-Rayl® scanner users.
6.4.1 X-Rayl® DOT-LINK users

To create a new user, press the "New" button. A dialog for entering the user data is displayed. In the Expiration
date field, you can specify the date up to which the user account is to be active. After this date, the user can no
longer log on to the system. After entering all user data, the "Next" button is pressed. In the second section of
the dialog, assets are assigned to the user and this controls which assets this user may see.
To delete a user, press the "Delete" button. A confirmation prompt will be displayed to confirm the deletion.
By pressing the "Deactivate" or "Activate" button, a user account can be deactivated or activated for login. Only
the currently possible button is displayed, depending on the current status of the user account.
With the button "Reset password" a new password can be assigned to the respective user. Pressing the button
displays a dialog for entering and confirming the new password that the user is to receive.
6.4.2 X-Rayl® Scanner users

X-Rayl® scanner users can change the assignment of assets to X-Rayl®
pointers, the assignment of X-Rayl® sensors to X-Rayl® pointers, and the
assignment of assets to tags. In general, the users can perform any of the
above actions only for objects owned by the user who created the X-Rayl®
Scanner user. Please note that X-Rayl® Scanner users have no access to
X-Rayl® DOT-LINK.
To create a new X-Rayl® Scanner user press the button “New X-Rayl
Scanner”. A dialog for entering the user data is displayed. Enter “Display
name” and optionally an expiry date for this user. The display name is also
shown in the X-Rayl® Scanner app and the expiry date may be used to
control up to which date the user may perform any assignments with the
app.
Two privileges may be set for a X-Rayl® Scanner user. The first privilege
“Create assets” may be set to allow the creation of assets during an
assignment in the app. If this privilege is not granted the asset must exist
in the X-Rayl® DOT-LINK database before any assignment can be done.
The second privilege, “Check user”, controls whether assignments can
only be done for objects that belong to the user who created the X-Rayl®
Scanner user. If this privilege is set to “No” the user relationship is not
checked. This allows the X-Rayl® Scanner user to assign assets or X-
Rayl® pointers that do not belong to the user who created the X-Rayl®
Scanner user. If an action for an object of a different user than the creation
user is performed, a warning dialog is shown in the X-Rayl® Scanner
app.The privileges which are set to “Yes” are displayed in the overview
next to the authentication code. The default setting is “No” for “Create
assets” and “Yes” for “Check user”.
By clicking the button “Continue” you get to the recipients for the app user.
You may enter several e-mail addresses. A summary for all assignment
changes between pointer and asset performed with the app will be sent to
the entered recipients in the selected language. By clicking the “+” button
you can create a new row and by clicking the “x” next to the language you
can delete a row. Notifications are sent either once per hour or once per Figure 34 Dialog for editing app
day. users
Existing X-Rayl® Scanner users may be deactivated by pressing the

“Deactivate” button. A deactivated user can no longer perform any
36 - 38
assignment action in the X-Rayl® Scanner app. The user will be prompted to authenticate if any assignment
action is invoked.
A new authentication code is created by pressing the button “Reset auth. code”. This invalidates the existing
authentication code for this user and forces the X-Rayl® Scanner user to reauthenticate with the new code
before any assignment action can be invoked in the X-Rayl® Scanner app.
6.5 Receiver
In this section you can manage recipients for notifications.
To create a new recipient, press the "New" button. A dialog for entering the recipient's data is displayed.
Recipients can receive notifications by e-mail or SMS. Therefore, the input of at least one of these two contact
possibilities is obligatory.
The data of recipients who have already been created can be changed using the "Edit" button. The dialog is
displayed in the same way as when creating a new recipient.
A recipient can be deleted by pressing the "Delete" button. A confirmation prompt is displayed to confirm the
deletion.
6.6 Notifications
• This section allows you to set notifications for events. Events associated with a notification can also be
displayed on the Assets Detail View map.
• To create a new event, press the "New" button. A dialog for entering the configuration of a notification is
displayed.
• - In this dialog the name of the notification is entered first. The "active" indicator controls whether the
notification is active or inactive. Only active notifications are transmitted to the recipients and only
events for active notifications can be displayed in the detailed map for assets.
• - Clicking the "Events" button selects the assets per event for which a notification is to be sent. By
clicking on the "Select" button next to the desired event, the assets or groups can now be selected.
• - After selecting the assets, click on the "Recipients" button to select the recipients for this configuration.
For each recipient you can choose between notification by SMS or by e-mail by marking the desired
option at the recipient's end. However, only the contact options entered are available for each recipient.
If necessary, additional contact addresses can be entered for the recipient (see "Recipient" section).
• - Click the "Save" button to save the notification configuration. The entry can be checked again by
pressing the "Definition", "Events" and "Recipient" buttons.
Figure 35 Dialogs for setting up a notification configuration
Once a notification configuration has been created, it is displayed in the list. The list shows the number of
selected assets under Assets and the number of selected recipients for notification under Recipients.
37 - 38
Recipients will now receive an SMS or e-mail whenever the selected events are detected on the selected
assets. For example, when the assigned assets are detected, a message is always sent to the registered
recipients via the selected communication channels.
Language
The language setting can be selected here. German and English are available.
38 - 38

X-Rayl DOT Link Administratorhandbuch V2.12.en DOC001062018

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

X-Rayl DOT Link Administratorhandbuch V2.12.en DOC001062018

Uploaded by

Copyright:

Available Formats

®

X-Rayl DOT Link

1.1 Target Group

1.2 From Pointer to Asset

Figure 1 Aggregation of asset view

1.3 Terms and Definitions

1.3.6 Automatic Start/Stop Function

1.3.8 Time Base

1.3.9 Entry timestamp

1.3.10 Last SMS

1.4 Customer Login

Assets - Pointers - Sensors - Settings - Administration - Language

Figure 3 Main view

1.6 General Operating Instructions

Figure 5 Map mode selection

A detailed explanation can be found in the chapter "Assets".

1.6.1.1 Symbols for displaying the current position

1.6.2 Notes on Symbols

Figure 6 Display of tooltips

1.6.3 Screen layout

2.1 Overview Actions

Figure 7 View components

Actions and Displays

Figure 8 Assets overview map

2.1.1.3 Map Mode

Figure 10 Dialog for creating reports

2.1.1.5 Asset pointer associations view

2.1.1.6 Asset tag associations view

Figure 11 Asset details

2.2.1 Display components

Actions and displays

Figure 12 Route statistics

Figure 13 Representation of a time line

3.1.1 Display Components

Actions and Displays

Assets Opens the overview of assets assigned to the selected pointers.

Figure 14 Overview Map for Pointers

Figure 15 Map modes

Figure 16 Statistic area in the pointer overview

Figure 17 List view of pie chart

3.2.1 Display Components

Actions and displays

Figure 18 Display of the parameter Speed (SPD) on the map

Figure 19 Display of timeline 23 - 38

Figure 20 Temperature as graph over time

3.3.1.1 Actions and displays

Add Graph Opens another graph to be able to display different parameters at

Furthermore, various display options can be activated for each graph:

4.1.1 Display Components

Figure 22 Overview of Sensors

Actions and displays

Figure 23 Sensor Temperature as line graph over time

Add Graph Opens another graph to be able to display different parameters at

Furthermore, various display options can be activated for each graph:

Show / hide line The line of the curves is shown or hidden.

Figure 24 Overview of the Sections in the Settings

5.1 General Information

Figure 26 Depots Overview

Figure 28 Geofence creation dialog

Figure 30 Notifications dialog (Step 1)

Figure 31 Notification dialog (Step 2)

6.1 Asset Administration

6.2 Pointer Activation

6.3 Pointer Administration