Skip to main content

How to Install the OpenNTF Document Management Plugin for Lotus Notes 8.5.x

There's now a great new OpenNTF document management plug-in for Notes. I'm interested in seeing if I can move away from MS Office and this little utility seems to me to be the best way to start. It allows you to work on documents in folders while still keeping things available for users who prefer to access folders directly. The only caveat that I've found so far is that it wants everything to be stored in OpenDocument format and will convert the imports accordingly.

So... I've just installed this plug-in and in typical "dumb-user" fashion, I had to ask a number of questions of the authors.

I thought that to save others a bit of time and to illustrate the whole procedure, I'd make the procedure available here. Even if you're not interested in this particular plug-in, you might be interested in some of the others which are available. (like the awesome FileNavigator project). These steps might just be the ticket to installing them.

My instructions worked on Lotus Notes 8.5.2 but should work on other some versions too.

Click here for the project page for DocumentManagement. In theory you can download it from OpenNTF. I think you have to be logged in first. For some reason, I've been finding it difficult to download anything on OpenNTF recently, so if you experience difficulty, head to their blog post and use the download link there.

2. Extract All files to a folder:
In my case, since I put all our Widgets together on a corporate drive, I extracted all of the files to X:\IBM\Lotus\Widgets\DocumentMangement. Your setup is probably different so just extract them wherever you want (and remember where you put them).

Note that I had to separately unzip the updatesite sub-folder. For some reason it's a zip inside the ZIP. Notes didn't want to read it when I first tried, so I unzipped it.

3. In Lotus Notes client click File, Application, Install on the menu.
What? You don't have a File, Application, Install menu option? Sometimes you don't. I'm not sure why. It might be an 8.5.0 or 8.5.1 thing because I didn't need to do it in 8.5.2.

To enable the Eclipse update manager UI in Lotus Notes, use these steps...

a. Close your Lotus Notes client

b. Start Notepad or your preferred text editor.

c. Open the \framework\rcp in the Notes Application Directory
In my case, this was,
C:\Program Files\IBM\Lotus\Notes\framework\rcp

d. Look for a file called plugin_customization.ini and open it.

e. Add the line
com.ibm.notes.branding/enable.update.ui=true
anywhere in the file.

f. Save and close file

g. restart Lotus Notes

Thanks to Christian Petters at www.cubetoon.com who first saved me from that gotcha.

Ok, detour over... let's resume...


3. In Lotus Notes client click File, Application, Install on the menu.

4. Choose the option maked (o) Search for new features to Install and click the button marked Next.

5. Click the button marked Add Folder Location...

6. Browse to:
X:\IBM\Lotus\Widgets\DocumentMangement\Updatesite
(or wherever you saved your files to back in step 2)
and click Ok.

7. You'll be presented with an "Edit Local Site" dialog box, just click Ok.

8. Click Finish. (this button lies - seriously... there's a long way to go yet)

9. On the next screen, select DocumentManagement/updatesite
For some crazy reason, it defaults to unticked ... then click Next

10. Click (o) I accept the terms in the License Agreements, then click Next.

11. Click Finish. (Guess what, this button lies too - we're not finished yet).

12. On the next screen, select (o) Install this Plug-in
This is another crazy default because it defaults to do not install the plug-in. If you weren't paying attention, you'd have to start all over again - I've been there before... more than once.
Click ok.

13. Watch Bar Graph

14. Restart the Notes Client

15. I got this lovely message when the client restarted
Failed to login
CLFRJ0010E
I don't know what it means but it went away and hasn't come back, so hopefully it's nothing to do with the install procedure.


16. In my installation, this was where I made a big mess. I kept expecting to see a sidebar plug-in and when it wasn't there, I tried reinstalling. Don't do this. It's not the correct procedure. :-)

Click on your Open menu and hopefully you'll see a Document Management option.

Don't click it... I didn't say to click it.

If you did, you'll probably get an error message about the root directory when you first start the application. Don't worry, it's alright. Just click ok. Then close the Document Management window.

17. From the Lotus Notes Menu, click File, Preferences. Look for a Preference called Document Management and click on that.

18. Choose a folder to manage and click Ok.

19. I think the document management app opens up automatically after this but if not, click Open and then Document Management.

If you've got some ODT documents, you might want to drop them in the folder you nominated and then click Refresh. You'll then be able to work with them in the document management facility.

You can also import files and categories (folders) - and everything seems to be updated on the server's file shares in real-time. Now that I've had a quick play, I'll point to something bigger.

Comments

grumpy_coder said…
I think its great that people can now write these amazing widgets. This is something that Notes developers have wanted to do for well of over 5 years now.

But having to follow some 20+ "easy to follow" steps to install and start the widget, (not including obscure error messages), tells another story that is not so favorable for Notes as an easy to maintain platform.... sigh!
Gavin Bollard said…
I was rather hoping I could say, "download, then click Next, Next, Next, Next, Finish".

IBM need to work on that.
Niklas Heidloff said…
We will add this Eclipse feature to the update site on OpenNTF so that you can install it via drag and drop as documented here: http://openntf.org/Internal/home.nsf/dx/Projects_Installation

Right now however we're facing a technical issue related to the OpenNTF infrastructure that we need to fix first.
Bruno CARTIGNY said…
You can install these plug-ins more easily using the Updatesite.nsf.
Extract the plugin file, and then import the site.xml file in this database. And that's all ! Users can then install this plugin with the 'configure a widget from...' from their widget bar on the right (just give them the URL nrpc://yourdominoserver/updatesite.nsf).
Mayank said…
Dear Gavin,

Thank you for the steps.
I have tried the same. Everything went successfully however I am unable to see the Document Management tab under preferences or the open menu. Please help.

Thanks
Mayank

Popular posts from this blog

How to Change Your Notification Options for New Lotus Notes Mail in version 8.x

Don't worry, I'm not patronizing you (my readers), I just decided to re-document this for one of our internal users and thought you might want to be able to use it in your own user documentation. WHAT IS THIS DOCUMENT ABOUT? Some people who don't get a lot of mail, like to be notified when such an event occurs. Notification can be; via a sound via a pop-up box via the system tray (where the computer clock is) The pop up box looks like this; Other people, who like myself, get too much mail would rather not be notified. The aim of this document is to tell you how (and where) to turn these options on and off. CHANGING YOUR SETTINGS To change your settings from the Notes 8.x client; On the Menu, click File , then Preferences... On the left hand side , click on the little plus sign to the left of Mail to expand the options. Click on the option marked Sending and Receiving . In the middle section, under receiving, you can control your notifications. If you untick the box mark

How to Create an Auto-Response Mail Message in Lotus Notes 8.5.3+

Why would you do this? Suppose that you have an externally accessible generic email address for your company; support@mycompany.com or info@mycompany.com. You might expose this to the web and allow people to send messages to you. Setting up an auto-response email will tell the senders that their message reached its destination and that it will be dealt with accordingly.  It's also good practice to include links to FAQs or other useful information. Why 8.5.3 The techniques we'll be using here work in older versions of Notes but some of the options seem to have moved around in 8.5.3.  I figured it was a good time to show you where they've moved to. The Procedure Start Domino Designer and open the Mail file to be modified.  A really quick way to do this is to right-click on the application tab and choose "Open in Designer". In the Left hand panel of designer, expand Code and then double-click Agents.  A new window should appear. Click the action

How to Do a Mail Merge to Email using Lotus Notes

Why do one? In today's "green" world, it makes much better sense to send out emails than letters but you still want to personalize them. Sadly, by itself Lotus Notes doesn't support mail merge to email. Of course, we know that outlook does (but then it lets anyone and anything send emails for you - even when you don't want them to). So, how to do it in Notes? OpenNTF The first port of call is OpenNTF ( http://www.openntf.org/ ). This place is full of great things but most of them are really badly documented. Still, these guys give things away for free and they develop in their spare time, so we should be grateful for what we get. There's a great little project there called MailMerge Excel to Notes . Go there, click on releases and download the ZIP file. Getting to the Code The installation is tricky though I've noted that since I asked the author about the install, it's been updated (so maybe these steps are less necessary). Unzip the files to somewher