ndClick is a Windows or Mac app that works with NetDocuments services to allow working with documents on your file system in a variety of ways. It works independently or together with ndOffice (if installed), and provides key functionality, including:
ndClick replaces ndOneClick for Chrome, Edge, Firefox, and on Mac, Safari and is a replacement for the Internet Explorer and ActiveX experience.
Related User Articles and Announcements
Related Admin Articles
Admin Topics in this Article
- System Requirements, Downloads, and Setup
- How to Get Started with ndClick
- ndClick FAQ
- Windows Registry
System Requirements, Downloads, and Setup
Note: After running, ndClick will disable ndOneClick in the user's Application Settings, if already enabled.
To set up ndClick software to your organization endpoints:
- System Requirements
- Download ndClick
- How to Use ndClick
- Additional Browser Setup for Microsoft Edge and Firefox
- Microsoft Windows 10 (64-bit)
- .NET 4.6.2
- Chrome, Edge, or Firefox
- ndOffice (2.6 or higher)
- macOS 10.13 or higher
- Chrome or Safari
IMPORTANT NOTE: ndClick 1.3 supports multi-user environments (Citrix, RDS, etc.) when used with ndOffice 2.6 in Chrome or Edge browsers. Because Firefox requires manual configuration of the port used by ndClick, it is not supported in multi-user environments.
NOTE: Because the NetDocuments Chrome Extension does not work in multi-user environments, the final ndClick 1.3 installer includes an option to not install the Chrome Extension:
msiexec /i C:\ndClickSetup.msi INSTALLEXTENSION="" (capital letters required)
Additional Browser Setup for Microsoft Edge and Firefox
Microsoft Edge (legacy)
Using Microsoft Edge with ndClick requires "loopback" to be enabled. To do this, type in the address bar:
Ensure the item “Allow localhost loopback” is checked.
If you are on Windows 10, you may need to additionally open a command prompt with admin privileges and enter:
CheckNetIsolation LoopbackExempt -a -n="Microsoft.MicrosoftEdge_8wekyb3d8bbwe
Firefox currently requires that you add an exception to communicate with ndClick.*
To allow this:
- Enter the following in the browser's address bar:
(or whichever port between 60500-60550 ndClick is running).
- A screen appears indicating that the connection is not secure. Select the Advanced option.
- A message appears informing you that localhost:60500 uses an invalid security certificate. Select the Add Exception option.
- At the next dialog, confirm the security exception.
* This manual intervention precludes the use of ndClick with Firefox in multi-user environments (Citrix, RDS, etc.)
Why Do You Need ndClick?
Browser software, by design, prohibits interaction with applications and data on the local system. You can download, but not run any local process, like opening a Word document. Similarly, no change appears in the browser when you save or close a local file. To facilitate such interaction and to bridge that gap, you need trusted software.
How Does ndClick Work?
ndClick is a small secure HTTP server, running on localhost via the first available port starting from 60500-60550. ndClick only accepts communication requests from web pages that end in netdocuments.com and netvoyage.com. Since it’s running between the browser running the NetDocuments web page and the non-routable localhost, it’s secure. It requires no passwords or logging in.
Once you try any function in NetDocuments that interacts with the local PC, ndClick springs into action and communicates with the localhost server, sending the information and commands to perform the request.
For opening documents, if ndOffice is present (Windows only), ndClick tells ndOffice to go and get the selected file, and ndOffice does the rest.
For all its other functions, and for when ndOffice is not installed, ndClick manages things on its own; allowing you to open and edit documents, upload new documents, move or copy files from your local PC to NetDocuments and print.
What Specifically Can ndClick Do?
- Opening documents with and without ndOffice
- Uploading documents from the file system
- Creating a blank document
- Emailing a Document or Link
- Printing from NetDocuments
- Integration with ndOffice
- Echoing with ndClick and ndOffice
Opening documents with and without ndOffice
When ndOffice is present, select a document (or using any of the open options) to communicate the document information to ndOffice. This is called the ndOffice handoff. Once it happens, ndOffice is in full charge of checking out, downloading, opening, saving back to the web, and automatic checking in of the document.
When ndOffice is not present, ndClick selects a document checks it out, downloads it, and then opens the document for editing. When the user closes the document they must click the green check-in icon beside the document. In addition to the green check-in button, check-in and upload occurs when the user navigates to another page, refreshes the page, or clicks the check-in list at the top of the page to check-in more than one document at the same time.
Uploading documents from the File System
From NetDocuments via the +Add button, upload a document from your file system with an option to move the file as well as copy. If you close the initial browser dialog you can drag and drop files to the NetDocuments upload area.
Creating a blank document
From NetDocuments via the +Add button, create a blank document. ndClick creates this document immediately in the location in NetDocuments and is opened locally for you to edit. After the document closes, if ndOffice is present, the document automatically uploads and checks in. If you are not using ndOffice, simply click the check-in button. Note that if it’s enabled in the cabinet, the user can also create documents in online versions of Microsoft Office.
Emailing a document or link
When Desktop Email integration is enabled in settings, ndClick allows you to email a document or a document link through your email application via the options in NetDocuments menus.
Deliver a Secure Link
When Desktop Email integration is enabled in settings, ndClick allows you to send a secure link to a document via your email application. When the dialog appears for delivering a secure link, at the bottom of the dialog, a Send link through email option appears.
Printing from NetDocuments
ndClick allows you to print documents locally. If ndOffice is present ndOffice handles the printing.
Integration with ndOffice
When ndOffice is present, documents that are opened or printed are automatically handled by ndOffice. Opened documents are automatically checked back in after closing them when ndOffice is present.
Echoing with ndClick and ndOffice
When opening documents, if ndOffice is present, echoing is handled by ndOffice. If ndOffice is not present, or for other ndClick functions listed above, echoing is handled by ndClick.
On Windows, ndClick uses the registry value pair “EchoingFolderPath” with a data value specifying the folder location. It uses the registry value pair “EchoRetention” with a data value of an integer for the number of days to retain echoed files. Both value pairs can be found in HKEY_CURRENT_USER\Software\NetVoyage\NetDocuments.
Without ndOffice, and for the functions that ndOffice doesn’t handle when ndOffice is present (everything except open and print), documents are echoed in a sub-directory below the location specified by EchoingFolderPath in a directory formed from the service name and hostname being used. Variations are:
Beneath that location is another sub-directory formed from the SERVICENAME-user guide where the files are echoed.
On macOS, files are echoed in the users Library folder underneath a directory called ndClick, and then in subfolders identical to that described for Windows. Retention is controlled via the com.netdocuments.ndClickMac.plist file found under the user Library, under Preferences. The number of days is controlled by the tags <integer>7</integer> (seven days) and echoing is either enabled or not via the tags <true/> <key>ndClickHasBeenLaunched</key> <true/> (the default value is the word “false” instead of “true”.
Reboot the Mac after editing the plist file.
ndClick keeps a very simple log, but you can enable support logging and leave it enabled. To enable support logging, right-click the ndClick icon and choose “Enable Support Logging”. It remains enabled until you turn it off.
Logs are found on Windows in the top level of the echolocation. ndClick keeps a log, which we call ndClickLog.log. There is also a json list of files that are worked on in that directory.
On Windows, ndClick uses the following registry settings and shares these settings with ndOffice:
|Key and Definition||Value||Type||Data|
HKEY_CURRENT_USER\Software\NetVoyage\NetDocumentsThe local location for the top level of where ndClick (and ndOffice) will perform echoing.
|EchoingFolderPath||REG_SZ||Any local path on the C drive|
HKEY_CURRENT_USER\Software\NetVoyage\NetDocumentsThe number of days that ndClick (and ndOffice) retain files in echoing. ndClick removes files every hour. ndOffice removes files the minute they expire. Use -1 to turn off echoing.
|EchoRetention||REG_SZ||Integer for the number of days for echoing|
How do I know if ndClick is working?
When you click a document in NetDocuments, ndClick opens rather than just downloads the document and a document ID appears in the title bar of the document (Word and Excel). With ndOffice, you can further tell if ndOffice is handling the document because the name of the document and its status appear in the ndOffice Activity Center. If ndOffice is not installed, there is a big green check-in button that appears when you open a document.
Common problems and their solution
- ndClick is no longer running
- ndClick isn’t working and the log says that “nothing will work”
- printing eml files from ndweb produces an error.
- TYPE_E_ELEMENTNOTFOUND issue
ndClick is no longer running
Ensure that ndClick is running in the tray. It may be in the hidden section of the tray. Note, you can drag the ndClick icon from the hidden part of the tray to the visible part.
The browser was opened before ndClick was started (restarted).
Refresh the browser pointed to NetDocuments if it was already opened when you started or restarted ndClick.
ndClick isn’t working and the log says that “nothing will work”
This can be caused by a firewall blocking ndClick. Since ndClick is a server, some firewall settings may try to block it from communicating with the NetDocuments web page running in the browser. Note that since ndClick is running on localhost and only communicating with the netdocuments.com or netvoyage.com website, there is no security risk and such a complaint by the firewall is unjustified.
Printing EML files
ndClick cannot yet print EML files from ndWeb and you will get an error stating
"The document cannot be printed. This document's application does not support background printing."
You need to open the mail item natively in Outlook to print.
This will be resolved in ndClick 1.5.
To solve that issue follow the next steps:
- Run a file search across the entire system with the following search text: NetDocuments.Client.COM.tlb.
- Open each found location with the file in a separate window.
- The correct location for the corresponding file is the ndOffice installation folder (for example, the default one is C:\Program Files (x86)\NetDocuments\ndOffice)
Warning: don't delete the NetDocuments.Client.COM.tlb file from this location.
- Delete the NetDocuments.Client.COM.tlb file from all other locations.
- Restart ndClick and ndOffice.