Setting Up A Device

Overview

This document outlines the setup of new phones for use with the jDispatch module.

Setting Up Drivers

The first thing that is required is to set up drivers in your integrated ERP. These steps will vary by system, so please confirm with your IT team how to set up drivers for use with JDispatch.

Activiating Your Device

If this is a new android phone, you will also need to complete the initial setup of the phone so that you may download the JDispatch app. These steps may vary, but generally you just need to turn on the phone and follow the initial prompts to set up date, time, language, etc. When you reach the point of entering in an email address, you will need to enter in a valid Gmail email address. If you do not have one, you can set one up at gmail.com. Once it is set up, this email can be used on any number of devices. 

There may be one or two more prompts aftwerwards, but you should end up at the basic android home screen.

Install JDispatch

• Click on the android play store icon
  

  

• In the top search bar, type in jdispatch. You may get back a number of results. Please make sure that you install jdispatch from AMS
  

  

• Tap the listing, and tap the install button. If asked, accept permissions.
  

  

• Once the app is installed, tap the options button in the top right. Ensure that auto-update is checked.
  

  

Sign In To JDispatch Dashboard

• Open an internet browser and go to the following URL:

https://www.jdispatch.ca/dashboard.php

• Log in with the your jdispatch admin credentials
• Click the Register Phones button on the left menu bar.
  
• Once in the register devices screen, you should see a QR code underneath the device listing

Open JDispatch and Allow Location Permissions

When you first open the app, it should ask a number of questions about permissions. These permissions must be allowed in order for JDispatch to properly report driver and delivery location

If you deny any of these permissions, the driver's location may not be reported to the JDispatch server and the driver location map may not work correctly or at all.

JDispatch requires location services to always be active, so you may receive a number of messages about allowing permissions

• Allowing JDispatch to access this device's location? This allows JDispatch to report the device location so that it can be reported in the JDispatch dashboard under the 'Driver Location' section
  

  

• Allow JDispatch to access your physical activity? This allows JDispatch to register the speed that the device is travelling at so that it can properly move about in the driver location map.
  

  

  
  
  
• Change location access for JDispatch? This will take you to a screen where you can allow JDispatch to report the device location all the time
  

  

• Allow all the time. This ensures that the dashboard can know the location of the device even when JDispatch is not open.
  

  

Register The Device

Once you have allowed all driver permissions, youshould have a message warning you that the phone is not registered.

• Tap OK.
  
  

  

• You should now see a red Register Device button. Tap this button. The first time you do this, the app may ask for additional permissions. You should allow JDispatch to take pictures while using the app.

  

  
  
  

• You will also be asked to allow the app to modify system settings. This enables the app to take pictures as well. Toggle the switch to allow this, and then tap the back arrow in the top left.
  

  

   

• Tap the Register Device Your camera should initialize.
• With the camera initialized, focus on the QR code on the screen you opened up the JDispatch dashboard.
• You should be presented with a message saying that you successfully registered your phone, and the 'Register Phone' button should be replaced with a 'Refresh Info' button.
• You will also notice a new entry in your jDispatch dashboard under Registered Devices.

Assign a Driver to The Phone

• In the jDispatch dashboard that was opened up previously, you should see a listing of all your drivers that you have set up in in your ERP under Driver/Device Assignment.
• Click on the blue Unit button for the newly set up device and drag it over to the driver who will be using this device. Next to the driver’s name, a checkbox icon should appear. This means the assignment was successful.
  

  

• Now, back on the phone, tap the red Refresh Info button. You should see the driver’s name, and a unit number along the top. This confirms the proper assignment on the phone as well as the dashboard.