1. Digital Fleet Dispatch Integration
5/22/2017

2. Digital Fleet Dispatch Integration
Digital Fleet Bridge Service is used to communicate with the Dispatch System
Uses MSMQ to accomplish the communication
Two queues
From Dispatch (Integra)
Messages placed here by the dispatch service (i.e. Unisignal) and picked up by DF Bridge Service
Name of queue varies based on dispatch system
To Dispatch (Integra)
Messages placed here by DF Bridge Service and picked up by the dispatch service
Requires correct client key, queue names, and endpoint address

3. Digital Fleet Dispatch Integration
Everything placed in “From Dispatch” queue is retrieved by DF Bridge Service and sent to endpoint address regardless of content.
The endpoint address is an “integration” project for different dispatch systems
Must match expected format otherwise ignored at this point
Client key is used for delivery of ticket/message to tablet and web application
References client truck table for match with provided truck ID
No match – no delivery of ticket/message

4. Digital Fleet Bridge Service
Windows service that runs on the same server as Unisignal.
Config file contains client specific info for queue placement and retrieval.
Set to automatically startup to reduce likelihood service isn’t running after reboot.

5. MSMQ Queues Queues are used to pass info from/to Unisignal
Integra sets up queues for use
Located under Computer Management
Message Queuing › Private Queues
Todispatch queue
Digital Fleet to Integra
Fromdispatch queue
Integra to Digital Fleet

6. Queue Messages Queue messages should normally be empty or a low value.
The DF Bridge Service picks up information approximately every 5 seconds.
If “From Dispatch” queue is filling up, it’s an indication the DF Bridge Service has stopped working.
If “To Dispatch” queue is filling up, it’s an indication the dispatch service (i.e. Unisignal) may have stopped working.

7. MSMQ Queue Journaling
If journaling is enabled, eventually all of the queue resources will be used and no information will be passed to/from Digital Fleet.
If all tickets/messages fail on delivery or receipt, check if Unisignal is running and/or if Journaling is enabled for each queue.
To check if journaling is enabled, right click the queue and select Properties.

8. MSMQ Queue Journaling
Stores all messages in the Journal messages folder.
The Journal messages contain all information for the queue message.
Journaling should only be used for troubleshooting and only enabled for short amounts of time.

9. Integra Unisignal
Integra Windows Service to communicate with the signaling vendor (Digital Fleet).
Reads and writes to MSMQ
Indication Unisignal isn’t working properly:
No tickets or messages are going to or from the Digital Fleet platform.
Generally caused by rebooting of the Integra database server without restarting of the Unisignal service.