HCL Connections Newsletter v2 and Join Community requests

· by Christoph Stoettner · Read in about 3 min · (467 words)

Since IBM Connections 6.0CR4 we can use a new newsletter format which needs still (now with HCL Connections 7) be activated separately in LotusConnections-config/notification-config.xml.

Today some users asked how they can add other users to their private communities (visible in Community catalog) without manually adding them. As we investigated the question I had a look at the old notification format. So there a community owner got following e-mail when a user requested to join:

request community join old

So he could directly add the requesting user to the community.

Now we switched to the new v2 format and the mail looks like this:

request community join

So the "Add Member" link disappeared. So what happens when we use "Open"? Yes it opens the community and I can’t see any link or option where I can answer these requests within the community. This was the reason for the users question, because they added the requesters manually with "Add member".

Which other options does the user have to add the requesting members?

Notification Bell

request community join notificationbell

There they get the information about the request, but clicking on the notification opens the Community and as we already know: you can’t see the request there.

Action Required

The only way to say and click the "Add member" link is "Action Required" in the old Homepage (sorry, but I haven’t deployed Orient Me until now, so I don’t know if you see it there).

request community join action required

Workaround

So how can we get the link "Add Member" into the notification email again?

LotusConnections-config/notifications_v2/communities/requestToJoinMail.ftl
27 <#-- Default 'Open' Action -->
28 <#assign defaultAction = comUrlUtil.linkifyContainer(community.url, comUtil.resource('OPEN_LINK_TEXT'), {}, comStyleUtil.actionArgs) />
29
30 <#-- Actions -->
31 <#assign actions = [ defaultAction ] />
32
33 <#-- Deprecated Actions -->
34 <#-- comUrlUtil.linkifyContainer(community.url, comUtil.resource("email.open.community")) -->
35 <#-- comUrlUtil.linkifySpecial(comUrlUtil.LINK_ID.COMMUNITIES.MEMBERS, community.members.url, comUtil.resource("email.add.this.person")) -->  (1)
1Deprecated Action "email.add.this.person" let’s check this
27 <#-- Default 'Open' Action -->
28 <#assign defaultAction = comUrlUtil.linkifyContainer(community.url, comUtil.resource('OPEN_LINK_TEXT'), {}, comStyleUtil.actionArgs) />
29
30 <#-- Actions -->
31 <#assign actions = [
32         comUrlUtil.linkifySpecial(comUrlUtil.LINK_ID.COMMUNITIES.MEMBERS, community.members.url, comUtil.resource("email.add.this.person"), comStyleUtil.actionArgs),   (1)
33         defaultAction ] />
34
35 <#-- Deprecated Actions -->
36 <#-- comUrlUtil.linkifyContainer(community.url, comUtil.resource("email.open.community")) -->
37 <#-- comUrlUtil.linkifySpecial(comUrlUtil.LINK_ID.COMMUNITIES.MEMBERS, community.members.url, comUtil.resource("email.add.this.person")) -->
1Copy the line to the actions, remove the comment signs and add , comStyleUtil.actionArgs) into the function, this adds the same styles as for "Open"

When we synchronize the nodes and restart the news application we get following notification:

request community join new tweaked

So we got back some usability, but in my opinion I miss a view in each Community to see the "Join Requests" like the view "Invitations" in the members widget.

community members invitations

Summary

All tests were made in HCL Connections 7 installed with Connections-Automation Ansible repository. I doublechecked and the error/missing link appeared already with Connections 6.5 (no newer version to check).