Preparing Profiles for Touchpoint

Before installing, from the temporary location that holds the Touchpoint installation package, you must edit configuration files in the package and then use these files to modify the TDI synchronization settings.

Extending Profiles configuration attributes

Checking out the Profiles configuration puts several files on the local system, including profile-config.xml and profiles-types.xml. Edit profile-config.xml to extend attributes and then add the attributes to each declared profile in profiles-types.xml.

Procedure

  1. From the command prompt, go to the directory where the Deployment Manager is installed and start the wasadmin client.
  2. Check out the configuration files to the temporary location that you downloaded Touchpoint to.
  3. Run the following command to start the Profiles administration script: 
    execfile("profilesAdmin.py")
ProfilesConfigService.checkOutConfig("working_directory", "cell_name")
    Example: ProfilesConfigService.checkOutConfig("/opt/my_temp_dir", AdminControl.getCell())
  4. Back up the file profile-config.xml, as in the following examples:.

    Linux: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/connectionsCell/LotusConnections-config/profile-config.xml

    Windows: C:\Program Files (x86)\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\win16008Cell01\LotusConnections-config\profiles-config.xml

  5. Open the file in edit mode, and then add the following lines to the section for <profileExtensionsAttributes>: 
    <!-- START IBM Connections Touchpoint -->
<simpleAttribute extensionId="recommendedTags" length="256" sourceKey="recommendedTags" />
<simpleAttribute extensionId="departmentKey" length="256" sourceKey="departmentKey" />
<simpleAttribute extensionId="privacyAndGuidelines" length="256" sourceKey="privacyAndGuidelines" />
<simpleAttribute extensionId="touchpointState" length="256" sourceKey="touchpointState" /> <richtextAttribute
extensionId="touchpointSession" maxBytes="1000000" sourceKey="touchpointSession" />
<!-- END IBM Connections Touchpoint -->
  6. Locate the following line and make sure that the value is set to true. Change the value if necessary: 
    <!-- variable full text index -->
<property name="com.ibm.lconn.profiles.config.variableFullTextIndexEnabled" value="true"/>
  7. Save profile-config.xml.
  8. Now, back up the file profiles-types.xml as in the following examples:

    Linux: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/connectionsCell/LotusConnections-config/profile-type.xml

    Windows: C:\Program Files (x86)\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\win16008Cell01\LotusConnections-config\profiles-types.xml

  9. Open the file in edit mode and apply the following lines from <install-package>/LotusConnections-config/profiles-types.xml to the section for <type> : 
    <!-- START IBM Connections Touchpoint -->
<property>
	<ref>recommendedTags</ref>
	<updatability>readwrite</updatability>
	<hidden>true</hidden>
	<fullTextIndexed>false</fullTextIndexed>
</property>
<property>
	<ref>departmentKey</ref>
	<updatability>read</updatability>
	<hidden>true</hidden>
	<fullTextIndexed>true</fullTextIndexed>
</property>
<property>
	<ref>privacyAndGuidelines</ref>
	<updatability>readwrite</updatability>
	<hidden>true</hidden>
	<fullTextIndexed>false</fullTextIndexed>
</property>
<property>
	<ref>touchpointState</ref>
	<updatability>readwrite</updatability>
	<hidden>true</hidden>
	<fullTextIndexed>false</fullTextIndexed>
</property>
<property>
	<ref>touchpointSession</ref>
	<updatability>readwrite</updatability>
	<hidden>true</hidden>
	<fullTextIndexed>false</fullTextIndexed>
</property>
<!-- END IBM Connections Touchpoint -->
  10. Save profiles-types.xml.

Checking in Profiles configuration files

After you add the Touchpoint attributes to each declared profile in profile-types.xml, check in the configuration files.

Procedure

  1. Check in the changes by running the following command: ProfilesConfigService.checkInConfig()
  2. Make sure that you see the message "Profiles configuration files successfully checked in."

Modifying TDI synchronization settings

Modify TDI synchronization settings to reflect the profile changes for Touchpoint.

About this task

The files that are included in Touchpoint contain only the additions needed for Touchpoint integration, so all additions in those files must be merged into the files from Profiles within the wizards.

Procedure

  1. In the TDI LotusConnections-config folder (for example,/opt/ibm/connections/Wizards/TDIPopulation/linux/TDI/conf/LotusConnections-config), find the tdi-profiles-config.xml file. Merge the extension attributes from install-package/TDI/conf/LotusConnections-config/tdi-profiles-config.xml into the node profileExtensionAttributes.
  2. In the TDI root folder (for example, /opt/ibm/connections/Wizards/TDIPopulation/linux/TDI), find map_dbrepos_from_source.properties. Merge the properties from install-package/TDI/map_dbrepos_from_source.properties into map_dbrepos_from_source.properties at the end.
    Note: The commented line #extattr.touchpointState = {func_setTouchpointStateComplete} is used as an example. You don't need to add it when you install.
  3. In the TDI root folder (for example, /opt/ibm/connections/Wizards/TDIPopulation/linux/TDI), find profiles_functions.js. Merge the functions from install-package/TDI/profiles_functions.js into profiles_functions.js at the end.