Customizing and Testing the ConnectWise Connector

If you want to extend or amend the out-of-the-box functionality that is offered from our ConnectWise connector, you can do so from the "edit integration" page. The extensions you can do is to change the mapping between the interworks.cloud and ConnectWise entities, or to implement new push and pull methods that are not currently supported from our connector.

Customizing your Connector


For customizing your connector you must change the JSON specification that includes the API endpoints, the Pre/Post conditions, the transformations schemes etc.  For more details, check please the following links. These links are part of the description of our integration framework, but since our ConnectWise connector has been built using this framework they will help you understanding how you can apply the changes you need.

Especially for the customization of the transformations schemes, you can use the "Transformation Helper" section. In this section you can see the default transformation scheme for any push or pull method and change it as you like.

Testing the Connector


For testing the supported push and pull methods, you can use the "API Tester" section. Using this tool you can test the how the data are exchanged between the two systems. For more details, check please Testing the Integration Instance

Using a New Version of the ConnectWise Connector


The changes we are doing in our connectors are not applied automatically to your instances because we don't want to override any customizations you have done. You will be notified for changes in our connectors from our release notes and you should run the following process whether you want to apply these change or not.

At the bottom of the "Definition" section you will find the "Merge Tool" option. 

This tool will compare the JSON file you have against the new version of connector's JSON file and it will highlight the differences.

You can check the differences and decide which one you want to apply or not to your connector. 

If you want to check the changes for a specific transformation scheme, you can use the "Merge Tool" from the "Transformation Helper" section. From this section the merge tool will run only for the selected transformation helper.

Table of Contents