TechMate Moving from Manual to Automated Setup

 

If your company is currently using the TechMate Manual Process and is updating to use the  TechMate Automated Process, it is not necessary to complete all the steps within TechMate Automated Integration Setup as most of the steps were completed with the initial setup for  TechMate Integration Setup (now renamed TechMate Manual Integration Setup.) The complete TechMate Automated Integration Setup is required only for customers new to the TechMate integration that are choosing to use the TechMate Automated Process.

 

To make the process for existing TechMate users, these are the only steps from TechMate Automated Integration Setup that need your attention.  The step numbers correspond to the steps within TechMate Automated Integration Setup.

 

PREREQUISTE:  Create a folder where the TechMate Automated Process will put the exports for retrieval by TechMate (Step 2).

 

STEP 1: Add a TechMate Vendor to XML Interface

Setup Area: MoversSuite Administration > Administration > XML Interface

 

Within XML Interface Setup, update your existing TechMate record to add each Branch that will have leads and orders going through TechMate.

 

A screenshot of a computer

Description automatically generated

 

When clicked, choose from the dropdown the Branch to add to this integration. Continue to add each Branch. If you have multiple branches, use the Add All to quickly list all Branches. Enter an Authority Type, either option works with the integration. Nothing needs to be set within the External Code field.

 

A screenshot of a computer

Description automatically generated

 

To reference, all the information on this XML Interface Setup record and the data required for it’s setup, see TechMate Automated Process.

 

 

STEP 2: Add an XML System Setup record for the TechMate Vendor

Setup Area: MoversSuite Administration > Administration > XML System

 

Update the TM (or TechMate) record within XML System Setup by adding an XML System Option. After clicking Click here to add a new XML System Option, set a Name and Value to create the XML System Option.

 

A screenshot of a computer

Description automatically generated

 

Click Click here to add a new XML System Option.

 

A screenshot of a computer

Description automatically generated

 

Set a Name, which must be: TechMateExportFileLocation.

 

The Value set is used as the path to the location that MoversSuite will put an XML file in when the user saves a new Lead. Create a folder, which can be whatever name you like and located whenever you choose (providing the location is on the machine that is running the API.) For the example below, our file path is C:\TechMateExports; therefore, the folder named TechMateExports in located directly on the C: drive.

 

A screenshot of a computer

Description automatically generated

 

To reference, all the information required for this XML System Setup record is detailed within Step 2 within TechMate Automated Process.

 

 

STEP 7: Create a Queue Service Server record.

Setup: MoversSuite Administration> Queue Service > Queue Service Server Setup

 

From MoversSuite Administration> Queue Service > Queue Service Server Setup,  create a new Queue Service Server record by clicking Click here to add a new Queue Service Server.

 

 

When clicked, the New Queue Service Server screen appears.

 

A screenshot of a computer

Description automatically generated 

Enter the following information:

 

Field

Value

Queue Service System

MoversSuite Queue Service

Queue Server Name

TechMate Xml Download

Inactive

Important: This must be unchecked as shown in the image above.

 

After entering the values in the table above, click Click here to add a new Queue Service Server Queue.

 

A screenshot of a computer

Description automatically generated

 

This opens the Add Queue Service Server Queue screen. This section needs to be completed three times with information detailed below to add the three Queue Service Server Queues required for this record. Each Queue Service Server Queue is detailed below with the information that needs to be entered and an image of the corresponding record after it is added. Of note, the choice of Queue Type will determine which fields are available.

 

1. Request Queue:

 

A screenshot of a computer

Description automatically generated

 

Field

Value

Queue Role

Request Queue (Incoming messages to be processed)

Queue Type

File System Folder

Queue Folder Name

C:\TechMate\Request

Filter

Auto-populates as shown

Minimum Message Age (in Milliseconds)

Auto-populates as shown

Message Type

Auto-populates as shown

 

2. Retry Queue:

 

A screenshot of a computer

Description automatically generated

 

Field

Value

Queue Role

Retry Queue (Holds messages for later re-processing)

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\private$\mss_TechMate_xml_retry

 

3. Error Queue:

 

A screenshot of a computer

Description automatically generated

 

Field

Value

Queue Role

Error Queue (Holds bad messages that cannot be processed)

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\private$\mss_TechMate_xml_error

 

The final record should look like this:

 

A screenshot of a computer

Description automatically generated