The WEBcnx plugin for Impact CAD requires the relevant site URL to be configured, so that when the plugin is launched it can load the site content. This article covers those steps and potential pitfalls.
URL Configuration
The URL for the WEBcnx site is the same as you would enter in a web browser to access the full WEBcnx site application. However, you should be careful to make sure the configured URL matches the environment that the Impact database connection is linked to.
For example, you may have a production site, and one or more test and development sites. If within Impact, you have several available database connections for one or more of those environments. Each one for which the plugin needs to be used with will need to configured separately. The WEBcnx URL is then stored along with the database configuration in the registry (key: WEBcnxURL).
Valid URL Syntax
If your site's WEBcnx URL is https://webcnx.boxcorp.com (and is SSL enabled), the compatible site web addresses you can enter within the 'URL' field on the 'WEBcnx Settings' dialog are:
- https://webcnx.boxcorp.com/webservices/service.svc
If your site's WEBcnx URL is http://webcnx.boxcorp.com (and is NOT SSL enabled), the compatible site web addresses you can enter within the 'URL' field on the 'WEBcnx Settings' dialog are:
- http://webcnx.boxcorp.com/webservices/service.svc
During validation, the URL will be checked, and if the expected http / https is missing from the start of the URL string, 'http://' will be added automatically. Similarly, if the URL does not end with 'webservices/service.svc', this will be added automatically.
Troubleshooting
If you encounter any errors (for example, 'Invalid Url' or 'URL is not valid please specify another') when specifying or validating the WEBcnx URL, please check the following:
- The installed WEBcnx plugin and WEBcnx site versions match
- The WEBcnx URL specified can be reached via a web browser on the same client
- The WEBcnxURL key in the database is not blank or corrupted. You may need to consider running Impact as an administrator to elevate user privileges sufficiently to create and edit this registry key. In some cases, it may be required to delete / clear the existing value should the plugin fail to load within Impact
- The http / https prefix matches the site's configuration, i.e. is it configured with an SSL certificate, and are the appropriate web.config endpoints exposed - your site administrator will be able to help you confirm this.