This is an old revision of the document!
Motor Clubs
Create the account
Navigate to the Auto club list screen
This will display the list of all configured auto club accounts for the company, as shown below.
Click the Add auto club button to create the new entry
This will result in a new entry in the list with Id=-1, as shown below.
Select the desired auto club
Click on the cell under the Auto club column, and a drop down list will appear. Click on the arrow to see the list, as shown below. Select the desired auto club.
Enter the contractor or vendor ID
Tab to the contractor/vendor ID cell, or click on it, to invoke edit mode. Enter the contractor ID as shown below. Tab to the next cell to leave the cell, which will invoke the save process.
After you enter the contractor ID and leave the cell, the system will save this minimum information and possibly sort the new account into the list of other entries.
Notice that after the new account is saved, the ID will no longer be -1.
Enter username
Select the username cell on the desired account row, which should invoke edit mode.
Enter the username, and tab to the password field.
Note: this step is not necessary for Cross Country setup.
Enter the password
Cross Country-specific configuration
Obtain client ID
Register locations
Manage the connection
For Tracker customers, Ranger automatically attempts to log on to auto club accounts whenever RangerService is started. However, there are situations in which the company must manage auto club connections outside the RangerService startup process. For example, DriveAmerica will forcibly log off a service provider that fails to respond to a dispatch in a timely manner.
For RangerDispatch customers, when the dispatch screen is used to logon the dispatcher, the auto club logon process will happen automatically.
List all connections and their statuses
Shown below is an example of a company with multiple configured accounts, with only one logged in.
A logged-in connection will have a session ID, and in the case of Cross Country, will also have a session token. It will also provide a Logout button for manual logout.
Likewise, a logged-out connection will provide a Login button for manual login.
Logout a connection
Click the Logout button on the desired account row, and the system will communicate with the auto club and logout the connection.
The service provider will no longer receive dispatches from the auto club until login is performed.
The screen should be updated to reflect the new status. The logged-out connection will now have a Login button, and the session ID will be blank, as shown below.
Login a connection
Click the Login button on the desired account row, and the system will communicate with the auto club and login the connection.
The service provider will be expected to respond in a timely manner to dispatches from the auto club until logout is performed.
The screen should be updated to reflect the new status. The logged-in connection will now have a Logout button, and the session ID will be updated, as shown below.
Note: If DriveAmerica has forcibly logged the service provider off, the service provider may be required to contact DriveAmerica via phone before account logon will be allowed
Login fails
If, after clicking the Login button, an Error dialog box is displayed as shown below, login has failed.
If the error is “Root element is missing” and the auto club is USAC, it is likely that DriveAmerica does not have the configured contractor ID in their system. The service provider will likely need to contact DriveAmerica to resolve the issue.