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

Introduction to TMT Fleet Maintenance Web Services

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

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. http://localhost/AMSEnterprisePages/Tiles/AMSDefault.aspx becomes http://localhost/AMSEnterprisePages/IntegrationToolkit/IntegrationToolkit.svc

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

Connecting Connecting to the ToolKit Click the Advanced… button

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

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.

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

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

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.

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.

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”.

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.

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.

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.

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.

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.

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.

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: 440.721.2937 e: bdavis@tmwsystems.com M O V I N G Y O U F O R W A R D T H A N K Y O U

© 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.