Make Your IBM Connections
Deployment Your Own: Customize
It!
Wannes Rams
Wannes Rams - wannes@ramsit.com
Introduction
About Wannes Rams
wannes.rams.be
twitter.com/wannesrams
linkedin.com/in/wannesrams
http://slideshare.com/palm...
About this Presentation
http://www.slideshare.net/palmke/show301-make-your-ibm-connections-
deployment-your-owncustomize-
...
About my co-speaker
Wannes Rams - wannes@ramsit.com
Agenda in Orlando
• Introduction
• User Interface
• Login Page
• Notifications
• Getting Started Page
• Communities
• Wiki...
Todays agenda
• Introduction
• User Interface
• Login Page
• Notifications
• Getting Started Page
• Communities
• Wikis
• ...
So, who are you?
Wannes Rams - wannes@ramsit.com
Introduction
Our environment
• Microsoft Windows Server 2008 R2
• IBM Connections 4.5 CR3 (IBM Domino LDAP, single
box ins...
Introduction
Remarks
 We use following abbreviations:
–custom_dir: Customization directory, check the WebSphere variable
...
Notifications – Example
Custom colors, logoChanged
sender
Custom
text
Wannes Rams - wannes@ramsit.com
Notifications – Example
Change default weekly
newsletters to daily
Wannes Rams - wannes@ramsit.com
Notifications – How to
Change Text
 Open following folder:
profiles_dirDmgr01configcellsconnectionsCell01LotusConnections...
Notifications – How to
Change Text
• Open notification(_en).properties in the resourcesnls folder
Wannes Rams - wannes@ram...
Notifications – How to
Change Text
• Change the text IBM Connections to IBM Connect 14
• Do the same for each language fil...
Notifications – How to
Change Text
 Go back to the notifications folder and now open the notification(_en).properties
in ...
Notifications – How to
Change Logo and Colors
 Go back to the notifications folder and now open the style.ftl in newsaggr...
Notifications – How to
Change Logo and Colors
 Change the referenced footer image from ibmLogoWhite23.png to ibmconnect.p...
Notifications – How to
Change Logo and Colors
 Go back to notification and copy ibmconnect.png to resourcesimages
Wannes ...
Notifications – How to
Change Logo and Colors
 Open WAS Administrative Console and navigate to „Applications – WebSphere
...
Notifications – How to
Change Default Notifications Settings
 Start the wsadmin client and execute connectionsConfig.py
...
Notifications – How to
Change Default Notifications Settings
 Open notification-config.xml in D:temp
 Change properties ...
Notifications – How to
Change Default Notifications Settings
 Change all defaultFollowFrequency="WEEKLY” to defaultFollow...
Notifications – How to
Change Default Notifications Settings
 Close the file and check it in
LCConfigService.checkInNotif...
Notifications – How to
Change Default Notifications Settings
 Run following command to refresh the default Email settings...
Notifications – Result
Change Default Notifications Settings
 Check the new settings in the browser by resetting to defau...
Notifications – Result
Change Logo and Colors
 You can trigger the email digests by accessing the following URL to verify...
Notifications – Result
Change Logo and Colors
 Check Newsletters in your mail client (Desktop and Mobile)
Mail on Mobile
...
Notifications – Resources
 Customizing notifications
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_notifications_...
Profiles – Introduction
Add profile types
• In this part we will add a second profile type. This profile type will
contain...
Profiles – Example
Add profile types
Wannes Rams - wannes@ramsit.com
Profiles – How To
Add profile types
 First thing we need to decide is what field in LDAP will define the profile type.
In...
Profiles – How To
Add profile types
 Now run your TDI sync command
 This is what you will see in the Employee database
W...
Profiles – How To
Add profile types
 Start the wsadmin client and execute profilesAdmin.py
 Check out the profiles-confi...
Profiles – How To
Add profile types
 We need to define the profile types and the profile fields we want to show in the fi...
Profiles – How To
Add profile types
Wannes Rams - wannes@ramsit.com
Profiles – How To
Add profile types
 We can now disable profile features or widgets based on the profile type. We will st...
Profiles – How To
Add profile types
• Check in the profiles configuration
ProfilesConfigService.checkInConfig()
Wannes Ram...
Profiles – How To
Add profile types
 Open WAS Administrative Console and navigate to “Applications – WebSphere
enterprise...
Profiles – How To
Add profile types
• Login with the external user
Tagging
enabled
when
logged on
as
external
user
No Twit...
Profiles – Result
Logged in with internal user
Tagging disabled No invitation
button Disabled
Wannes Rams - wannes@ramsit....
Profiles – How To
Add profile types
 We will now disable widgets based on the profile type
 Check out the widget configu...
Profiles – How To
Add profile types
• Check in the widget configuration again and restart the profiles application
Wannes ...
Profiles – Result
Add profile types
Tags and sand gone
Tabs gone All widgets gone
except links
Wannes Rams - wannes@ramsit...
Profiles – Resources
 Adding custom widgets to Profiles
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Adding_custom_widgets_t...
Profiles – Resources
 Customizing Profiles
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_Profiles_ic45
 Phasing ...
Profiles – Introduction
Widget
 In this part we will add a custom google widget to profiles:
– Create widget
– Add widget...
Profiles – Example
Widget
Office
address
displayed on
Google
Maps
Wannes Rams - wannes@ramsit.com
Profiles – How to
Widget
 Create your widget called googleMap.xml in custom_dirprofiles
Wannes Rams - wannes@ramsit.com
Profiles – How to
Widget
Wannes Rams - wannes@ramsit.com
Profiles – How to
Widget
Wannes Rams - wannes@ramsit.com
Profiles – How to
Widget
 Now we add the widget to our Connections profiles, start the wsadmin client and
execute profile...
Profiles – How to
Widget
 Open widgets-config.xml in D:temp
 Add your new widget
Wannes Rams - wannes@ramsit.com
Profiles – How to
Widget
 Check in widgets-config.xml
ProfilesConfigService.checkInWidgetConfig()
Wannes Rams - wannes@ra...
Profiles – How to
Widget
 Open WAS Administrative Console and navigate to “Applications – WebSphere
enterprise applicatio...
Profiles – Result
Widget
 Open a profile and test your widget
Wannes Rams - wannes@ramsit.com
Login Page – Introduction
 In this part we will:
– Add a disclaimer to the login page
Wannes Rams - wannes@ramsit.com
Login Page – Example
Wannes Rams - wannes@ramsit.com
Login Page – How to
Alter the login.jsp
 We need to change login.jsp. To do that copy
profiles_dir/AppSrv01/installedApps...
Login Page – How to
Alter the login.jsp
 With the following code to add the agreement text and agreement button
Wannes Ra...
Login Page – How to
Alter the login.jsp
 Next thing is to change the loginbutton to make it disabled and assign an id for...
Login Page – How to
Add Javascript
 Now we need to add a small piece of javascript to detect if the agreement was
accepte...
Login Page – How to
Add property file(s)
 Last step is to add the property files that contain the actual text. To do so a...
Login Page – How to
 Open WAS Administrative Console and navigate to „Applications – WebSphere
enterprise applications“
...
Login Page – Result
 Refresh your browser
Wannes Rams - wannes@ramsit.com
Login Page – Resources
 Customizing IBM Lotus Connections 3.0
http://public.dhe.ibm.com/software/dw/lotus/LC30CustomizeFi...
Further examples
Wannes Rams - wannes@ramsit.com
Further examples
Wannes Rams - wannes@ramsit.com
Questions?
Wannes Rams - wannes@ramsit.com
Thanks
wannes.rams.be
twitter.com/wannesrams
linkedin.com/in/wannesrams
http://slideshare.com/palmke
Wannes Rams - wannes@...
Upcoming SlideShare
Loading in …5
×

Make your ibm connections deployment your own, customize it!

881 views

Published on

BM Connections offers a lot of customization possibilities to enable you to have the platform comply to your corporate standards or exhaustive needs. In this session we will explore all customization options available and will show you examples on customizations on UI, notifications, profiles, Richtext Editor, metric reports and more. This will allow you to better decide what you want to customize and should offer you a technical starting point for your own customizations

Published in: Technology

Make your ibm connections deployment your own, customize it!

  1. 1. Make Your IBM Connections Deployment Your Own: Customize It! Wannes Rams
  2. 2. Wannes Rams - wannes@ramsit.com
  3. 3. Introduction About Wannes Rams wannes.rams.be twitter.com/wannesrams linkedin.com/in/wannesrams http://slideshare.com/palmke Wannes Rams - wannes@ramsit.com
  4. 4. About this Presentation http://www.slideshare.net/palmke/show301-make-your-ibm-connections- deployment-your-owncustomize- it-30628456 Wannes Rams - wannes@ramsit.com
  5. 5. About my co-speaker Wannes Rams - wannes@ramsit.com
  6. 6. Agenda in Orlando • Introduction • User Interface • Login Page • Notifications • Getting Started Page • Communities • Wikis • Profiles • Richtext Editor • Media Gallery Object Types • Mobile App • Reports • Desktop Plugin • IBM Connections Content Manager Wannes Rams - wannes@ramsit.com
  7. 7. Todays agenda • Introduction • User Interface • Login Page • Notifications • Getting Started Page • Communities • Wikis • Profiles • Richtext Editor • Media Gallery Object Types • Mobile App • Reports • Desktop Plugin • IBM Connections Content Manager • Introduction • Notifications • Profile Types • Profile widgets • Login Page Wannes Rams - wannes@ramsit.com
  8. 8. So, who are you? Wannes Rams - wannes@ramsit.com
  9. 9. Introduction Our environment • Microsoft Windows Server 2008 R2 • IBM Connections 4.5 CR3 (IBM Domino LDAP, single box installation) • CONNECTIONS_CUSTOMIZATION_DEBUG enabled • Next Generation Theme • Profile templateReloading in profiles-config.xmlset to 15 secs • Login credentials stored in soap.client.properties -> Always disable debug & reloading settings in production! Wannes Rams - wannes@ramsit.com
  10. 10. Introduction Remarks  We use following abbreviations: –custom_dir: Customization directory, check the WebSphere variable CONNECTIONS_CUSTOMIZATION_PATH (here D:IBMConnectionsdatasharedcustomization ) –provision_dir: Provision directory, check the WebSphere variable CONNECTIONS_PROVISION_PATH (here D:IBMConnectionsdatasharedprovision) –profiles_dir: WebSphere profiles directory (here D:IBMWebSphereAppServerprofiles) –htdocs: HTTP Server htdocs directory (here D:IBMHTTPServerhtdocs) Wannes Rams - wannes@ramsit.com
  11. 11. Notifications – Example Custom colors, logoChanged sender Custom text Wannes Rams - wannes@ramsit.com
  12. 12. Notifications – Example Change default weekly newsletters to daily Wannes Rams - wannes@ramsit.com
  13. 13. Notifications – How to Change Text  Open following folder: profiles_dirDmgr01configcellsconnectionsCell01LotusConnections- confignotifications  Here you can find the source files for all the different notifications Wannes Rams - wannes@ramsit.com
  14. 14. Notifications – How to Change Text • Open notification(_en).properties in the resourcesnls folder Wannes Rams - wannes@ramsit.com
  15. 15. Notifications – How to Change Text • Change the text IBM Connections to IBM Connect 14 • Do the same for each language file which you want to use Wannes Rams - wannes@ramsit.com
  16. 16. Notifications – How to Change Text  Go back to the notifications folder and now open the notification(_en).properties in newsresourcesnls  Change every occurrence of IBM Connections to IBM Connect 14 Wannes Rams - wannes@ramsit.com
  17. 17. Notifications – How to Change Logo and Colors  Go back to the notifications folder and now open the style.ftl in newsaggregated  Change every occurrence of color #474747 to #025d9c Wannes Rams - wannes@ramsit.com
  18. 18. Notifications – How to Change Logo and Colors  Change the referenced footer image from ibmLogoWhite23.png to ibmconnect.png Wannes Rams - wannes@ramsit.com
  19. 19. Notifications – How to Change Logo and Colors  Go back to notification and copy ibmconnect.png to resourcesimages Wannes Rams - wannes@ramsit.com
  20. 20. Notifications – How to Change Logo and Colors  Open WAS Administrative Console and navigate to „Applications – WebSphere enterprise applications“  Stop an Start the News App Wannes Rams - wannes@ramsit.com
  21. 21. Notifications – How to Change Default Notifications Settings  Start the wsadmin client and execute connectionsConfig.py  Check out the notification-config.xml LCConfigService.checkOutNotificationConfig('D:/temp','connectionsCell01’) Wannes Rams - wannes@ramsit.com
  22. 22. Notifications – How to Change Default Notifications Settings  Open notification-config.xml in D:temp  Change properties for sender and mobile links Wannes Rams - wannes@ramsit.com
  23. 23. Notifications – How to Change Default Notifications Settings  Change all defaultFollowFrequency="WEEKLY” to defaultFollowFrequency=”DAILY" Wannes Rams - wannes@ramsit.com
  24. 24. Notifications – How to Change Default Notifications Settings  Close the file and check it in LCConfigService.checkInNotificationConfig()  Execute newsAdmin.py Wannes Rams - wannes@ramsit.com
  25. 25. Notifications – How to Change Default Notifications Settings  Run following command to refresh the default Email settings: NewsEmailDigestService.refreshDefaultEmailPrefsFromConfig() Wannes Rams - wannes@ramsit.com
  26. 26. Notifications – Result Change Default Notifications Settings  Check the new settings in the browser by resetting to default notifications settings Wannes Rams - wannes@ramsit.com
  27. 27. Notifications – Result Change Logo and Colors  You can trigger the email digests by accessing the following URL to verify your settings (admin will only receive digest) http://connections.snt.com/news/web/testEmailDigestSendMail.action?type=daily  Or for all users http://connections.snt.com/news/web/testEmailDigestSendMail.action?type=daily&initNextTranche=t rue Wannes Rams - wannes@ramsit.com
  28. 28. Notifications – Result Change Logo and Colors  Check Newsletters in your mail client (Desktop and Mobile) Mail on Mobile Wannes Rams - wannes@ramsit.com
  29. 29. Notifications – Resources  Customizing notifications http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_notifications_ic45  Including mobile links in notifications http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Including_mobile_links_in_notifications_ic45  Setting the default frequency of email digests http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Setting_the_default_frequency_of_email_digests_ic45  Verifying email digests http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Verifying_email_digests_ic45 Wannes Rams - wannes@ramsit.com
  30. 30. Profiles – Introduction Add profile types • In this part we will add a second profile type. This profile type will contain only a subset of the profile attributes that the default profile will have. We will also disable widgets based on the profile • What are profile types – Definition of different types of users – Allows to change look and feel of the profiles application – Example: customer, employee, contractor • Why use profile types – Show different data for different types of users – Block certain features – Block built in widgets – Block custom widgets – Limit information stream – Phase a rollout Wannes Rams - wannes@ramsit.com
  31. 31. Profiles – Example Add profile types Wannes Rams - wannes@ramsit.com
  32. 32. Profiles – How To Add profile types  First thing we need to decide is what field in LDAP will define the profile type. In this example we will use an existing field that is not used for anything else  Now we need to configure TDI to add the profile type to the Profiles database. Alter the map_dbrepos_from_source.properties file in your TDI Solution directory and map profileType to your field in LDAP Wannes Rams - wannes@ramsit.com
  33. 33. Profiles – How To Add profile types  Now run your TDI sync command  This is what you will see in the Employee database Wannes Rams - wannes@ramsit.com
  34. 34. Profiles – How To Add profile types  Start the wsadmin client and execute profilesAdmin.py  Check out the profiles-config.xml ProfilesConfigService.checkOutConfig('D:/temp','connectionsCell01’) Wannes Rams - wannes@ramsit.com
  35. 35. Profiles – How To Add profile types  We need to define the profile types and the profile fields we want to show in the file profiles-types.xml Wannes Rams - wannes@ramsit.com
  36. 36. Profiles – How To Add profile types Wannes Rams - wannes@ramsit.com
  37. 37. Profiles – How To Add profile types  We can now disable profile features or widgets based on the profile type. We will start with the profile features  Open profiles-policy.xml and add the desired configuration Wannes Rams - wannes@ramsit.com
  38. 38. Profiles – How To Add profile types • Check in the profiles configuration ProfilesConfigService.checkInConfig() Wannes Rams - wannes@ramsit.com
  39. 39. Profiles – How To Add profile types  Open WAS Administrative Console and navigate to “Applications – WebSphere enterprise applications”  Stop and Start the Profiles App Wannes Rams - wannes@ramsit.com
  40. 40. Profiles – How To Add profile types • Login with the external user Tagging enabled when logged on as external user No Twitter Id Wannes Rams - wannes@ramsit.com
  41. 41. Profiles – Result Logged in with internal user Tagging disabled No invitation button Disabled Wannes Rams - wannes@ramsit.com
  42. 42. Profiles – How To Add profile types  We will now disable widgets based on the profile type  Check out the widget configuration.  Disable the widgets you don’t want to show in widgets-config.xml Wannes Rams - wannes@ramsit.com
  43. 43. Profiles – How To Add profile types • Check in the widget configuration again and restart the profiles application Wannes Rams - wannes@ramsit.com
  44. 44. Profiles – Result Add profile types Tags and sand gone Tabs gone All widgets gone except links Wannes Rams - wannes@ramsit.com
  45. 45. Profiles – Resources  Adding custom widgets to Profiles http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Adding_custom_widgets_to_Profiles_ic45  Customizing IBM Connections – Modifying the Report-To Chain iWidget to include profile data retrieved via Ajax (Hunter Medney) https://www.ibm.com/developerworks/community/blogs/hmedney/entry/customizing_co nnections_modifying_the_report_to_chain_widget_using_profile_data  Connections iWidget Development Guide http://www-10.lotus.com/ldd/lcwiki.nsf/dx/development-guide  Easy as a pie – Creating Widgets for IBM Connections (Mikkel Heisterberg) http://www.slideshare.net/lekkim/bp207-easy-as-pie-creating-widgets-for-ibm- connections  Customizing IBM Connections 4.0 Profiles http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_IBM_Connections_4.0_Profiles Wannes Rams - wannes@ramsit.com
  46. 46. Profiles – Resources  Customizing Profiles http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_Profiles_ic45  Phasing an IBM Connections Rollout? Profile Types May Be the Answer https://www- 304.ibm.com/connections/blogs/socialbusiness/entry/phasing_an_ibm_connections_roll out_profile_types_may_be_the_answer4  Profile types and locking profile features http://www.slideshare.net/palmke/profile-types-and-locking-profile-features-15498931 Wannes Rams - wannes@ramsit.com
  47. 47. Profiles – Introduction Widget  In this part we will add a custom google widget to profiles: – Create widget – Add widget Wannes Rams - wannes@ramsit.com
  48. 48. Profiles – Example Widget Office address displayed on Google Maps Wannes Rams - wannes@ramsit.com
  49. 49. Profiles – How to Widget  Create your widget called googleMap.xml in custom_dirprofiles Wannes Rams - wannes@ramsit.com
  50. 50. Profiles – How to Widget Wannes Rams - wannes@ramsit.com
  51. 51. Profiles – How to Widget Wannes Rams - wannes@ramsit.com
  52. 52. Profiles – How to Widget  Now we add the widget to our Connections profiles, start the wsadmin client and execute profilesAdmin.py  Check out the widgets-config.xml ProfilesConfigService.checkOutWidgetConfig('D:/temp','connectionsCell01') Wannes Rams - wannes@ramsit.com
  53. 53. Profiles – How to Widget  Open widgets-config.xml in D:temp  Add your new widget Wannes Rams - wannes@ramsit.com
  54. 54. Profiles – How to Widget  Check in widgets-config.xml ProfilesConfigService.checkInWidgetConfig() Wannes Rams - wannes@ramsit.com
  55. 55. Profiles – How to Widget  Open WAS Administrative Console and navigate to “Applications – WebSphere enterprise applications”  Stop and Start the Profiles App Wannes Rams - wannes@ramsit.com
  56. 56. Profiles – Result Widget  Open a profile and test your widget Wannes Rams - wannes@ramsit.com
  57. 57. Login Page – Introduction  In this part we will: – Add a disclaimer to the login page Wannes Rams - wannes@ramsit.com
  58. 58. Login Page – Example Wannes Rams - wannes@ramsit.com
  59. 59. Login Page – How to Alter the login.jsp  We need to change login.jsp. To do that copy profiles_dir/AppSrv01/installedApps/connectionsCell01/Blogs.ear/blogs.war/ nav/templates/login.jsp to custom_dircommonnavtemplates  Replace the following part Wannes Rams - wannes@ramsit.com
  60. 60. Login Page – How to Alter the login.jsp  With the following code to add the agreement text and agreement button Wannes Rams - wannes@ramsit.com
  61. 61. Login Page – How to Alter the login.jsp  Next thing is to change the loginbutton to make it disabled and assign an id for reference in our javascript. Change this code  With this Wannes Rams - wannes@ramsit.com
  62. 62. Login Page – How to Add Javascript  Now we need to add a small piece of javascript to detect if the agreement was accepted to change the login button to enabled  To do this add following javascript to the script section of the file Wannes Rams - wannes@ramsit.com
  63. 63. Login Page – How to Add property file(s)  Last step is to add the property files that contain the actual text. To do so add a new file to custom_dirstrings  Name the file com.ibm.lconn.core.strings.templates.properties  You can add files for other languages if you have a multi-language deployment Wannes Rams - wannes@ramsit.com
  64. 64. Login Page – How to  Open WAS Administrative Console and navigate to „Applications – WebSphere enterprise applications“  Stop and Start the Common and Homepage App Wannes Rams - wannes@ramsit.com
  65. 65. Login Page – Result  Refresh your browser Wannes Rams - wannes@ramsit.com
  66. 66. Login Page – Resources  Customizing IBM Lotus Connections 3.0 http://public.dhe.ibm.com/software/dw/lotus/LC30CustomizeFinal.pdf Wannes Rams - wannes@ramsit.com
  67. 67. Further examples Wannes Rams - wannes@ramsit.com
  68. 68. Further examples Wannes Rams - wannes@ramsit.com
  69. 69. Questions? Wannes Rams - wannes@ramsit.com
  70. 70. Thanks wannes.rams.be twitter.com/wannesrams linkedin.com/in/wannesrams http://slideshare.com/palmke Wannes Rams - wannes@ramsit.com wannes@ramsit.com

×