Martus EZ Connector - Setup Instructions (IT Team)

The EZ Connector is used with File-Based Integrations to automate the process of loading transaction files into Martus. The EZ Connector is a Martus application that is installed in a location of the customer’s choice on the customer network; this is the location where transaction files from the customer’s account system will be placed. In most cases, the customer’s IT team will be responsible for setting up the Martus EZ connector, following the instructions below. 

Before reading this document, you should be familiar with File-Based Integrations. Refer to File-Based Integrations - User Documentation for more information.

Martus Instance Configuration 

The Martus implementation consultant will provision the Martus instance. This will include adding admin users to Martus. It’s typically best to have the person who will be installing the Martus EZ Connector (IT) temporarily set as an Admin so they can download the files needed on their computer. Once installed, those Admin privileges can be revoked. Martus Admin User An Admin will need to login to Martus, and generate the API token for the files to be uploaded via automation: 

1. Admin Login to Martus 
2. Dashboard > Updater 
3. Under File Upload API > Click Generate Token
   

Once that Token is generated, the Endpoint, API Token, and Curl Example will populate for the end users to supply to their IT department in order to script the automation. (shown below)

Download and Install EZConnector 

We recommend that the IT person who will be installing the Martus EZ Connector (IT) be added as a user in Martus and temporarily set as an Admin so they can download the files needed in the appropriate location and access the files needed. 

1. IT Admin user logs ino Martus 
2. Dashboard > Updater 
3. Click Martus EZ Connector Installer
    
4. Once the file downloads, click the file once to install EZ Connector 
5. Select Windows Service when prompted
    
6. Save in the desired location
   
7. In Martus, download MEC File
   
8. Save a transaction file in the same location where the Martus.Connector file was created
    

Launch Martus EZConnector – Add Connection String to Make Connection 

The company will now appear on the Martus Connector, but you will need to add the Connection String to make the connection. 

1. Open the Martus EZConnector 
2. Click checkbox under Auto Run
   

Confirm New Folders Have Been Created 

Once EZConnector recognizes the connection, new folders will be automatically created to be used in the automation. 

1. In the Martus.Connector folder confirm new folder has been created (environment - client number). In this example the Environment is QA and the Client is 1634.
   
2. Open folder and confirm appropriate subfolders have been created 
   • Archive 
   • Incoming 
   • Invalid
     
3. Files can now be placed in this folder and automation can begin! 

Test Connection 

Test the automation. Upload a file into Incoming and watch what happens in Martus! 

1. Place file(s) in the Incoming folder
    
2. To test automation - wait 60 seconds. Files will disappear from the Incoming folder and will appear in the Archived folder.
   
3. Review Martus Updater Screen (Success!)