Enabling round-trip editing in IBM Lotus Quickr 8.5 for Domino without using Quickr Connectors

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

• qext.page.field.attachments_activex
• qext.page.field.singleAttachment_activex

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

	{

	registerWidgets:

	[

	 //Register the Module with the samples.

	{

	type: "registermodulepath",

	name: "qext",

	path: "/qphtml/skins/qext"

	}

	,

	 type: 'globalreplace',

	source: 'quickr.widgets.page.field.attachments',

	use: 'qext.page.field.attachments_activex'

	}

	,

	{

	type: 'globalreplace',

	source: 'quickr.widgets.page.field.singleAttachment',

	use: 'qext.page.field.singleAttachment_activex'

	}

	 ]

	}

• Forum topic
• 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.

Conclusion

• Latest Fixpack download
• wiki article, “How to manually (or unattended) install the ActiveX upload control for Internet Explorer.”
• developerWorks® Lotus Quickr product page.
• Lotus Quickr Connectors product page
• Product Documentation topic, “Controlling use of Connectors for round-trip editing in Web browsers: qd85.”