Integrating Lotus Quickr with Lotus iNotes enables the following capabilities within Lotus iNotes:
- Browse and insert links to Lotus Quickr files, folders, or places while composing outgoing messages
- Store received attachments in a Lotus Quickr place
- Choose to either store any outgoing attachments into a prespecified Lotus Quickr place and send links to those files, or have Lotus iNotes display a prompt asking whether it should move such attachments to a Lotus Quickr store and send links or send the attachments as is
Prerequisites
To integrate Lotus Quickr and Lotus iNotes, you must:
- Use Lotus iNotes 8.5
- Enable session-based authentication (single sign-on, or SSO) for your Lotus Domino mail server
- Note: If your Lotus Domino server and Lotus Quickr servers are not in the same domain, each session users will be prompted to authenticate with the servers to which they connect.
- Adjust the number of feed entries returned from Lotus Quickr servers (default is 50), if desired, by changing the iNotes_WA_Quickr_Feed_Page_Size value in the server's NOTES.INI file
Limitations
This initial release of Lotus Quickr integration for Lotus iNotes has a few known limitations, especially when compared to the similar capability available in Lotus Notes 8.5:
- When storing received attachments to a Lotus Quickr place, there is no option to also remove the attachment from within the current message and replace it with the Lotus Quickr link to this stored file.
- When viewing a message containing a Lotus Quickr link sent from a workstation with the Lotus Quickr Connectors installed, if the Lotus Quickr Connectors are not also installed on the current workstation, the Edit link does not work. Instead, you encounter an error page in a separate browser window or tab.
- Lotus Quicker integration is not available for Lotus iNotes when you are offline or accessing a local archive database.
Configure proxy-config.properties file
The Web 2.0 features in Lotus iNotes, including Lotus Quickr integration, are controlled by Lotus Domino mail policy settings which can be enabled or disabled on a per-user basis, regardless of which Lotus Domino mail servers the user might have replicas on. The administrator must explicitly enable the desired features for appropriate users.
To integrate with Lotus Quickr and other Web 2.0 features, Lotus iNotes uses a proxy servlet on the Lotus Domino server running as a plug-in within the Lotus Domino XPages servlet adapter. The proxy servlet sends requests out to the particular external site or service (located at a different host address) on behalf of the user, and it returns the response to the browser. The administrator needs to edit the proxy servlet configuration file that specifies the white list of external sites and services using a standard text editor. This configuration file is named proxy-config.properties and is located in the \properties folder. The default file doesn’t permit proxying of any URLs.
The following are the parameters given in the proxy-config.properties file.
enabled -- Set to true to enable the proxy servlet.
connectTimeout -- Length of time to attempt a connection. (Default is 10 seconds)
Policyn.url -- Address of the site to which this policy (
n) applies.
Policyn.actions -- The set of HTTP methods that this policy (
n) allows.
Policyn.cookies -- Cookies that are allowed for this site. Cookies with specified names are always proxied to this site. In addition, any incoming (Set-Cookie response headers) received from this site are also remembered and eventually sent back on subsequent requests to this site. This parameter may be used with no value (
policyn.cookies=).
Policyn.headers -- Headers that are allowed for this site, either specific names or an asterisk to allow all. This attribute determines which headers are forwarded to the target server.
Policyn.mime-types -- Content types that are allowed back from the target server, either specific types or an asterisk to allow all.
The following code illustrates proxy-config.properties settings for a system where single sign-on is enabled for the Lotus Quickr and Lotus Domino servers.
enabled=true
connectTimeout=10
policy0.url=http://your_quickr_server:10038/
policy0.context=/xsp/proxy/QuickrProxy/
policy0.actions=GET,POST
policy0.cookies=LtpaToken
policy0.headers=*
policy0.mime-types=*
Administrators can monitor the proxy servlet by enabling Java™ logging. To monitor the proxy servlet, edit the \jvm\lib\logging.properties file to include how the logs should be formatted and what should be logged.
The following is an example of an edited logging.properties file.
#This example logs all the activities to a file specified using simple text format
handlers=java.util.logging.FileHandler,java.util.logging.ConsoleHandler
java.util.logging.FileHandler.pattern = c:\\domino\\log\\jdklog.txt
java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter
com.ibm.dwa.service.proxy.level = ALL
Configure Lotus Quickr settings
Lotus iNotes policy documents now contain a Lotus Quickr tab. The administrator can use this tab to force all Lotus iNotes attachments to be Lotus Quickr links, or prompt the user for instructions with each attachment. If the users are allowed to choose their own attachment preferences, no additional configuration by the administrator is required.
Before using the Lotus Quickr integration features from within Lotus iNotes for the first time, users must configure their personal integration settings, and supply a preferred Lotus Quickr place to store their file attachments.
1. Open the Lotus iNotes preferences, and select the Lotus Quickr tab.
2. Click
Add Places...
3. In the Add Place dialog window, enter the Lotus Quickr server address.
4. Click
Browse.
5. Select your preferred place.
6. Click
OK.
7. The preferred place you just specified will be listed in the Lotus Quickr Places list. The list can be adjusted by adding additional places or removing places that are no longer wanted, using the
Add Places... and
Remove buttons. When you are satisfied with the places included in the list, continue on to configure the email settings.
8. Select one of the following:
Send as normal to always send attachments with the messages.
Prompt me to decide on a case by case basis whether to send an attachment or a link to a file.
Always send links to always save the attachment to a Lotus Quickr place and include a link to the file in the message.
9. Specify one of the places in the above Lotus Quickr Places list as the default location for files. If you selected
Always send links the files will be stored in this place until you change it. If you selected
Prompt me you will be given the opportunity to change the file storage location each time you include an attachment in a message.
10. Save and exit your preferences.