Integrating Profiles with Lotus Quickr

You can configure the LotusConnections-config.xml file to include a link to IBM® Lotus® Quickr® on the Profiles business card. Users can then click the Quickr link in another person's business card to open that person's personal file library in Lotus Quickr.

Before you begin

For related information about Lotus Quickr integration, see IBM Connections Connector for Lotus Quickr and the following Lotus Quickr product documentation topics:

Note: For the Connections business card to appear in Lotus Quickr, you must complete the steps in the following topics on your Lotus Quickr server as well as the steps outlined in this document:

See Enabling Lotus Connections features in Lotus Quickr for information about integration with IBM Lotus Quickr for Domino®.
See Integrating with Lotus Connections Profiles business card for information about integration with IBM Lotus Quickr for WebSphere® Portal.

Note: In previous releases, you could configure the LotusConnections-config.xml file to include a link to Lotus Quickr on the Profiles business card. Users could then click the Quickr link in another person's business card to open that person's personal file library in Lotus Quickr. This configuration is not available in Quickr Domino 8.5 or later, which no longer supports the Quickr Entry Place feature.

To find out what versions of Lotus Quickr are supported, see Detailed system requirements for IBM Connections.
For Lotus Quickr for Lotus Domino, when you add a Quickr link to the Profiles business card in a Lotus Quickr for Lotus Domino deployment, the link only works with Entry places. The link does not work with regular places. The Lotus Quickr Domino administrator must run the qptool to create Entry places for users on the server; users cannot create Entry places for themselves. For information about how to create Lotus Quickr entry places, go to: http://publib.boulder.ibm.com/infocenter/lqkrdom/v8/index.jsp?topic=/com.ibm.lotus.quickr.dominov82.doc/config/qp_inst_entry_create_places.html
Note: Quickr Domino 8.5 and later no longer supports the Quickr Entry Place feature.
Note: When adding a Quickr link to the business card, if you have enabled SSL in IBM Connections by setting forceconfidentialcommunication to true in the LotusConnections-config.xml file, you should also enable SSL on the Lotus Quickr server so that the link will work when users access IBM Connections using HTTPS.
To edit configuration files, you must use the wsadmin client. See Starting the wsadmin client for information about how to start the wsadmin tool.

About this task

The Profiles business card serves as an interface that other applications can leverage to integrate with IBM Connections. You can enable integration with Lotus Quickr in the business cards by enabling a service reference to the LotusConnections-config.xml file. Users can then click the Quickr link in another person's business card to access that person's public files and the files that they've shared with the user in Lotus Quickr.

Procedure

To enable a Lotus Quickr link on the business card, complete the following steps.

Start the wsadmin client from the following directory of the system on which you installed the Deployment Manager:
```
app_server_root\profiles\dm_profile_root\bin
```
where app_server_root is the WebSphere Application Server installation directory and dm_profile_root is the Deployment Manager profile directory, typically dmgr01.
You must start the client from this directory or subsequent commands that you enter do not execute correctly.
Use the wsadmin client to access and check out the IBM Connections configuration files.
1. Enter the following command to load the IBM Connections configuration file: execfile("connectionsConfig.py")
  
  If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, you must select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.
2. Enter the following command to check out IBM Connections configuration files:
  LCConfigService.checkOutConfig("working_directory","cell_name")
  where:
  - working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.
    Notes:
    
    When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory. For example: "C:/temp".
    
    AIX, and Linux only: The directory must grant write permissions or the command fails.
  - cell_name is the name of the WebSphere Application Server cell that hosts the IBM Connections application. If you do not know the cell name, display it by typing the following command in the wsadmin client: print AdminControl.getCell()
    Note: This input parameter is case-sensitive.
Open the LotusConnections-config.xml file with a text editor and search for the following entry:
```
<sloc:serviceReference enabled="false"
					person_card_service_name_js_eval="generalrs.label_personcard_quickrlink" 
      			person_card_service_url_pattern="/allfiles/people/{email}" 
      			serviceName="quickr" ssl_enabled="false">
       <sloc:href>
           <sloc:hrefPathPrefix>/places</sloc:hrefPathPrefix> 
           <sloc:static href="admin_replace" ssl_href="admin_replace"/>
           <sloc:interService href="admin_replace"/>
       </sloc:href>
   </sloc:serviceReference> 
```
Enable the Quickr service reference in the file by adding the Quickr server host name, and setting enabled and ssl_enabled to true as in the following steps:
1. Change enabled="false" to enabled="true".
2. Change ssl_enabled="false"> to ssl_enabled="true">.
3. Change <sloc:static href="admin_replace" to <sloc:static href="http://quickrServer.mycompany.com:port".
4. Change ssl_href="admin_replace"/> to ssl_href="https://quickrServer.mycompany.com:port"/>.
5. Change <sloc:interService href="admin_replace"/> to <sloc:interService href="https://quickrServer.mycompany.com:port"/>
Note: Step c. specifies http while steps d. and e. specify https.
- Lotus Quickr for Lotus Domino: No additional changes to the LotusConnections-config.xml file are required.
  Note: This configuration is not available in Quickr Domino 8.5 or later, which no longer supports the Quickr Entry Place feature.
- Lotus Quickr for WebSphere Portal: Make the following additional change to the LotusConnections-config.xml file:
  1. Change person_card_service_url_pattern="/allfiles/people/{email}" to person_card_service_url_pattern="/search?#owner={userid}|{displayName}".
After making these changes, check the configuration files back in during the same wsadmin session in which you checked them out. See Applying common configuration property changes for information about how to save and apply your changes.