ShowTable of Contents
In IBM® Lotus® Quickr® 8.5 for Domino®, the round-trip-editing feature requires the Quickr Connector to be installed; however, for some users, it's not possible to install Quickr Connectors, so this editing feature is lost for them. This article introduces a customization solution to retrieve the round-trip editing function under the 85 theme in Microsoft® Internet Explorer (IE) by using QuickPlace (QP) ActiveX control when a Quickr Connector is not installed or detected.
Preparing the customization solution
1. Upgrade to Lotus Quickr 8.5.1 HF26
2. Locate the widgetRegistryConfig_ext.js file in your widgets\resources directory:
eg: (windows) c:\Domino\data\domino\html\qphtml\widgets\resources\widgetRegistryConfig_ext.js
3. The widgetRegistryConfig_ext.js file is shipped as an empty file.
a. If there are no modifications to this file (the file is still empty), you can copy the file widgetRegistryConfig_ext.js_ROUNDTRIP_EDIT, which is located in the same directory, directly to widgetRegistryConfig_ext.js overwriting the old one.
b. If this file is not empty, you will have to merge the contents of the file widgetRegistryConfig_ext.js_ROUNDTRIP_EDIT into widgetRegistryConfig_ext.js. widgetRegistryConfig_ext.js_ROUNDTRIP_EDIT is located in the same directory as the widgetRegistryConfig_ext.js file.
4. Optional: if you never use a connector for round-trip-editing whenever connector is installed, please enable the following settings in the qpconfig.xml.
5. Restart your Quickr server and empty your Internet Explorer (IE) Web browser cache.
As shown in Figure 1, when creating an Upload or Import document, you'll find that the original file name input box is replaced with QP ActiveX control. You can drag and drop a file into this ActiveX control, or click the Browse button to select one from your local file system. You can also double-click the file in the ActiveX control to edit it.
Figure 1. Upload a file with QP ActiveX control
As shown in Figure 2, you can click the Replace button to replace the attachment of an existing upload or import document, or you can double-click the file in the ActiveX control to edit it directly.
Figure 2. Replace an uploaded file with QP ActiveX control
When creating/editing a page, you can drag and drop, choose to delete/edit, or double-click to edit an attachment file directly, as shown in Figure 3.
Figure 3. Attach files to page via QP ActiveX control
NOTE: If a Quickr connector is installed and detected, then this customization will not take effect, but you can still use Quickr connector for round-trip editing, as shown in Figure 4.
Figure 4. Use Quickr Connector for round-trip editing
Implementing the customization solution
In this solution, the following two customized attachment field widgets are introduced in the qext subdirectory:
In widgetRegistryConfig_ext.js, a new qext module is registered, and these two new ActiveX attachment field widgets are used to replace the existing two default attachment field widgets as shown in Listing 1.
Listing 1. Register QP ActiveX attachment widgets
//Register the Module with the samples.
In this listing, qext.page.field.attachments_activex is the new ActiveX multiple-attachments field widget. It inherits from the quickr.widgets.page.field.attachments widget, and overwrites this default multiple-attachments field widget's renderEdit(), prepareForSubmit(), and uninitialize() methods to draw the QP ActiveX control, submit file changes in the QP ActiveX control, and delete temporary files of QP ActiveX control on the local file system.
Also, qext.page.field.singleAttachment_activex is the new ActiveX single-attachment field widget. It inherits from the quickr.widgets.page.field.singleAttachment widget and overwrites the same renderEdit(), prepareForSubmit() and uninitialize() methods.
The limitations of our solution are that it doesn't support
Creating a calendar Event or adding a new Task (though it does support editing an existing Event or Task as shown in Figure 5)
and, as an ActiveX-based solution, it can only support IE.
Figure 5. Edit an existing Event
NOTE: This customization solution can fully support all Customized Forms with single- or multiple-attachments fields.
About the author
Albert Wang is a Software Architect based at IBM's China Development Lab in Beijing, where he serves as the Lotus Quickr Domino Architect and Tech Leader. He has written five Chinese books on computer programming and has published more than 30 papers on computer technology for international conferences and academic journals. You can reach him at firstname.lastname@example.org