TMI Trippak Online

yellowbox

Overview

yellowbox

First introduced as an integration within TruckMate 2013, Truckload Management Inc. (TMI) is a business partner that provides trucking companies with a document imaging and printing service called Trippak Online (which includes processing/scanning/indexing of drivers' paperwork from TMI’s own network of drop boxes across the continent). Unlike other imaging product partners (Microdea, Pegasus, and PaperWise), TMI provides access to these services only from within their own system and hence the 'interface' is simply a data export program of certain TruckMate data (orders, invoices, clients, drivers) to their system - as per TMI’s specifications.

The first step is to construct the list of data records to be exported. There are three ways to do this: 'Master', 'Automatic' and 'Manual'. Normally, you would start with a master export to initially load TMI with all the existing data in the TruckMate database, then 'turn on' triggers (checkbox on extract tab) to 'automatically' add a record to the export list whenever an item (order, invoice, client or driver) is added or changed in TruckMate. The second step is to periodically review this list of records to be exported, optionally deleting individuals or adding 'Manual' records as desired, and generate the actual text file using the 'Extract' button (the file produced is named by appending the current time: yyyymmddhhmmss to either OR or IN and adding the extension .TXT to the directory specified in the FTP tab). Finally, FTP the file(s) to TMI (there is an option to send only one specified file at a time or all files with .TXT extension in the specified FTP directory). There is also an optional timer to automatically ftp every so many minutes (like EDI).

Note: This TMI integration requires a CUSTTYPE field unique to this integration:

CUSTTYPE: 1=EDI, 2=No Backup Read, 3=Backup Read.

`There is no dedicated field for this in the existing TruckMate tables so use the Application Configurator program 'TMI.EXE' option to specify which user field to export for this.

To open the Export to TMI Trippak Online program double click 'TMI.EXE' in your TruckMate system folder (usually 'C:\Programs (x86)\TruckMate20xx\').

How Do I?

yellowbox

How do I Use Export to TMI Trippak Online?

  1. To open the Export to TMI Trippak Online program (TMI.EXE), open 'TMI.EXE' from your TruckMate system folder (usually: 'C:\Program Files (x86)\TruckMate20xx\').

  2. The first step is to construct the list of data records to be exported. There are three ways to do this: 'Master', 'Automatic' and 'Manual'. Normally, you would start with a master export to initially load TMI with all the existing data in the TruckMate database, then 'turn on' triggers (checkbox on extract tab) to 'automatically' add a record to the export list whenever an item (order, invoice, client or driver) is added or changed in TruckMate.

  3. The second step is to periodically review this list of records to be exported, optionally deleting individuals or adding 'Manual' records as desired, and generate the actual text file using the 'Extract' button (the file produced is named by appending the current time: yyyymmddhhmmss to either OR or IN and adding the extension .TXT to the directory specified in the FTP tab).

  4. Finally, FTP the file(s) to TMI (there is an option to send only one specified file at a time or all files with .TXT extension in the specified FTP directory). There is also an optional timer to automatically ftp every so many minutes (like EDI).

Note: One of the client fields TMI requires is: 'CUSTTYPE: 1=EDI, 2=No Backup Read, 3=Backup Read'. There is no dedicated field for this in the existing TruckMate tables so use the Application Configurator program 'TMI.EXE' option to specify which user field to export for this.

Layout

yellowbox

Extract Tab

The first step is to construct the list of data records to be exported using the Extract Tab. There are three ways to do this: 'Master', 'Automatic' and 'Manual'. Normally, you would start with a master export to initially load TMI with all the existing data in the TruckMate database, then 'turn on' triggers (checkbox on extract tab) to 'automatically' add a record to the export list whenever an item (order, invoice, client or driver) is added or changed in TruckMate.

image3

Export Grid

Select the '+' button on the navigational bar.

Source

Read-only information. May pre-populate with your selected choice of one of: Master, Automatic, or Manual.

Data Type

One of: Order, Invoice, Client, or Driver. On a manual source entry, use the pull-down arrow to select your data type.

Data ID

The key field for the data (for Orders and Invoices—​DETAIL_LINE_ID from TLORDER; for Clients—​CLIENT_ID, for Drivers—​DRIVER_ID). On a manual add, a 'Select Order' dialog box will open allowing you to search by Bill Number, Shipper Name, Consignee, and Trace Number.

Data Description

Read-only information. Enter a more meaningful description of the key field for the data (for Orders and Invoices- Bill Number and Bill-To Code, for Clients and Drivers- Name).

Enable Auto-Generate Triggers

Select this checkbox to 'turn on' triggers (checkbox on extract tab) to 'automatically' add a record to the export list whenever an item (order, invoice, client or driver) is added or changed in TruckMate. . All items in the export list created by this method will have AUTOMATIC in the source column (unless you edit the export line- in which case the source column changes to MANUAL).

Master

Add records to the export list for all clients (or invoices or orders or drivers) in TruckMate. This would normally be done once to initially load TMI with all existing data. All items in the export list created by this method will have MASTER in the source column (unless you edit the export line- in which case the source column changes to MANUAL).

Extract

Selecting the 'Extract' button creates a flat (text) file containing data for all the items in the export list (and deletes the items from the export list). The file is created in the directory you specify in the FTP tab. The format of the flat files must meet TMI specifications. They would be able to 'read' such a file and create the data in their system.

The second step is to periodically review this list of records to be exported, optionally deleting individuals or adding 'Manual' records as desired, and generate the actual text file using the 'Extract' button (the file produced is named by appending the current time: yyyymmddhhmmss to either OR or IN and adding the extension .TXT to the directory specified in the FTP tab). Finally, FTP the file(s) to TMI (there is an option to send only one specified file at a time or all files with .TXT extension in the specified FTP directory). There is also an optional timer to automatically ftp every so many minutes (like EDI).

FTP Tab

A final step is to FTP the file(s) to TMI using the FTP Tab. There is an option to send only one specified file at a time or all files with .TXT extension in the specified FTP directory). There is also an optional timer to automatically ftp every X minutes (like EDI).

image4

Directory

Enter the complete path to where you want the export file created.

Send

Select either 'All Files' or 'Only 1 Below', which would mean you wish to export all files shown below, or merely the one file showing below.

File

Use the search button to go to the file located on your machine

Host

Enter the host information in the field provided.

User ID

Enter the FTP User ID as given to you by your Database Administrator.

Password

Enter the FTP Password as given to you by your Database Administrator.

Every (value) Minute

Use the up/down arrows to modify the minute reading until it shows your desired minute number.

Start

Press the 'Start' button when you are ready to automatically transfer the data. Once you press the 'Start' button, you will notice text in the lower left-hand corner saying 'Auto-Transfer On- Next Transfer (the appropriate minute amount)'.

Auto Extract First

Will automatically extract the data first, and then export it.

Extract and Transfer

Select this radio button if you wish to extract the data and then transfer.

Transfer Only

Select this radio button if you wish to transfer the data only.

Now

Press the 'Now' button to begin the manual transfer of data.

Log Tab

Every time an extract or FTP process is started or completed, a note is logged in the Log Tab, including an indication of any errors that occurred. It may be useful to review this log periodically, especially if you do automatic transfers.

Save

Select this button if you wish to save the data transfer/export log to a file.

Print

Select this button if you wish to print a copy of the data transfer/export log.

Clear

Select this button if you wish to clear the data transfer/export log.