Documents in the Dashboard

To create or view Document types as an administrator in your Samsara Cloud Dashboard, navigate to Documents.

Creating a New Document Type

There are two ways to create a new document type in the dashboard.

1. Click Create document type > Create Custom Document Type - this starts the process with a blank form.

2. Click Create document type > Create from a standard document type - this allows you to work off of six standard document types as a template.

3. Name the Document Type.

4. Click Add Field to determine what types of information can be submitted in this document type:

• Number field: this field type will prompt the driver to enter a numerical value with an allowance of decimal places you choose.
• Text field: this field type will prompt the driver to write any text here.
• Photo field: this field will prompt the driver to take a photo or upload a photo from their device's gallery.
• Multiple choice field: this field will prompt the driver to select one of the multiple options you create here.
  • Conditional field this field will prompt drivers to answer specific follow up questions based on multiple choice answers. 
  • 
• Signature field: this field will prompt the driver to type their name and draw an eSignature with their finger in the app. Rotating the device to landscape mode will enable a wider field for capturing a signature.
• Date/time field: this field will prompt the driver to input a date and time.
• Document Scan field: this field will prompt the driver to take a photo of a document with a visual frame to help guide the user to best take the photo. 
• Barcode Scan field: this field will prompt the driver to scan a barcode.   
  • Supported barcode types:
    • aztec
    • code128
    • code39
    • code39mod43
    • code93
    • ean13 (iOS converts upca barcodes to ean13 by adding a leading 0)
    • ean8
    • pdf417
    • qr
    • upce
    • interleaved2of5 (when available)
    • itf14 (when available)
    • datamatrix (when available)

5. Name each field.

6. Mark each field as required or not required.

7. Drag and drop fields to rearrange the order of the document type.

8. Save.

Editing or Deleting Document Types

Documents can be deleted or edited later under the Document Types tab. Note: this will not impact any previously submitted documents and will only change the form presented to your drivers in the future. 

Using Document Types in the Driver App

On the Driver App, navigate to Documents > Create new document.  The document types that have been created in the dashboard will be available here.

A red asterisk will delineate the fields that are required. All required fields must be entered in the Driver App in order to save a document submission.

Click here for a complete driver's guide. 

Viewing Submitted Documents

• You can filter documents by date using the date picker in the upper right-hand corner of the dashboard, document type, or the Tags dropdown filter. All three filters can be used in conjunction together. 
• Only documents submitted by drivers from the selected driver tag(s) will display when the Tags filter is applied
• Only documents received within the selected date range will display when using the date picker in the upper right-hand corner of the dashboard
• Only documents of the selected document type will display when the Document Type filter is applied.

Click on a submission to view it in detail.

Editing, Archiving & Deleting Submitted Documents 

 

Download to a CSV file

• Use the More Actions > Download CSV in the Documents Report.
• You can only export data for a single document type at a time since field data may be different for different document types
• The max date range that you can export documents for is 3 months
• If there is a document type that has multiple versions in the date range selected, then you will have to select one of those document type versions to download
• If the Download button is disabled, take a look at the error message you are receiving to identify why you are not able to Download the CSV for the document type you have selected

Data Format of the CSV:

• Time Submitted - the time the document was submitted
• Driver - Name of the driver who submitted the document
• Vehicle - Name of the vehicle that the driver was signed into when the driver submitted the document
• Fields - each column will represent each field that is defined in the document type you are exporting
  • Image field - number of images submitted as a part of that field
  • Text field - the text value submitted for that field
  • Number field - the number value submitted for that field
  • Multiple Choice field - the choice selected for the field
• Notes
• URL - this is a URL link to the document in the dashboard
• Stop - this is name of the Route Stop the document was submitted against if the document was submitted from the Routes tile in the Driver App. N/A if the document wasn't submitted against a Stop
• Tags - these are the tags the driver is part of. N/A if they aren't part of a tag