Product: Transaction Manager
What is the Integrations DLL?
A Dynamic Link Library (.dll) is a file that acts as a set of procedures and is needed in order to request, send or translate data passed to and from your ERP and Transaction Manager.
Why is my DLL important & why do I need to update them?
Every ERP supported by TrueCommerce has its own unique DLL file. This DLL holds the rules determined by the ERP and Transaction Manager that must be met in order to successfully pass data. Whenever a new version of a particular ERP comes out, the rules usually change along with it. For this reason, it’s important to let TrueCommerce know of any upgrades or updates from your current ERP version to a newer one. Often these rules have to be updated within the DLL, which requires our team to prepare modifications. ERP updates made before the DLLs have been updated may cause interruptions, errors or even lock you out from passing data until the rules in the DLL match your updated ERP.
Please note that it is very important to always backup your DLL files before you attempt to reinstall/update/modify your Transaction Manager Integration Service.
Common error: InitializePlugInDll
If you receive this error, you can try the steps below to attempt to fix your Integration DLLs. Note: Another common error is "Exception has been thrown by the target of an invocation".
Solution 1 - Restart the Integration Service
You will need Admin Rights to perform this action!
- Use the Windows Search to find your Services App
- Locate Transaction Manager Integration Service
- Use the Restart button on the top left to restart the service
After restarting the Integration Service, go ahead and try again. Most times a restart of the Integration Service can alleviate any issues with a previously working connection.
Solution 2 - Update Your DLLs
The DLLs that your system use will be located in your C:/Program Files (x86)/True Commerce/TmoIntegrationService folder.
If you do not have this folder, please check that you are not using a Terminal Server (i.e. using another application to “remote” into another computer to use Transaction Manager).
If you're not using a Terminal Server and still do not have this folder, you will need to install the Integration Service (instructions at the end of this article).
Step 1 - Backup your DLLs
Navigate to C:/Program Files (x86)/True Commerce/TmoIntegrationService
Locate your DLL and move to a safe place
Always locate your appropriate Tc.Int.Platform.BSPxxxx.dll and back it up to a safe place before updating your DLLs! This ensures you always have a saved DLL to return to for any reason.
Step 2 - Use the DLLs provided in the folder
Some versions of the Integration Service have the latest updated DLLs already inside the folder. If that’s the case, you just need to move them. Locate the subfolder labeled with your ERP: C:/Program Files(x86)/True Commerce/TmoIntegrationService/ErpFolderName
If there is a Setup.exe located in your respective folder, you will want to install that first as an Admin (Note: Not all ERPs require this).
Copy the DLL located in this folder, and paste it into the main TmoIntegrationService folder.
Restart the Integration Service again (provided in Solution 1).
Solution 3 - Enable Permissions
It is possible that your computer is denying Transaction Manager access because the folder that holds the DLLs is set to not allow it to read or write to that folder.
Navigate to C:/Program Files (x86)/ and locate the TrueCommerce folder. Right Click the folder → and select Properties
Select the Security Tab
Provide Full Control permissions to the Everyone user
If the Everyone user is missing - select the Edit button. Select Add on the new popup window. Type Everyone into the box on the bottom. Select Check Names and hit OK.
Check the Full Control checkbox under the Allow column with the Everyone user selected
Solution 4 - Reinstall the Integration Service
Sometimes a clean install is best!
Backup any DLLs you may have!
Stop the Transaction Manager Integration Service in your Services tab
Uninstall the Transaction Manager Integration Service from your Add/Remove Programs
Delete the C:/Program Files (x86)/True Commerce folder
Delete the C:/ProgramData/TrueCommerc folder (this is a hidden folder)
Install the Integration Service following the instructions below.
Installing the Integration Service
If you do not have the Integration Service Installed you will need to have it installed for every computer that uses Transaction Manager:
- Navigate to Transaction Manager → Integration Settings → Download Integration Settings
- Launch TmoIntegrationServices.exe as an Admin
- Follow the prompts of the on-screen installation