Grappling with "Ignoring portion of document that uses a feature from another version of Notes"

In one our databases, whenever we were trying to open a document it used to give us an error of "Ignoring portion of document that uses a feature from another version of Notes". We were able to see all the fields in document properties, even able to extract all the attachments in it using LotusScript code. But document was simply refusing to open in the UI.

A little search and we found this technote which details out the reason and possible solutions to get the document opened. One of them included deleting the problematic rich text field. YIKES!

But what eventually what helped us was this intelligent suggestion by Cathy Fitzherbert. Just open the document in a browser in edit mode and save it. Then you can successfully open it in your Lotus Notes client. On the downside, you lose all the formatting in your rich text field and all the attachments will start to appear at the bottom of the document.

Use replica ID in @DbLookup with caution

Few days back I was faced with an issue where a user reported the following error message while opening a form in Lotus Notes client:

Field '<FIELD NAME>': Connection denied. The server you connected to has a different name from the one requested.

While this thing was working at almost all other machines (including mine), it was just one user where it was not working. The formula on the field was a single line database lookup as:

@DbLookup("":"Nocache"; <REPLICA ID>; <VIEW NAME>; <KEY>; <FIELD NAME>);

After unsuccessfully going over technotes, forums and blogs I went back to help documentation for @DbLookup and something caught my attention.

Installing and running XPages Extension Library in your local machine

I had been hearing a lot about XPages Extension Library and finally got to try it out in XPages code-a-thon held at Mumbai. So I decided to try it on my local machine along with little help from experts on StackOverflow. Its a simple two-step procedure - install extension library and run extension library.

Install XPages Extension Library

First of all get the latest release of extension library from OpenNTF. Unzip the file and find "updateSiteOpenNTF-designer.zip". Unzip it and you will get two folders of "features" & "plugins" and a file "site.xml". In Lotus Notes sidebar, go to My Widgets and select "Options > Configure a Widget from... > Features and Plugin on an Update Site". If you are unable to see My Widgets in your sidebar then click here.

Enable "File > Application > Install..." in Lotus Notes

Mary Beth Raven in her blog here shows how to enable "File > Application > Install..." in Lotus Notes. Just you go to "<Lotus Notes folder>\framework\rcp", find a file "plugin_customization.ini" and add a line com.ibm.notes.branding/enable.update.ui=true in the file.

But based the screenshot provided on her blog I guess she didn't ran into a specific problem, which I did, because she was using Windows XP. Basically if you edit the file plugin_customization.ini and try to save it you will get an error saying "Cannot create the C:\Program Files\IBM\Lotus\Notes\framework\rcp\plugin_customization.ini. Make sure that the path name are correct."

Displaying My Widgets in your sidebar in Lotus Notes

To display My Widgets in your sidebar panel, go to "File > Preferences...". In the Widgets tab enable the option of "Show Widget Toolbar and the My Widget panel".