Customizing IBM Connections Profile Labels

Customizing IBM Connections 3.x labels is pretty easy, you just have to create a properties file, store your customized labels in it and place this file inside your <customization_dir>/strings directory:
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_product_strings_ic301
Customizing the profile labels on my installation unfortunately did not work although mentioned on wiki page (com.ibm.lconn.profiles.strings.ui_xx, com.ibm.lconn.profiles.strings.uilabels_xx).
So I had to find a workaround by using an external resource bundle and use it in my profiles. This needs more than one properties file but is still pretty easy. In this example I will reuse a given profile field (pagerNumber) and will add a customized label to it.

1. Create a properties file for each language you are using inside your strings directory -> I’m using com.belsoft.profiles.strings.uilabels_xx.properties

property file

2. Add the key-value pair for the string that you want to customize (for each language) and save the file

key pair

3. Add your external resource bundle to LotusConnections-config.xml by checking out the config and adding some lines:

cd D:\IBM\WebSphere\AppServer\profiles\Dmgr01\bin
wsadmin.bat -lang jython -port 8879
execfile(“connectionsConfig.py”)
LCConfigService.checkOutConfig(“D:/temp”,”BSAZ-ZHRU-VSV04Cell01″)

Command check out

Open LotusConnections-config.xml and add your widgetBundle inside the resource tag, you have to use your property file name as widgetbundle name:

<widgetBundle name=”com.belsoft.profiles.strings.uilabels” prefix=”belsoft”/>

201107111343.jpg

Check in your changes:

LCConfigService.checkInConfig(“D:/temp”,”BSAZ-ZHRU-VSV04Cell01″)

201107111351.jpg

4. Now we have to use the new labels inside the profiles:

execfile(“profilesAdmin.py”)
ProfilesConfigService.checkOutConfig(“D:/temp”,”BSAZ-ZHRU-VSV04Cell01″)

201107111404.jpg

Open profiles-config.xml and change the line for attribute pagerNumber (bundeleIdRef has to be the prefix of your added widgetBundle!):

<editableAttribute labelKey=”label.belsoft.privateMobileNumber” bundleIdRef=”belsoft” showLabel=”true” hideIfEmpty=”true”>pagerNumber</editableAttribute>

201107111402.jpg

Check in your changes:

ProfilesConfigService.checkInConfig(“D:/temp”,”BSAZ-ZHRU-VSV04Cell01″)

201107111407.jpg

  

5. Last step is to update your versionStamp and sync all your nodes:

execfile(“connectionsConfig.py”)
LCConfigService.checkOutConfig(“D:/temp”,”BSAZ-ZHRU-VSV04Cell01″)
LCConfigService.updateConfig(“versionStamp”,””)
LCConfigService.checkInConfig(“D:/temp”,”BSAZ-ZHRU-VSV04Cell01″)
synchAllNodes()
exit

201107111424.jpg

   

After a restart of your profiles server you should see the new label on your profiles page:

201107111412.jpg

Comments

cmathefr
Reply

Works perfect ! Thanks for this … very useful

Markku Hänninen
Reply

Hi

I was wondering if you have any knowledge of Connections 4 and editing these fields. Connections 4 changed these configurations to totally different ones and now i’m unable to change the built-in field names. It is now easier to make extensions, but i have totally hit wall trying to change the built-in field names like “Name:” in connections profiles.

Any tips would be greatly appreciated

Markku Hänninen

Leave a Reply

%d bloggers like this: