Transcript
Page 1: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Author: Paul GodbyBusiness Development & ISVsLast Updated: June 19, 2015Duration: 60 minutes

IBM Connections

Lab Manual

Profiles Customization

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

1

Page 2: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Introduction:In IBM Connections, you have the ability to customize the Profiles application. This allows you to define the core data model for people within your deployment and tailor the presentation of Profiles content to meet your organization's requirements. You can populate the Profiles database with data from external systems and configure Profiles to display this data. You also have the ability to create Profile Types. So, for example, you could create a different layout for different types of employees in the organization.

Generally speaking, you will first want to populate the Profiles database with your custom user data. You do this by modifying existing TDI scripts to import extra data from your current directories or by creating new scripts to import data from other systems. This data will get added to a special “extensions” table in the Profiles database and will link to each user via his/her internal IBM Connections ID.

After you import custom data, you must then customize the Profiles data model. This is an easy process that involves referencing the new data in your Profiles database in the Profiles XML configuration file.

After you've defined your new data in Profiles, you can then go about the process of updating the user interface by making changes to the supplied template files. You can choose to modify the set of standard and extension attributes that are rendered in the user interface for a profile record. You can also modify the structure of the layout of content using the flexibility provided by the FreeMarker Template Language.

After you create your new user interface in the, you might also need to update the Profiles widget configuration file to display the content from the template file. For example, if you want this data to appear in a new tab, you will need to define that new tab in the widget XML configuration file.

Description:IBM Connections Profiles has always supported customization of a Profile's layout in the web application using a widget-based model. In recent releases, the Profiles user interface supports an additional level of customization via a set of presentation templates that can be modified by the administrator to meet a diverse set of customization requirements.

By leveraging a template language, administrators are able to support a more dynamic level of customization than what was offered in the past via static XML configuration. Templates support dynamic reloading so customizations are easier to develop and, as a result, the deployment of a customized Profiles component is faster to realize.

Objective:This lab will explain the following tasks:

• How to populate the Profiles database with custom extension data using TDI

• How to use a strings properties file to provide user interface labels for your new data

• How to add the new extension data to the Profiles application

• How to display the new extension data in the Profiles application

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

2

Page 3: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Procedure:BEFORE YOU BEGIN

Step 1 Workshop: This lab exercise was originally created as part of the following workshop. At the end of this document you will find instructions and links for accessing the materials.

IBM Connections 5.0 Customization Workshop

Step 2 Prerequisites: You must complete the following labs before proceeding with this exercise:

There are no prerequisite labs.

Step 3 Solutions Files: This lab may require additional files. If you are asked to write code or configure an XML file, there may be snippets available for you to review or copy/paste text to/from your lab environment. These files are located at:

/labs/solutions/ess.ui.profiles

Step 4 Important! Review the workshop setup document for instructions on configuring the SoftLayerdevice for this lab. You should also review the information about user accounts and permissions. The lab instructions will assume you are using the proper user account(s)!

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

3

Page 4: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

REVIEW THE DEFAULT USER INTERFACE IN PROFILES

Before you start making changes to the Profiles application, you should review the defaultinterface. This will allow you to better visualize and plan your upcoming changes.

Step 5 In a web browser, navigate to URL:

https://<<Host Name>>/profiles/html/myProfileView.do

Step 6 Log in with the following credentials

Field Value

User name dmisawa

Password passw0rd

Step 7 By default, you should see a Recent Updates, Contact Information, and Background tab.

Step 8 Click the Contact Information tab.

Step 9 In this environment, there are not many attributes populated, configured, and shown. In this lab, you will add a new entry to the Contact Information tab. You will also add an additional tabto show information about the user's identify in other social networks.

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

4

Page 5: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 10 Locate the current user's name and hover over it with your cursor:

Step 11 When you hover over the name, the business card should appear:

Step 12 As you can see, the default business card contains a limited set of information. In this lab, you will learn how to add additional metadata to the card.

Step 13 Leave the browser open and proceed to the next section.

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

5

Page 6: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

POPULATE THE PROFILES DATABASE WITH EXTENSION DATA

Before you customize Profiles, you first need to identify the source of the new data. This newdata can come from any source or could be some additional fields in your LDAP directory.Regardless of the source, you will need to populate the Profiles database with this new datausing Tivoli Directory Integrator.

To map custom extension attributes to fields in your source LDAP directory, configuresettings in the tdi-profiles-config.xml file for each custom extension attribute.

Step 14 You will need to update the TDI Profiles configuration file to add your new extensions to the data model. Using your favorite text editor, open file

tdi-profiles-config.xml

from location

/opt/IBM/TDI/V7.1.1/TDISOL/TDI/conf/LotusConnections-config

Step 15 In the profileExtensionAttributes section, add the following extension. In later steps, you will add this extension to the Contact Information tab in the Profiles user interface. A description of the XML elements can be found in the table:

<simpleAttribute extensionId="location" length="64" sourceKey="l" />

Attribute Value

extensionId Internal ID for identifying this extension in other configuration areas

length The number of bytes to allocate in the Profiles database

sourceKey The LDAP attribute that maps to this extension

Step 16 In the profileExtensionAttributes section, add the following extensions. In later steps, you will add these extensions to a new tab in the Profiles user interface:

Note: In this lab environment, there currently are NO attributes in LDAP for external socialservices. To simulate the process, you will instead just be inserting seemingly randomLDAP attributes into these fields. Thank you for your understanding :)

<simpleAttribute extensionId="facebook" length="64" sourceKey="cn" />

<simpleAttribute extensionId="google" length="64" sourceKey="sn" />

<simpleAttribute extensionId="twitter" length="64" sourceKey="uid" />

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

6

Page 7: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 17 When finished, your XML file should contain the following lines inside the profileextensionattributes tags.

Step 18 Save and close the file. Close the text editor.

Step 19 Next, you must also update the TDI profiles types configuration in order for all of the data to properly propagate to the Profiles database. From the same location as before, open file

profiles-types.xml

Step 20 As you can see, this XML is just a big list of properties indicating which Profiles data is available to the current profile type, whether it is editable, and whether or not it is hidden. Scrolldown to the bottom and add the following additional properties.

<property><ref>location</ref><updatability>read</updatability><hidden>false</hidden>

</property><property>

<ref>google</ref><updatability>read</updatability><hidden>false</hidden>

</property><property>

<ref>facebook</ref><updatability>read</updatability><hidden>false</hidden>

</property><property>

<ref>twitter</ref><updatability>read</updatability><hidden>false</hidden>

</property>

Step 21 Save and close the file. Close the text editor.

Step 22 Open a terminal window. Run the following commands to synchronize LDAP data into the Profiles database. The synchronization process will recognize your new extensions and populate this new data into Profiles.

cd /opt/IBM/TDI/V7.1.1/TDISOL/TDI

./sync_all_dns.sh

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

7

Page 8: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 23 After the script completes, you should receive a message that records were modified.

CREATE A STRINGS RESOURCE BUNDLE

As of right now, everything is mapped to internal keys. You will want to provide some userfriendly labels in the Connections interface for these new extensions. You can do this bycreating a new strings properties file.

Step 24 Create a new properties file named

ess.profiles.properties

in location

/opt/IBM/Connections/data/shared/customization/strings

Step 25 In this new file, enter the following lines. As you can see, you will be providing a label for each of your new extensions. While you're at it, you will also enter a key-value pair that will be used to provide text for a new tab in the Profiles interface.

essSocialServices=Social Serviceslabel.location=Location:label.facebook=Facebook:label.google=Google+:label.twitter=Twitter:

Step 26 Save the file but do not close it (yet!). You just created the default properties file. In a production environment, you will need to create additional properties files for each supported language. You can do this by creating a new strings file (in the same directory) with the language code appended to the name. In this example, you can create a new strings properties file for the English language by creating a new file named:

ess.profiles_en.properties

Step 27 Save and close the file(s). Close the text editor.

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

8

Page 9: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

REGISTER THE STRINGS RESOURCE BUNDLE

Now that you've created a strings resource bundle, you must make IBM Connections awareof it's existence by registering the new bundle in LotusConnections-config.xml.

Step 28 The wsadmin tool is a command shell for the purpose of performing systems administration on all the artifacts in an IBM WebSphere Application Server (WAS) cell. In a terminal window, enter the following commands to start the wsadmin tool.

mkdir /config

cd /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin

./wsadmin.sh -lang jython -user wasadmin -password iBmC0nn3ti0ns

Step 29 Next, store references to your IBM Connections configuration environment in a few variables. By storing these values in variables, you can easily reference them in subsequent wsadmin commands. In the wsadmin session, enter the following commands:

path = "/config"

cell = AdminControl.getCell()

Step 30 Now that your session is configured, check out the Connections configuration file with the following commands:

execfile("connectionsConfig.py")

LCConfigService.checkOutConfig(path, cell)

Step 31 Leave the terminal window with your existing wsadmin session open. Open another terminal window and enter the following commands to make a backup of the original file(s). At the end of this lab, you will use this backup to restore your configuration to it's original state.

cp /config/LotusConnections-config.xml /config/LotusConnections-config.xml.bak

Step 32 Edit the checked out configuration file named:

/config/LotusConnections-config.xml

Step 33 Search for the following keyword(s) to locate the appropriate section:

<resources>

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

9

Page 10: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 34 In this section, you will need to add your new strings bundle. Enter the following XML fragmentbetween the resources tags. Refer to the table below for a description of the elements.

Note: You may see additional widgetBundles. If so, leave them there!

<widgetBundle name="ess.profiles" prefix="essProfExt" />

Attributes Value

name The name of the properties file, minus the extension

prefix Internal unique ID you will reference elsewhere in the configuration

Step 35 Save and close the file. Close the text editor.

Step 36 Return to the terminal window with your existing wsadmin session. Check in your changes with the wsadmin tool using the following command:

LCConfigService.checkInConfig(path, cell)

Step 37 Leave this terminal window open. In the future, it will be referred to as the “profiles” terminal.

Tip: From the terminal file menu, you can choose Terminal → Set Title to rename the window.This should help you keep track of the various terminal windows in the future.

Step 38 Proceed to the next section.

ENABLE CUSTOM EXTENSIONS IN PROFILES

Now that you have extension data in the Profiles database, you must make the Profilesapplication aware of it's existence! All custom extensions will need to be added to theprofiles-config.xml file.

Step 39 Return to the “profiles” terminal window and the existing wsadmin session. Enter the following commands to check out the Profiles configuration files:

execfile("profilesAdmin.py")

ProfilesConfigService.checkOutConfig(path, cell)

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

10

Page 11: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 40 Leave the terminal window with your existing wsadmin session open. Open another terminal window and enter the following commands to make a backup of the original file(s). At the end of this lab, you will use this backup to restore your configuration to it's original state.

cp /config/profiles-config.xml /config/profiles-config.xml.bak

cp /config/profiles-types.xml /config/profiles-types.xml.bak

cp /config/profileDetails.ftl /config/profileDetails.ftl.bak

cp /config/businessCardInfo.ftl /config/businessCardInfo.ftl.bak

Step 41 Leave the terminal window with your wsadmin session open. Edit the checked out configuration file named:

/config/profiles-config.xml

Step 42 Search for the following keyword(s) to locate the appropriate section:

profileExtensionAttributes

Step 43 In the profileExtensionAttributes section, add the following extensions. Notice that they correspond to the entries you used earlier in tdi-profiles-config.xml.

<simpleAttribute extensionId="location" length="64" sourceKey="l" />

<simpleAttribute extensionId="facebook" length="64" sourceKey="cn" />

<simpleAttribute extensionId="google" length="64" sourceKey="sn" />

<simpleAttribute extensionId="twitter" length="64" sourceKey="uid" />

Step 44 When finished, your XML file should contain the following lines inside the profileextensionattributes tags.

Step 45 Next, you will need to make Profiles aware of your custom resource bundle and that it should be used in the layout templates. In an earlier step, you registered this new bundle with IBM Connections and gave it a unique prefix (id). You will use this prefix to reference the bundle.

Step 46 Search for the following keyword(s) to locate the appropriate section:

templateNlsBundles

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

11

Page 12: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 47 This XML element expects a space-delimited list of resource bundles. Add your resource bundle by adding it's prefix ID:

essProfExt

Step 48 Search for the following keyword(s) to locate the appropriate section:

businessCardInfo

Step 49 In this section, you can control what data is displayed in the business card. As you can see, there are a few default entries that can be omitted or added to the card by commenting / uncommenting XML as appropriate. For example, the template should load "codes" to bring in the workLocation, organization, and department information. In this lab walkthrough, you will be adding Profiles extensions, so uncomment the line for extensions. When finished, the XML should look as follows:

Step 50 Save and close the file. Close the text editor.

Step 51 At this point, you might be tempted to check in your configuration changes.... Don't do it! You still need to modify some additional files that were checked out with the previous command. Leave the wsadmin session running and proceed to the next section.

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

12

Page 13: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

ADD EXTENSION PROPERTIES TO A PROFILE TYPE

A profile-type defines a set of properties, also referred to as a schema, that are inherent to allprofiles of that type. This set of properties is used internally to group objects and enforceoverall system constraints.

You can create mutliple profiles types. For example, you might create profile types forcustomer, employee, and contractor. This would allow you to specificy specific attributesand user interfaces for the different profile types.

Step 52 Edit the checked out configuration file named:

/config/profiles-types.xml

Step 53 As you can see, this XML is just a big list of properties indicating which Profiles data is available to the current profile type, whether it is editable, and whether or not it is hidden. Scroll down to the bottom and add the following additional properties.

<property><ref>location</ref><updatability>read</updatability><hidden>false</hidden>

<fullTextIndexed>false</fullTextIndexed></property><property>

<ref>facebook</ref><updatability>read</updatability><hidden>false</hidden>

<fullTextIndexed>false</fullTextIndexed></property><property>

<ref>google</ref><updatability>read</updatability><hidden>false</hidden>

<fullTextIndexed>false</fullTextIndexed></property><property>

<ref>twitter</ref><updatability>read</updatability><hidden>false</hidden>

<fullTextIndexed>false</fullTextIndexed></property>

Step 54 Save and close the file. Close the text editor.

Step 55 Proceed to the next section.

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

13

Page 14: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

ADD EXTENSIONS TO THE PROFILES USER INTERFACE

Finally, now that the data is ready, you can add your new extension elements to the Profilesuser interface. You do this by adding/removing entries in the profileDetails.ftl FreeMarkertemplate file.

By default, this file contains the layouts for 3 sections of the Profile:

jobInformation = main profile page data section

contactInformation = Contact Information tab

associatedInformation = background widget data

Step 56 Edit the checked out configuration file named:

/config/profileDetails.ftl

Step 57 Search for the following keyword(s) to locate the appropriate section:

sectionLabel="contactInformation"

Step 58 You are now at the layout section for the Contact Information tab.

Step 59 Scroll down to the end of this section. Alternatively, you can search from here for:

@util.renderSection

Step 60 At the bottom of this section, add one of your new custom extensions with the following code fragment. The “ref” attribute refers to your extension. The “nlsKey” attribute refers to the key to use in the properties file to find the user friendly string. The "nlsBundle" attribute refers to the custom strings bundle you created in an earlier step.

Note: Feel free to make this easier by copying / pasting an existing entry and modifyingaccordingly.

Note: Make sure your new extension is added BEFORE the ending tbody, table, and divtags! They are quite easy to overlook!!!

<@util.renderProperty ref="location" nlsBundle="essProfExt" nlsKey="label.location" hideIfEmpty=true ; ref, dataId, dataKey, nlsKey, nlsBundle>

<tr><th scope="row"><@util.renderNls nlsBundle=nlsBundle nlsKey=nlsKey/></th><td><p><@util.renderValue ref=ref/></p></td>

</tr></@util.renderProperty>

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

14

Page 15: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 61 Now that you have added an attribute to the existing Contact Information tab, you will want to create a new layout for your new Social Services tab! At the bottom of the file, add a new @util.renderSection with the following code fragment:

<@util.renderSection sectionLabel="essSocialServices"><div class="lotusSectionBody"><table class="lotusVertTable"><tbody>

<@util.renderProperty ref="facebook" nlsBundle="essProfExt" nlsKey="label.facebook" hideIfEmpty=true; ref, dataId, dataKey, nlsKey, nlsBundle>

<tr><th scope="row"><@util.renderNls nlsBundle=nlsBundle nlsKey=nlsKey/></th><td><p><@util.renderValue ref=ref/></p></td>

</tr> </@util.renderProperty> <@util.renderProperty ref="google" nlsBundle="essProfExt" nlsKey="label.google" hideIfEmpty=true; ref, dataId, dataKey, nlsKey, nlsBundle>

<tr><th scope="row"><@util.renderNls nlsBundle=nlsBundle nlsKey=nlsKey/></th><td><p><@util.renderValue ref=ref/></p></td>

</tr> </@util.renderProperty>

<@util.renderProperty ref="twitter" nlsBundle="essProfExt" nlsKey="label.twitter" hideIfEmpty=true; ref, dataId, dataKey, nlsKey, nlsBundle>

<tr><th scope="row"><@util.renderNls nlsBundle=nlsBundle nlsKey=nlsKey/></th><td><p><@util.renderValue ref=ref/></p></td>

</tr> </@util.renderProperty>

</tbody></table></div>

</@util.renderSection>

Step 62 Save and close the file. Close the text editor.

Step 63 Edit the checked out configuration file named:

/config/businessCardInfo.ftl

Step 64 As you can see, this template file contains all of the data that should be displayed in the defaultbusiness card. At the very bottom of the file, you should see an entry for the "email" attribute. Scroll down to the bottom of this entry. Since we will be adding extension data to the card, andwe want it to appear at the bottom in the user interface, the extensions will be added underneath the existing "email" entry.

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

15

Page 16: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 65 Below the "email" entry, add the following definitions for your custom extensions.

Note: Feel free to make this easier by copying / pasting an existing entry andmodifying accordingly.

<@util.renderProperty ref="location" nlsBundle="essProfExt" nlsKey="label.location" hideIfEmpty=true; ref, dataId, dataKey, nlsKey, nlsBundle>

<p><@util.renderValue ref=ref/></p> </@util.renderProperty> Step 66 Save and close the file. Close the text editor.

Step 67 You are finally done with the changes from the current set of checked out files. Now, you mustcheck back in your changes. Return to the “profiles” terminal window and the already existing wsadmin session. Enter the following commands:

ProfilesConfigService.checkInConfig(path, cell)

Step 68 Leave the terminal window open and your wsadmin session running.

Step 69 Proceed to the next section.

ADD EXTENSIONS TO PROFILES APPLICATION

In this section, you must update the Profiles section of widgets-config.xml to make your newcustom tab visible to the end user.

Step 70 Return to the “profiles” terminal window and the already existing wsadmin session. Enter the following commands to check out the Profiles configuration file:

ProfilesConfigService.checkOutWidgetConfig(path, cell)

Step 71 Leave the terminal window with your existing wsadmin session open. Open another terminal window and enter the following commands to make a backup of the original file(s). At the end of this lab, you will use this backup to restore your configuration to it's original state.

cp /config/widgets-config.xml /config/widgets-config.xml.bak

Step 72 Edit the checked out configuration file named:

/config/widgets-config.xml

Step 73 Search for the following keyword(s) to locate the appropriate section:

resource type="profile"

Step 74 From this location, search again for the following keyword(s) to locate the appropriate section:

</definitions>

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

16

Page 17: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 75 You should now be at the end of the Profiles widget definitions section.

Step 76 Add the following widget definition before the ending “definitions” tag. In the itemSet, there is an item that will reference the new layout you entered in the profileDetails.ftl file.

<widgetDef defId="essSocialServices" bundleRefId="essProfExt" modes="view fullpage"url="{contextRoot}/widget-catalog/profile-details.xml?version={version}"

helpLink="{helpSvcRef}/topic/com.ibm.lotus.connections.profiles.help/c_pers_profiles.html" ><itemSet>

<item name="section" value="essSocialServices" /></itemSet>

</widgetDef>

Attributes Value

defId The unique ID of the widget referenced elsewhere in the configurationNote: Also corresponds to the key to use in the strings properties file

bundleRefId The unique ID of the string resource bundle to use

Step 77 Right below the Profiles widget definitions section, you will find the Profiles layout section. In this section, you will find various pages. In the page with a pageId of "profilesView", add a newwidgetInstance that references the widget you just defined, to the tabs in the Profiles UI.

Tip: In all layout sections like this, the order the widgets are listed is the order they willappear in the page.

<widgetInstance uiLocation="tabsWidget1" defIdRef="essSocialServices"/>

Step 78 When finished, this section should look as follows:

Step 79 Save and close the file. Close the text editor.

Step 80 Return to the “profiles” terminal window and the already existing wsadmin session. Enter the following commands:

ProfilesConfigService.checkInWidgetConfig(path, cell)

Step 81 Leave this terminal window open and proceed to the next section.

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

17

Page 18: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

RESTART THE PROFILES APPLICATION

Now that your changes are complete, you must restart applications and synchronize thenodes. This will allow you to see your new changes in the IBM Connections user interface.

Step 82 In order for your changes to take effect, you must synchronize the nodes. We have created some scripts to automate this process for you. In a new terminal window, enter the following commands to synchronize the nodes and update the IBM Connections timestamp.

cd /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin

./wsadmin.sh -lang jython -user wasadmin -password iBmC0nn3ti0ns -f /scripts/connections/synchNodes.py

Note: You can review the commands executed by the script(s) above by opening thereferenced script(s) in a text editor.

Step 83 In order for your changes to take effect, you must restart the affected applications. We have created some scripts to automate this process for you. In the existing terminal window, enter the following commands to restart the Profiles and Common applications.

./wsadmin.sh -lang jython -user wasadmin -password iBmC0nn3ti0ns -f /scripts/was/restartApp.py Profiles Common

Note: You can review the commands executed by the script(s) above by opening thereferenced script(s) in a text editor.

Step 84 Proceed to the next section.

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

18

Page 19: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

VIEW YOUR CUSTOM EXTENSIONS IN PROFILES

Now that all of that work has been done, it's time to view the results!

Note: If you do not see the changes in the following steps, clear the browser cache.

Step 85 Return to the web browser and refresh the page. You should be on the profile page for user Dan Misawa. If the session has timed out, you may need to log in again.

Step 86 Click the Contact Information tab. You should see your new extension and label in the page!

Step 87 Click the Social Services tab. You should see your new extensions and labels in the page! And there should be new custom data from the Profiles database!

Reminder: We used a random set of LDAP attributes for the sample data used to illustratethe concepts behind Profiles customization.

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

19

Page 20: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Step 88 Hover over Dan Misawa's name. If everything went according to plan, you should see the new "location" extension in the business card!

Step 89 You're done!

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

20

Page 21: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

(OPTIONAL) RESTORE THE DEFAULT CONFIGURATION

If you want to restore the configuration to it's original state, complete the following steps.

Step 90 Return to the "profiles" terminal window and your existing wsadmin session. Enter the following commands to check out all of the configuration files modified in this lab:

LCConfigService.checkOutConfig(path, cell)

ProfilesConfigService.checkOutConfig(path, cell)

ProfilesConfigService.checkOutWidgetConfig(path, cell)

Step 91 Leave the terminal window with your existing wsadmin session open. Open another terminal window and enter the following commands to restore your backups:

cd /config

mv -f LotusConnections-config.xml.bak LotusConnections-config.xml

mv -f profiles-config.xml.bak profiles-config.xml

mv -f profiles-types.xml.bak profiles-types.xml

mv -f profileDetails.ftl.bak profileDetails.ftl

mv -f businessCardInfo.ftl.bak businessCardInfo.ftl

mv -f widgets-config.xml.bak widgets-config.xml

Step 92 Return to the “profiles” terminal window. Check in your changes with the following commands:

LCConfigService.checkInConfig(path, cell)

ProfilesConfigService.checkInConfig(path, cell)

ProfilesConfigService.checkInWidgetConfig(path, cell)

quit

Step 93 In a new terminal window, restart the affected applications with the following commands:

cd /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin

./wsadmin.sh -lang jython -user wasadmin -password iBmC0nn3ti0ns -f /scripts/connections/synchNodes.py

./wsadmin.sh -lang jython -user wasadmin -password iBmC0nn3ti0ns -f /scripts/was/restartApp.py Mobile Common

Step 94 Return to your web browser and refresh the page. You should see the default Profiles user interface restored!

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

21

Page 22: IBM Connections 5.0: Profiles Customization

IBM Connections 5.0

Summary:

In this lab, you learned how to add new data to the Profiles database and display it in thedefault Profiles user interface. Congratulations!

Next Steps:Access FREE education on the IBM Collaboration Solutions portfolio of products today!

1. Visit the IBM Greenhouse and create a free account.

Link → http://greenhouse.lotus.com/

2. Visit the IBM Collaboration Solutions Ecosystem Development Community

Link → https://greenhouse.lotus.com/communities/community/icsecod

3. Learn new skills and share these links with your friends and colleagues!

COPYRIGHT IBM CORPORATION 2015. ALL RIGHTS RESERVED.

22


Recommended