Social Connections VI -- Customizing Connections Profiles to Provide a Company-Wide Who Is Who

© 2014 IBM Corporation

Martin Leyrer – IT-SpecialistIBM Software Services for Collaboration2014-06-17

Customizing Connections Profilesto provide a Company-Wide"Who is Who"

© 2014 IBM [email protected], IBM Software Services for Collaboration4/38


Legal Disclaimer

● © IBM Corporation 2014. All Rights Reserved.

● The information contained in this publication is provided for informational purposes only. While efforts were made to verify the completeness and accuracy of the information contained in this publication, it is provided AS IS without warranty of any kind, express or implied. In addition, this information is based on IBM’s current product plans and strategy, which are subject to change by IBM without notice. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, this publication or any other materials. Nothing contained in this publication is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software.

● References in this presentation to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in this presentation may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. Nothing contained in these materials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specific sales, revenue growth or other results.

● Performance is based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput or performance that any user will experience will vary depending upon many factors, including considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve results similar to those stated here.

● All customer examples described are presented as illustrations of how those customers have used IBM products and the results they may have achieved. Actual environmental costs and performance characteristics may vary by customer.

● IBM®, the IBM logo, Lotus®, Lotus Notes®, Notes®, Domino®, Quickr®, Sametime®, WebSphere®, UC2®, Connections, … are trademarks of International Business Machines Corporation in the United States, other countries, or both.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

● Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

● Intel, Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

● UNIX is a registered trademark of The Open Group in the United States and other countries.

● Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others.



Who Am I

Martin LeyrerIBM Collaboration Solutions (ICS, the brand formerly known as Lotus) IT-Specialist with IBM Austria

IBM e-mail: [email protected]

E-mail: [email protected]

Twitter: http://www.twitter.com/leyrer

Facebook: https://www.facebook.com/leyrer

Blog 1: http://www.leyon.at

LinkedIn: http://at.linkedin.com/in/leyrer

Xing: www.xing.com/profile/Martin_Leyrer

Martin LeyrerICS IT-Specialist

Mail: [email protected]: +43 664 618 6826



mailto:[email protected]


http://www.twitter.com/leyrer

https://www.facebook.com/leyrer

http://www.leyon.at/

http://at.linkedin.com/in/leyrer

https://www.xing.com/profile/Martin_Leyrer



The Who

● Existing Domino customer

● Already had a “Who is Who” application running– Based on Typo3– Static

– Centrally managed– Manually managed

– No Single Sign On (SSO)

● Looking for something “better”



Who Is Who

● Based on Connections entitlement– No additional SW cost for the customer

● Extends existing functionality with social functions

● Feed HR personnel data directly into the system

● Extend person data from other systems

● Integrate centrally managed employee photos (CI)

● SSO with Operating System (SPNEGO)









User Import – Custom Iterator



DIIOP Connector



Map Fields



Lookup Manager



Lookup Manager



Managing Errors



tdi-profiles-config.xml

● <profileExtensionAttributes>

● ...

● 

● 

● <simpleAttribute extensionId="twittername" length="256" sourceKey="twitter" />

● 

● </profileExtensionAttributes>



profiles-types.xml

● <type>

● ...

● 

● <property>

● <ref>twittername</ref>

● <updatability>readwrite</updatability>

● <hidden>false</hidden>

● </property>

● 

● </type>



Easy as 1-2-3

● Make sure you ALWAYS have at least a “$dn” field with the proper content

● The content of the “$dn” field must correspond to the name returned by LDAP

● Work Attributes can be referenced in map_dbrepos_from_source.properties

● Implement proper error handling



Photo Import – Assembly Line



Photo Import – Assembly Line



DIIOP



Input Mapping



Skip, Not Ignore



Accessing the File Data



Write Image to File



User Interface Adoptions

● Extension Attributes– tdi-profiles-config.xml– profiles-config.xml– profile-types.xml

● String Bundles– LotusConnections-config.xml

● Widgets– widgets-config.xml

● Freemarker Templates– profileDetails.ftl– profileEdit.ftl

– searchResults.ftl– businessCardInfo.ftl



CheckOut● cd C:\IBM\WebSphere\AppServer\profiles\ic-dmgr01\bin

● wsadmin.bat -lang jython -host ic-dmgr01.issc.local -username wasadmin -password passw0rd

● execfile("profilesAdmin.py")

● ProfilesConfigService.checkOutConfig("C:/IBM/tmp", "ic-cell")



C:/IBM/tmp/profiles-config.xml

● <profileExtensionAttributes>…<simpleAttribute extensionId="twittername" length="256" />

</profileExtensionAttributes>...

● Change <templateReloading>0</templateReloading> to <templateReloading>1</templateReloading>



C:/IBM/tmp/profileEdit.ftl

<@util.renderSection sectionLabel="contactInformation">

...

<@util.renderFormControl ref="blogUrl"singleColumnLayout=false nlsKey="label.blogUrl"/>

<#-- add one simple attribute START -->

<@util.renderFormControl ref="twittername"singleColumnLayout=false nlsKey="label.twittername"/>

<#-- add one simple attribute END -->

</@util.renderSection>



C:/IBM/tmp/profileDetails.ftl

<#-- add one simple attribute START -->

<@util.renderProperty ref="twittername"nlsKey="label.twittername" hideIfEmpty=false ;

ref, dataId, dataKey, nlsKey, nlsBundle>

<tr> <th scope="row"> <@util.renderNls nlsKey=nlsKey/> </th>

<td><p>

<@util.renderValue ref=ref renderAs="twittername"/>

</p></td>

</tr>

</@util.renderProperty>

<#-- add one simple attribute END -->



C:\IBM\tmp\profiles-types.xml<type>

...



<property>

<ref>twittername</ref>

<updatability>readwrite</updatability>

<hidden>false</hidden>

</property>



</type>



Labels● Extract from the installedApps/Profiles.ear/lc.profiles.app.war/WEB-

INF/lib/lc.profiles.web.app.jar:com/ibm/lconn/profiles/strings/ui.properties file the version of each resource file for each locale and save a copy for each locale like this:<IBM_Connections_Customization_Dir>/strings/com.ibm.lconn.profiles.strings.ui.properties

● com.ibm.lconn.profiles.strings.ui.properties# Label mod STARTlabel.twittername=Twitter Handle # Label mod END





Further Reading

● Connections Wiki: Developing custom Tivoli Directory Integrator assembly lines for Profiles– Setting up your development environment

– Using a custom source repository connector– Using the PhotoConnector

– https://ibm.biz/BdRWb7

● Connections Wiki: Creating a simple profile data model and template customization– https://ibm.biz/BdRWpE

https://ibm.biz/BdRWb7

https://ibm.biz/BdRWpE



Honorary Mention



Q & A

Martin LeyrerIBM Collaboration Solutions IT-Specialist with IBM Austria

IBM e-mail: [email protected]

E-mail: [email protected]

Twitter: http://www.twitter.com/leyrer

Facebook: https://www.facebook.com/leyrer

Blog: http://www.leyon.at

LinkedIn: http://at.linkedin.com/in/leyrer







http://www.twitter.com/leyrer

https://www.facebook.com/leyrer

http://www.leyon.at/

http://at.linkedin.com/in/leyrer

© IBM Corporation , IBM Software Services for Collaboration

Technology

Social Connections VI -- Customizing Connections Profiles to Provide a Company-Wide Who Is Who