Configure script connectors for testing

Connectivity Hub supports scripted sub-connectors. These operate in the same manner as a traditional Upland BA Insight connector, allowing you to simulate and test connector behaviors. These script connectors can be used to emulate specific use cases, such as unexpected data, timeouts, performance testing, etc.

Configuring a scripted sub-connector

To use a scripted sub-connector for testing, do the following:

  1. Download a script connector that allows you to test your particular use case. To obtain a script connector, you will need to contact your Upland BA Insight representative.

  2. Copy the downloaded script connector to the following path in the Connectivity Hub installation folder: Upland BA Insight/Connectivity Hub/Script Connector/SubConnectors.

  3. In a browser, navigate to the URL for your script connectors. For example, https://localhost:55001/ScriptConnector. On this page, a list of all deployed script connectors displays.

  4. Click on the script connector you wish to use.

  5. Connectivity Hub will attempt to compile your script connector. If it is successful, a "Script connector compilation was successful" message displays at the top of the page. If it is not successful, a "Script connector compilation was unsuccessful" message displays, with additional information on the error. Additionally, the error will be highlighted in the generated source script.

  6. In Connectivity Hub, create a new connector to the script connector.

    1. Click Connections > New Connection.

    2. In the Web service URL field, enter the URL for the script connector. For example, https://localhost:55001/ScriptConnector/DataConnector.asmx.

    3. Click Connect, a Services drop-down list appears with all deployed script connectors.

    4. Select the script connector you want to use from the Services drop-down list.

    5. Provide a name for your connection.

    6. Click Save Changes.

  7. In Connectivity Hub, create a new content source for the connection created above.

    1. Click Content Source > New Content Source > Web Service Content.

    2. In the Connection field, select the name of the script connection you created in step 6.

    3. In the Target field, select the target you want to use.

    4. In the Title field, provide a name for the content source.

    5. Click Done.

  8. In Connectivity Hub, navigate to your content source, and click the Settings icon > Test.

    1. In the Content Source field, select the name of the content source you created in step 7.

    2. In the Maximum Displayed Results field, specify the number of results you want the connection to receive.

    3. Click Run.

  9. After running, your test results will display.