Presentation given at ICONUK 2016-09-15 in London If you have tried to map a long office name and adress into the officeName of the PEOPLEDB, you probably stumbled upon the chapter "Supplemental user data for Profiles" in the IBM Connections documentation. What is described as "supplemental tables within the Profiles database" are in fact rather essential tables that can help you with adoption by providing more data within a users profile. Also, their use cuts down on the number of customizations needed as well as providing more information to the Cognos reports. I will talk you through the countries, departments, organization, enmployee and worklocation tables, how the can be filled with data either through csv files as well as custom assembly lines and how to reference them efficiently. Also we will take a look on what is necessary to expose the additional data in search, business cards and the profile pages. After this session you should be able to easily and quickly add more data to your IBM Connections profiles. Buzzword Bingo for this session: fill-scripts, profiles, tdi, csv workplace, address, department, reports, cognos, search.

1. ICONUK 2016
Martin Leyrer, IBM Austria
London, 2016-09-15
Feed me, Seymour!
Supplemental User Data For IC Profiles

2. Martin Leyrer - IBM
● IBM Collaboration Solutions IT-Specialist
with IBM Austria
● ICS product stack since 1995
● IBM e-mail: martin.leyrer@at.ibm.com
● E-mail: leyrer@gmail.com
● Twitter: http://www.twitter.com/leyrer
● Facebook:
https://www.facebook.com/leyrer
● Blog: http://www.leyon.at

3. Addresses

4. Easy, right?

5. IBM United Kingdom Limited
76/78 Upper Ground
South Bank
London SE1 9PZ
United Kingdom

6. IBM Österreich
Hauptverwaltung
Obere Donaustraße 95,
1020 Vienna
Vienna
Austria

7. IBM 中国有限公司
北京市朝阳区北四环中路 27 号盘古大观写字楼
25 层

8. Easy?

9. Addresses will have a reasonable
number of characters
Say less than 100.

10. Department For Environment Food & Rural
Affairs (D E F R A)
State Veterinary Service, Animal Health Office
Hadrian House, Wavell Drive
Rosehill Industrial Estate
Carlisle, CA1 2TB
United Kingdom

11. But street names will be reasonably short.
Certainly less than 50 characters

12. Bischöflich-Geistlicher-Rat-Josef-Zinnbauer-
Straße
84130 Dingolfing
Bavaria
Germany

13. Five lines and country will cover all cases.

14. GB Technical Services
Unit W7a
Warwick House
18 Forge Lane
Minworth Industrial Park
Minworth
Sutton Coldfield B76 1AH
United Kingdom

15. And what do we get in
IBM Connections
to cover all this?

16. CREATE TABLE EMPINST.EMPLOYEE (
...
PROF_PHYSICAL_DELIVERY_OFFICE
VARCHAR(32) ,
...

17. Technote #1698402
An enhancement request for increasing the limit
has been raised under APAR LO33688 for
development consideration for a future release.

18. Former Technote #1968915
db2 "ALTER TABLE EMPINST.EMPLOYEE
ALTER COLUMN
PROF_PHYSICAL_DELIVERY_OFFICE SET
DATA TYPE VARCHAR(64)"

19. We want
“an elegant weapon,
for a more civilized age.”

20. Supplemental User Data for Profiles

21. Countries
Work Locations
Organization
Departments

22. profiles_tdi.properties
country_table_csv_separator=;
country_table_csv_file=isocc.csv
department_table_csv_separator=;
department_table_csv_file=deptinfo.csv
organization_table_csv_separator=;
organization_table_csv_file=orginfo.csv
workloc_table_csv_separator=;
workloc_table_csv_file=workloc.csv

23. Countries

24. isocc.csv
...
gb;Great Britain
gd;Grenada
ge;Georgia
gf;French Guyana
gh;Ghana
gi;Gibraltar
gl;Greenland
...

25. ISO 3166-1 alpha-2

26. gb;Great Britain

27. gb;Great Britain
� Case Sensitve

28. gb;Great Britain
� Case Sensitve
� One Language Only

29. We Can make
issoc.csv
Great Again!

30. We Can make
issoc.csv
Great Again!
(partially)

31. Case Sensitivity

32. Directory

33. LDAP

34. map_dbrepos_from_source.properties
...
calendarUrl=null
countryCode=c
courtesyTitle=null
...

35. User Interface

36. profiles_functions.js
function func_country2lower(fieldname) {
var result = work.getString("c");
result = result.toLowerCase();
return result;
}

37. map_dbrepos_from_source.properties
...
calendarUrl=null
countryCode={func_country2lower}
courtesyTitle=null
...

39. Aaaaand ….

40. User Interface

41. Almost There!

42. fill_country.[bat|sh]

44. Aaaaand ….

45. User Interface

46. Work Location

47. workloc.csv
lookupcode;addr1;addr2;city;state;zip
007;"76/78 Upper Ground";"South
Bank";"Lambeth";"Greater London";”SE1 9PZ”
042;”Obere Donaustraße
95”;;”Vienna”;”Vienna”; “1020”

48. fill_workloc.[bat|sh]

51. Directory

52. LDAP

53. map_dbrepos_from_source.properties
...
uid={func_map_to_db_UID}
workLocationCode=location
# mode=
...

54. Aaaaand ….

55. User Interface

56. Almost There!

57. ProfileDetails.ftl
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="city"
nlsKey="label.workLocation.city" hideIfEmpty=true ;
ref, dataId, dataKey, nlsKey, nlsBundle>
…
</@util.renderProperty>
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="state"
nlsKey="label.workLocation.state" hideIfEmpty=true ;
ref, dataId, dataKey, nlsKey, nlsBundle>
...

58. ProfileDetails.ftl
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="address1"
nlsKey="label.workLocation.address1"
hideIfEmpty=true; ref, dataId, dataKey, nlsKey,nlsBundle>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>,
</@util.renderProperty>

59. ProfileDetails.ftl
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="address2"
nlsKey="label.workLocation.address2"
hideIfEmpty=true; ref, dataId, dataKey, nlsKey,nlsBundle>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>,
</@util.renderProperty>

60. ProfileDetails.ftl
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="postalCode"
nlsKey="label.workLocation.address1"
hideIfEmpty=true;
ref, dataId, dataKey, nlsKey, nlsBundle>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>
</@util.renderProperty>

61. Aaaaand ….

62. User Interface

63. Organization

64. orginfo.csv
lookupcode;name
23;"Chaos Computer Club"
23;"h2g2"
360;”IBM”
"RkReÜAÜG";"Rinderkennzeichnungs- und
Rindfleischetikettierungsüberwachungsaufgabe
nübertragungsgesetz"

65. fill_organization.[bat|sh]

68. Directory

69. LDAP

70. map_dbrepos_from_source.properties
...
nativeLastName=null
orgId=companyname
pagerNumber=null
...

71. Aaaaand ….

72. User Interface

73. Department

74. deptinfo.csv
lookupcode;name
42;"Local Planning Department, Subdivision
Alpha Centauri"
43;"Sirius Cybernetics Corporation Marketing
Department"

75. fill_department.[bat|sh]

78. Directory

79. LDAP

80. map_dbrepos_from_source.properties
...
courtesyTitle=null
deptNumber=department
description=null
...

81. Database

82. Aaaaand ….

83. User Interface

84. Almost There!

85. ProfileDetails.ftl
<@util.renderProperty ref="deptNumber" dataId="department"
dataKey="departmentTitle"
nlsKey="label.departmentDisplayValue" hideIfEmpty=true;
ref, dataId, dataKey, nlsKey, nlsBundle>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>
<br/>
</@util.renderProperty>

86. User Interface

87. Still not done

88. Although deptNumber is listed in the
documentation, the field is actually not
defined in profiles-types.xml.
=> It will never display on UI.

89. Profiles-type.xml
<property>
<ref>workLocationCode</ref>
<updatability>read</updatability>
<hidden>false</hidden>
</property>
<property>
<ref>deptNumber</ref>
<updatability>read</updatability>
<hidden>false</hidden>
</property>

90. User Interface

91. Business Card?

92. Almost There!

93. businessCardInfo.ftl
<@util.renderProperty ref="orgId" dataId="organization"
dataKey="organizationTitle" nlsKey="label.organizationTitle"
hideIfEmpty=true ; ref, dataId, dataKey, nlsKey, nlsBundle>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>,&nbsp;
</@util.renderProperty>

94. businessCardInfo.ftl
<@util.renderProperty ref="deptNumber"
dataId="department" dataKey="departmentTitle"
nlsKey="label.departmentDisplayValue" ; ref, dataId,
dataKey, nlsKey, nlsBundle>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>
<br/>
</@util.renderProperty>

95. businessCardInfo.ftl
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="address1"
nlsKey="label.workLocation.address1" hideIfEmpty=true ; ref,
dataId, dataKey, nlsKey, nlsBundle><@util.renderValue ref=ref
dataId=dataId dataKey=dataKey/>,</@util.renderProperty>
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="address2"
nlsKey="label.workLocation.address2" hideIfEmpty=true ; ref,
dataId, dataKey, nlsKey, nlsBundle><@util.renderValue ref=ref
dataId=dataId dataKey=dataKey/>,</@util.renderProperty>

96. businessCardInfo.ftl
<<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="postalCode"
nlsKey="label.workLocation.address1" hideIfEmpty=true ; ref,
dataId, dataKey, nlsKey, nlsBundle><@util.renderValue ref=ref
dataId=dataId dataKey=dataKey/></@util.renderProperty>

97. Business Card?

98. SEARCH

99. SearchResults.ftl
<@util.renderProperty ref="deptNumber"
dataId="department" dataKey="departmentTitle"
nlsKey="label.departmentDisplayValue" ; ref, dataId,
dataKey, nlsKey, nlsBundle>
<div class='bidiAware'>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>
</div>
</@util.renderProperty>

100. SearchResults.ftl
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="address1"
nlsKey="label.workLocation.address1"
hideIfEmpty=true ; ref, dataId, dataKey, nlsKey,
nlsBundle>
<div class='bidiAware'>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>,
</@util.renderProperty>

101. SearchResults.ftl
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="address2"
nlsKey="label.workLocation.address2"
hideIfEmpty=true ; ref, dataId, dataKey, nlsKey,
nlsBundle>
<div class='bidiAware'>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>,
</@util.renderProperty>

102. SearchResults.ftl
<@util.renderProperty ref="workLocationCode"
dataId="workLocation" dataKey="postalCode"
nlsKey="label.workLocation.address1" hideIfEmpty=true;
ref, dataId, dataKey, nlsKey, nlsBundle>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>
</@util.renderProperty>

103. SEARCH

104. METRICS

105. Mapping user profile attributes to report dimensions
<userAttributesMappings>
<!--
<mapping metricsName="attribute1"
profilesName="com.ibm.snx_profiles.base.countryCode"/>
<mapping metricsName="attribute2"
profilesName="com.ibm.snx_profiles.base.orgId"/>
<mapping metricsName="attribute3"
profilesName="com.ibm.snx_profiles.base.title"/>
-->
<mapping metricsName="attribute1"
profilesName="com.ibm.snx_profiles.base.countryCode"/>
<mapping metricsName="attribute2"
profilesName="com.ibm.snx_profiles.base.workLocationCode"/>
<mapping metricsName="attribute3"
profilesName="com.ibm.snx_profiles.ext.customAttribute"/>
</userAttributesMappings>

106. Tools

107. Codes Connector

109. Sync

110. profiles-config.xml
<templateReloading>5</templateReloading>

111. PITFALLS

112. Draw a Blank

113. Draw a Blank in ProfileDetails.ftl
<@util.renderProperty ...>
<@util.renderValue ref=ref dataId=dataId
dataKey=dataKey/>,
</@util.renderProperty>

114. Draw a Blank

115. Search vs. Search

116. No Customization in “Search All Content → Limit to Profiles”

117. Questions?
117
Martin Leyrer
IT-Specialist at IBM Austria
E-mail: martin.leyrer@at.ibm.com
Twitter: http://www.twitter.com/leyrer
FB: https://www.facebook.com/leyrer
Blog: http://www.leyon.at
Slideshare:
http://www.slideshare.net/Martin.Leyrer

118. Links
● Falsehoods programmers believe about addresses:
https://www.mjt.me.uk/posts/falsehoods-programmers-believe-about-addresses/
● Country Codes - ISO 3166: http://www.iso.org/iso/country_codes
● Customizing Profiles:
http://www.ibm.com/support/knowledgecenter/SSYGQH_5.5.0/admin/customize/c_admin
_profiles_customizing.html
● CodesConnector:
http://www.ibm.com/support/knowledgecenter/en/SSYGQH_5.5.0/admin/admin/t_admin_
profiles_using_codes_connector.html
● Technote #1698402: Some users cannot be populated as
PROF_PHYSICAL_DELIVERY_OFFICE limited to 32 characters: http://www-
01.ibm.com/support/docview.wss?uid=swg21698402

119. Links
● Supplemental user data for Profiles
http://www.ibm.com/support/knowledgecenter/SSYGQH_5.5.0/admin/install/r_prof_fill-
tables.html
● Mapping user profile attributes to report dimensions
http://www.ibm.com/support/knowledgecenter/SSYGQH_5.5.0/admin/admin/t_admin_met
rics_mng_map_report.html