Wiki source code of Fahrzeug-Positionen

Last modified by YellowFox_RD on 2025/01/16 12:51

version	line-number	content
1.1	1	(% class="box" %)
4.1	2	(((Table of Contents)))
1.1	3	{{toc/}}
	4
4.1	5	On this page you will get an overview of the position messages of an object.
	6
2.1	7
4.1	8	= Vehicle- & group selection =
2.1	9
1.1	10	(((
4.1	11	* Select the car/group from the select box or
	12	* insert a search string into input field of opened selection box for searching cars and/or groups.
1.1	13	)))
4.1	14	= Position list =
	15	In the positions list you will receive information about the location of a selected single vehicle or the last information about the vehicles of a selected group
	16	== Vehicle position list ==
	17	The shown messages are grouped by date. Newest messages will be on top.
	18	Each position record contains the following information:
1.1	19	(((
4.1	20	* date, time, weekday,
	21	* message reason,
	22	* position as text
	23	* driver (column is only visible if a driver is defined)
	24	* mileage (column is only visible if the box supports it)
	25	* position message depending actions
1.1	26	)))
4.1	27	If the position message is marked with an asterisk, this means that the gps-signal at the moment of locating was not good enough to get a precise position.
	28	== Group positition list ==
	29	The group position list is always shown if a group is selected. It shows the current last position message of each vehicle that is a part of the group.
	30	Each displayed position record contains the basic Information as the vehicle position list, although that optional columns are not visible.
	31	== Display time range ==
	32	The max. shown time range of position messages starts with the current date time and reaches a maximum of 2 months in the past. The time range can not be changed.
	33	== Main Actions ==
	34	If vehicle depending position messages are shown, different global actions are available.
	35	They are shown at the right top, above the position list table.
1.1	36	[[image:image2016-5-10%2011%3A42%3A27.png]]
4.1	37	By clicking on the arrow of the dropdown box, a menu will be shown/hidden that contains different actions.
	38	\|[[image:image2016-5-10%2013%3A3%3A12.png]]\|General Actions
	39	(((\|=[[image:image2016-5-10%2013%3A9%3A3.png]]\|Reload Position list\|Triggers a reload of the complete position list for current selection.\|=[[image:image2016-5-10%2013%3A18%3A45.png]]\|One time positioning\|Initiates an onetime location of this vehicle.
1.1	40	)))
4.1	41	\|[[image:image2016-5-10%2013%3A5%3A50.png]]\|Change/Switch Actions
	42	(((\|=[[image:image2016-5-10%2013%3A15%3A59.png]]\|LiveTracker\|Show the current vehicle LiveTracker as a pop-up.\|=[[image:image2016-5-10%2013%3A16%3A18.png]]\|Vehicle settings\|Switches to vehicle settings of current vehicle\|=[[image:image2016-5-10%2013%3A16%3A39.png]]\|Research assistant\|Switches to research assistant with pre-selection of current vehicle.
1.1	43	)))
4.1	44	\|[[image:image2016-5-10%2013%3A6%3A54.png]]\|Filter & column configuration
	45	(((\|=\|show search\|Here you can set extended search criteria. (see below)\|=[[image:image2016-5-10%2013%3A31%3A9.png]]\|Edit filters\|Opens the dialog for filter configuration. Here you can select the types of the messages that should be displayed by position list.\|=[[image:image2016-5-10%2013%3A31%3A49.png]]\|__Column visibility__\|Opens the dialog for column visibility configuration. Here you can configure the optional position list columns that should be displayed:
	46	• __Telemetry without name__: Shows only the telemetry symbols.
	47	• __Telemetry with name__: Shows the telemetry symbols with associated input names.
	48	• __Battery status__: Shows the battery status (in percent) if available for the box.
	49	• __Operating hours counter 1__
	50	• __Operating hours counter 2__
	51	• __Ground speed__\|=\|Show ??? elements\|Here you can select, how many position messages should be shown at a single page. If the browser session has expired
	52	the predefined value "number of items in position list" from Administration > Portal Settings > Settings is used.
1.1	53	)))
	54
4.1	55	== Message depending actions ==
	56	Each position message has the following associated actions:
	57	\|=[[image:image2016-5-11%208%3A26%3A47.png]]\|Show position at map\|Shows the location of current position message at map if it has a valid useable GPS signal and is not a private drive.
	58	\|=[[image:image2016-5-11%208%3A27%3A6.png]]\|Show details\|Shows details of the position message. [[See here>>doc:/plugins/com.k15t.scroll.platform/viewOriginalLanguageSource.action?pageId=557115\|\|anchor="Fahrzeug-Positionen-Details"]]
	59	\|=[[image:image2016-5-11%208%3A27%3A31.png]]\|Edit/create address\|Create a new address from position message, or edit the address if the location already points to a known address.
	60	This functionality is only available if you currently have the rights to edit/create an address. Furthermore the position
	61	message must define a valid known location (GPS Signal) and be not part of a private drive.
	62	\|=[[image:image2016-5-11%208%3A29%3A14.png]]\|Comment/remark editor\|Each position message can declare a comment or remark text. This text is also used by logbook as driving purpose.
	63	\|=[[image:image2016-5-11%208%3A30%3A7.png]]\|Fuel data editor\|Each "IGNITION OFF" position message can define a refuel action. You must declare the amount of fueled liters
	64	and the payed money. A tankstop can contain information about fuel and/or AdBlue. Optional a fuel card can be defined. The available fuel cards can be defined
	65	by Administration > Display > Fuel cards
2.1	66
4.1	67	In addition the position is also displayed at map if you click on the position text.
1.1	68	== Details ==
4.1	69	The detailed view shows you all available position message informations. They are separated into different main areas, displayed by tabulators:
	70	The following main areas can be shown:
	71	=== General ===
	72	All general data without an specific other meaning:
1.1	73	(((
4.1	74	* Message date
	75	* Mileage
	76	* Speed/velocity
	77	* Telemetry Inputs
	78	* GPS quality
	79	* GPS position
	80	* Processing date
	81	* Messages
	82	* Orders
	83	* Tours
1.1	84	)))
4.1	85	=== Messages, Orders and Tours ===
	86	For messages, orders and tours, you can furthermore access the corresponding linked messages, orders and tours.
1.1	87	=== FMS/CAN ===
4.1	88	All data depending to an FMS/CAN message. This area is only shown, if the message contains the required data.
	89	The following information are available:
1.1	90	(((
4.1	91	* cruise control on/off
	92	* PTO on/off
	93	* engine speed
	94	* Speed
	95	* number of clutch entered
	96	* number of break entered
	97	* overspeed warning
	98	* accelerator position
	99	* axle load
	100	* fuel level in %
	101	* cooling water temperature
	102	* total fuel used
1.1	103	)))
4.1	104	The single parts are only shown if the object/vehicle sends the required info.
	105	=== Temperature data ===
	106	If an box sends anlog or EuroScan/Thermoking data, they are displayed inside this tab.
	107	=== Fuel data editor ===
	108	Here you can declare Information about refueling, depending to the specific position message.
	109	Each "IGNITION OFF" signal message can contain this optional fuel info. You have to declare the fuel liters, the fuel price and optionally
	110	an used fuel card. A tankstop can contain information about fuel and/or AdBlue. Fuel cards can be declared via Administration > Display > Fuel Cards.
	111	=== Remark/comment text editor ===
	112	You can define a comment or remark text for each position message. This is used as drive reason, for example by logbook.
	113	=== Positioning ===
	114	Here all information about locating are shown:
1.1	115	(((
4.1	116	* Time interval on/off
	117	* Distance interval on/off
	118	* Course change on/off
	119	* overspeed warning on/off
	120	* idle on/off
1.1	121	)))
4.1	122	=== Digitacho data ===
	123	If the position message is a digitacho message these information are shown:
1.1	124	(((
4.1	125	* Position message date
	126	* digitacho message date
	127	* the associated driver (driver 1 or driver 2)
	128	* Driver key
1.1	129	)))
4.1	130	=== Raw data ===
	131	The raw data view shows only the raw position message data string.
2.1	132
4.1	133	== Position list filter ==
	134	With the filters you can define the types of data, that should be displayed inside the position list.
	135	The following filters are available:
1.1	136	(((
4.1	137	* Telemetry messages
	138	* Status messages
	139	* Configuration messages
	140	* FMS/CAN messages
	141	* digitacho message
	142	* area messages
	143	* all other messages
1.1	144	)))
4.1	145	All filters can be combined freely, but at least one filter must be selected.
2.1	146
4.1	147	== Extended search criteria ==
	148	You have the possibility to extend your search by further, optional parameters. Click on show search to do so.
	149	=== Time range ===
	150	By default you will see the messages of the last 2 months. You can adjust your selection by using fast selection or setting a start and end date manually. These have to be within the last 2 years and shall not be more than 2 months apart.
	151	=== Address ===
	152	By using address search you can search within a given radius of an adress. Set your desired coordinates first. You can do this by using the map view or address book. To enter an address manually, you need to open the map view as well. Here you can use the search field. Click on set to apply your selected address to the map. Afterwards you can go back to position search by clicking on use selected position. To choose an address from address book just click on the desired row.
	153	Via search radius you can set within which area you want to search. It can be between 50 and 5000 m and needs to be set in 50 steps. You can edit it by using slider, the input field or adjusting it directly in map view. If you do not set an address, it will not affect your search.
	154	You can change the address as often as you want. To delete the address filter from your search, click on the red cross on the right side.
	155	Please note that private drives might be hidden while using address filter depending on your company settings.
1.1	156