Changes

1,949 bytes added ,  15:14, 24 July 2023
no edit summary
Line 2: Line 2:       −
This chapter is an overview of '''FILES''' menu.<br />
+
FOTA WEB supports various tasks that require files to be used (Update configuration, update firmware, upload TLS certificate...). The files section on FOTA WEB is used to manage all your files for easy and quick use with the task system.
 +
 
 +
[[File:FOTAFILES1.png]]
 +
 
    
=='''Files section'''==
 
=='''Files section'''==
   −
This section displays files that have been uploaded to FOTA by a user. Two possible file types: Firmware and Configuration.
+
This section displays files that have been uploaded to FOTA WEB by a user. There are three possible file types: Firmware, Configuration and Certificate.
    
{| class="wikitable" style="width: 100%;"
 
{| class="wikitable" style="width: 100%;"
Line 14: Line 17:  
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''DESCRIPTION'''
 
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''DESCRIPTION'''
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''DESCRIPTION''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''ID'''
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: description; default: N/A<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: ID
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Shows the ID number of the uploaded file.
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''DESCRIPTION'''  
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: description; default: N/A
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Description shows user-defined explanation for this file. <br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Description shows user-defined explanation for this file. <br />
 
In case of configuration download from the device – it shows “From device”.<br />
 
In case of configuration download from the device – it shows “From device”.<br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''FILE''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''NAME'''  
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: file name <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: file name  
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Exact filename of uploaded file.<br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Exact filename of uploaded file.<br />
 
In case of configuration download '''from''' device – it includes IMEI + Unix timestamp.<br />
 
In case of configuration download '''from''' device – it includes IMEI + Unix timestamp.<br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''TYPE''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''FILE TYPE'''  
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Firmware | configuration <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |  
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Shows whether file is firmware or configuration.<br />
+
* Firmware  
 +
* Configuration
 +
* Certificate<br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Shows whether the file is firmware, configuration, or certificate.<br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''COMPANY''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''COMPANY'''  
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: Company name <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: Company name  
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Shows to which company this file is assigned.<br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Shows to which company this file is assigned.<br />
 
If a file is assigned to a '''child''' level company – then only that particular company and its root level company can utilize this file.<br />
 
If a file is assigned to a '''child''' level company – then only that particular company and its root level company can utilize this file.<br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''CREATED AT''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''CREATED AT'''  
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: date and time<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: date and time
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | It shows when the file was uploaded to the FOTA. Date/Time is adjusted by the browser according to the time of local PC.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | It shows when the file was uploaded to the FOTA WEB. Date/Time is adjusted by the browser according to the time of local PC.<br />
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''SIZE'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String: size
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Shows the uploaded file's size.
 
|}
 
|}
   −
=='''Actions'''==
+
=='''Upload'''==
   −
'''ACTIONS''' button allows to add a new file or remove (delete) already uploaded ones.
+
'''Upload''' menu allows to select a '''Company''' and assign Firmware, Configuration, or Certificate files to it.
   −
{| class="wikitable" style="width: 100%;"
+
[[File:FOTAFILES4.png|frameless|]]
|+
+
 
! style="width: 20%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''FIELD NAME'''
+
{| style="width: 100%;"
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''ACTIONS'''
+
! style="width: 20%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |'''FIELD NAME'''
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''DESCRIPTION'''
+
! style="width: 80%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |'''DESCRIPTION'''
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''File type'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Allows user to select, if the file being uploaded is Firmware, Configuration, or Certificate.<br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Add new file''' <br />
+
|style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;"|'''Company'''
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Firmware | Configuration <br />
+
|style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;"|Select which company the uploaded file will be assigned to.
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Add new file''' menu allows to select a '''Company''' and assign Firmware and Configuration files to it.<br />
  −
It is possible to upload multiple Firmware files and Multiple configurations at the same time.<br />
   
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Remove''' <br />
+
|style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;"|'''Description'''
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | - <br />
+
|style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;"|Ability to add a user-defined description about the file being uploaded.  
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Removes selected file(s) from FOTA WEB.  
+
In case it is left empty, it will show the import date.
Once file is removed it shall not appear in '''Devices -> Actions -> Create task -> Update configuration''' options.
+
 
 +
'''NOTE''':  Non-mandatory field.
 
|}
 
|}
 +
== '''Delete''' ==
 +
'''Delete''' menu allows the user to delete selected files from the FOTA WEB. The files that should be deleted can be selected by just adding a checkmark next to them, filtering them,
 +
 +
or listing the ID's of the files in a .csv file.
 +
 +
'''NOTE:''' Scenario files can '''not''' be deleted from the FOTA WEB files menu.
 +
 +
[[File:FOTAFILES3.png|frameless]]
   −
'''NOTE:''' configuration files that were downloaded via '''Devices -> Actions -> Create task -> Receive configuration''' shall appear in '''FILES''' tab.
+
'''NOTE:''' configuration files that were downloaded via '''Devices -> Create task -> Receive configuration''' shall appear in '''FILES''' tab.
    
Configuration files can be '''downloaded''' to your PC from '''FILES''' menu. Configuration files can be opened only with the FM configurator.
 
Configuration files can be '''downloaded''' to your PC from '''FILES''' menu. Configuration files can be opened only with the FM configurator.
    +
== '''Download''' ==
 +
While viewing the Files section you are able to download any of the already uploaded files for usage within your system.
 +
 +
To download you should locate your file from the list and click on the <b> Download Button </b> [[image:FOTAFILES6.png]]
 +
 +
== '''Edit''' ==
 +
'''Edit''' menu allows the user to edit the information of a selected file from the list on FOTA WEB.
 +
 +
[[File:FOTAFILES5.png|frameless]]
 +
 +
The editable fields are ''Company'' that the file is under and ''Description''.
 +
 +
 +
{|style="width:100%;"
 +
|-
 +
|[https://wiki.teltonika-gps.com/view/Device_Groups '''Device Groups'''] - Previous page
 +
|style="text-align:right;| Next page - [https://wiki.teltonika-gps.com/view/FOTA_WEB_Companies '''Companies''']
 +
|}
   −
Next chapter [[Company and User role structure|'''Company and User role structure''']]
     −
[[Category:FOTA]]
+
[[Category:FOTA WEB]]