1. How To Integrate Your Applications Into TMT Fleet Maintenance via Web Services
Ben Davis AM Integrations Team Lead

2. Introduction to TMT Fleet Maintenance Web Services

3. Introduction Integration Toolkit – the AMS API
A collection of methods for accessing AMS data
Grouped by category
Currently using SOAP (more info:
Can be tested using free applications such as SOAPUI (
Has test page built-in to AMS Enterprise
Works with SSL
May require licensing from TMW
Runs under IIS

4. Configuration
Typically the Integration Toolkit is configured by someone from the TMW Implementation team.
The Integration ToolKit is automatically installed with the AMS Enterprise installation.
The IIS service that hosts AMS Enterprise also hosts the ToolKit
The URL to the ToolKit is based off of the URL to AMS Enterprise.
becomes

5. Connecting Connecting to the ToolKit
You’ll need a URL to the IIS service that hosts the ToolKit
Create a new Service Reference in Visual Studio

6. Connecting
Connecting to the ToolKit
Click the Advanced… button

7. Connecting Connecting to the ToolKit
Click the Add Web Reference… button

8. Connecting Connecting to the ToolKit
Enter the URL and click the Go button.
When the service is loaded, give it a name and click Add Reference.
Sample code has “ToolKitWS” as the reference name.

9. Connecting
Visual Studio will create a “Web References” folder and add the new reference.

10. Connecting
The new web reference can be called from the project code.

11. Method Categories The following categories are available:
Accounting – methods to work with GL, AP, AR transactions.
Customer – methods to add, retrieve or update customer data.
Employee – methods to add, retrieve or update employee data.
Fuel – method to create fuel tickets.
Order – methods to retrieve or add orders.
Purchase Orders – methods to work with purchase orders.
Repair Orders – methods to work with repair orders.
Shop – methods to get shop information or add shop inventory.

12. Method Categories Categories, continued:
Unit – methods for working with units, unit meters, PMs, unit repairs, locations and VINs.
Vendor – methods for creating and retrieving vendor data.

13. Usage Notes Methods usually follow a Get/Set naming convention
Get methods typically retrieve data from the database
Set methods typically apply data to the database
Datatypes
DateTime– MMDD, MMDDYY or MMDDYYY, HHMMSSmm. Time can be 12- or 24-hour clock.
Numeric– valid signed real number. Optional sign or decimal point.
Varchar– Alphanumeric characters.
Y/N– Bit value represented as string “Y” = “Yes” or “True”, “N” = “No” or “False”.

14. Usage Notes Error objects
All objects returned from the toolkit include one or more Error objects.
No rigid format for how errors are returned.
Error Codes are not guaranteed consistent from method to method.
Checking for a non-empty Message or non-zero Code is reliable.

15. Usage Examples
PMDueListingResMessage GetPMDue(GetPMDueParamMessage message)
(Optional) UnitId = 34
(Optional) UnitNumber=“18542”
(Optional) CustomerName=“”
(Optional) shop=“”
GetPMDue will return a listing of PM information for the given parameters.

16. Usage Examples
PMDueListingResMessage GetPMDue(GetPMDueParamMessage message)
(Optional) UnitId = 34
(Optional) UnitNumber=“18542”
(Optional) CustomerName=“”
(Optional) shop=“”
GetPMDue will return a listing of PM information for the given parameters.

17. Usage Examples
ShopListingResMessage GetShopDetails(ShopParamMessage message)
(Optional) ShopId = “01”
(Optional) ShopType=“MAIN SHOP”
GetShopDetails will return a listing of shop information for the given parameters.

18. Safe Harbor Notice
The information presented is for informational purposes only and should not be relied upon in making a purchasing decision. Trimble is under no legal obligation to deliver any future products, features or functions within any specified time frame, if at all. Release dates and content are subject to change at Trimble’s sole discretion.

19. Visit the TransForum Technology Hub
Questions?
Please use your TransForum mobile app to rate this session. Help us improve our content.
Visit the TransForum Technology Hub
Where: ?
The TMW Resource Center is the hands-on laboratory where software experts provide you with personalized assistance for any TMW application.
Staffed: Sunday – 6 PM to 9:00 PM Monday – 7 AM to 6:30 PM Tuesday – 7 AM to 6:00 PM Wednesday – 7 AM to 11:00 AM
The TMW Systems booth offers personal demonstrations on any TMW software product.
TransForum Sponsors & Exhibitors will share the latest technologies, products, and service offerings with you and answer TMW compatibility questions.

20. Ben Davis AM Integrations Team Lead, TMW Systems
T H A N K Y O U
Ben Davis AM Integrations Team Lead, TMW Systems
p: e:
M O V I N G Y O U F O R W A R D
T H A N K Y O U

21. © 2014 by TMW Systems Inc. All rights reserved.
This document may not be publicly disclosed or reproduced in any way to anyone without the express written consent of TMW Systems Inc.
No copies may be made for any other reason, or to create derivative works or compilations with this documentation. No one may republish, redistribute, or include the use of this work in support of or in conjunction with any service or service offerings.