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.
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
- Install a new version
- Remove the connector
You don't need to remove a connector to install its new version. Overwrite it instead, so all documentations that use it stay connected:
- Open Add > New connection > Custom Connectors and click New Custom Connector.
- Select the new
.dataedoconfile. The connector in the file must have the same name as the one you want to replace. - Choose the same storage location as the existing connector, Shared or Local.
- 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.
A connector can be removed only when no documentation uses it:
- Note the documentations listed in the Custom Connector in use window.
- Remove these documentations from the repository, or keep the connector if you still need to import changes to them.
- Open Manage Custom Connectors again, select the connector, and click Remove. Desktop asks you to confirm, as with any unused 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.
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:
- Note the name of the documentation and of the custom connector it used.
- Contact Dataedo support and include both names.
- 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
- I have the connector file
- I don't have the connector file
- Open Add > New connection > Custom Connectors and click New Custom Connector.

- Select the same
.dataedoconfile that was used to import the documentation. - Choose Local as the storage location and confirm.

- Click Import changes in the ribbon again.
- Check if the file is still available on the computer where the connector was first added, in the folder listed above. If it is, copy it to this computer and follow the steps in the I have the connector file tab.
- If you can't find the file, contact Dataedo support and include the name of the documentation and of the connector.
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
- Replace the
.dataedoconfile in the connectors folder with the original file you received from Dataedo. - 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.