Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Troubleshoot custom connectors in Desktop

A documentation imported with a custom connector uses the same connector every time you import changes. That's why Desktop doesn't let you remove a connector that a documentation uses. If Dataedo Desktop can't load the connector, it stops the import before connecting to the source and shows one of the messages described below.

info

When the import is blocked, nothing in your documentation changes. No objects are added, updated, or marked as deleted.

Custom connector in use​

When you try to remove a custom connector in Add > New connection > Custom Connectors > Manage Custom Connectors, Desktop shows the Custom Connector in use window instead of a confirmation.

Cause​

At least one documentation was imported with this connector. Removing the connector would disconnect that documentation from it, so Desktop blocks the removal. The window lists up to 10 documentations that use the connector, in alphabetical order. If more documentations use it, the list ends with and N more. This applies to both shared and local connectors.

Solution​

You don't need to remove a connector to install its new version. Overwrite it instead, so all documentations that use it stay connected:

  1. Open Add > New connection > Custom Connectors and click New Custom Connector.
  2. Select the new .dataedocon file. The connector in the file must have the same name as the one you want to replace.
  3. Choose the same storage location as the existing connector, Shared or Local.
  4. Confirm overwriting the existing connector.

You can now click Import changes on any of the listed documentations, and the import uses the new version of the connector.

Custom connector was removed​

Desktop shows a message starting with The custom connector assigned to this documentation has been removed. If you restart Desktop and try again, the message starts with Custom connector is deleted and says that importing further changes is not possible.

This is caused by removing a connector used by this documentation. This can be done in Add > New connection > Custom Connectors > Manage Custom Connectors. This applies to both shared and local connectors.

info

Starting with version 26.4.1, Desktop doesn't let you remove a connector that a documentation uses (see Custom connector in use). This message appears for connectors removed in earlier versions.

Solution​

The connector has to be assigned to the documentation again by Dataedo support:

  1. Note the name of the documentation and of the custom connector it used.
  2. Contact Dataedo support and include both names.
  3. When support confirms that the connector is assigned again, click Import changes in the ribbon.

Local connector file is missing​

Desktop shows a message with the name of the missing connector file.

Cause​

Local connectors are stored as .dataedocon files on your computer, in the following folder:

C:\Users\<username>\AppData\Roaming\Dataedo {mainDataedoVersion}\Connectors

{mainDataedoVersion} is the main version number of Dataedo, for example 26 for version 26.4.

The message appears when the file was deleted or moved outside of Dataedo, or when you import changes on a different computer than the one the connector was added on.

Solution​

  1. Open Add > New connection > Custom Connectors and click New Custom Connector.
New Custom Connector button
  1. Select the same .dataedocon file that was used to import the documentation.
  2. Choose Local as the storage location and confirm.
Choosing where to store the connector
  1. Click Import changes in the ribbon again.
useful tip

To import changes from more than one computer, add the connector as Shared. Shared connectors are stored in the repository, so they are available on every computer connected to it.

Custom connector can't be verified​

Desktop shows a message saying that the connector could not be verified and that the import was blocked.

Cause​

Every custom connector is signed by Dataedo. If the content of a local .dataedocon file was changed after signing, the signature no longer matches and Desktop doesn't load the connector.

Solution​

  1. Replace the .dataedocon file in the connectors folder with the original file you received from Dataedo.
  2. Click Import changes in the ribbon again.

If you need to change the connector's queries, contact Dataedo support to have the updated file signed.

Need help?

If you run into any problems or have questions, reach out to Dataedo support.

Dataedo is an end-to-end data governance solution for mid-sized organizations.
Data Lineage • Data Quality • Data Catalog