Monday, September 09, 2013

Developing Social Rendering Lists

I started to pull together a static post about modifying a Social Rendering list, but the post was becoming unruly. With a special thank you to Matt Dull who graciously acted as my editor, we proudly present a video instead.

Be kind... this is my first video endeavor on my Mac.

Thursday, September 05, 2013

Dressing Up Connections - Social Rendering

I recently worked on a project where we had to service two different user types with one deployment of Connections.  The customer had extensive UI and feature changes for the smaller of the two groups of users.  To achieve this goal, I decided to solve their particular challenge with Social Rendering and API portlets to develop the extranet UX and enable the internal users to use Connections virtually out-of-the-box.

Social Rendering is a feature of Portal / WCM released with the update.  It enables developers and integrators to surface lists of Connections content using WCM conventions (presentation template, authoring template, PZN & HTML components, piece of content, and a web content portlet) and then quickly or easily modify the UI to match the Portal design.  This is a significant enhancement to the traditional pattern of developing API portlets to do this very task because the API query is built for you in the piece of content that represents your list.  It also separates the design from the logic so that when making edits or changes to the HTML components for UI changes, there is no risk of ruining the business logic behind the list.
*NOTE* As of the time of this writing, the default behavior of Social Rendering is not real time.  It operates on a delay of ~15 minutes do to the architecture.  Workarounds may be employed, but to do so there may be harmful side effects.  Tuning and optimization of Social Rendering is not going to be covered in this post.
The first step for our team, however, was to get our arms around Social Rending.  How does it work?  What are the pieces and parts we need?  Which component in WCM do I use to control which aspect of this solution?  These answers were critical to our success and once we realized how these pieces all fit together, the flexibility that it truly affords, the possibilities became numerous quite quickly.  As is often the case, I wanted to capture these important points of information somewhere and my blog is the place for such things so I can refer back later and maybe even a few others will learn from my struggles as well.

Once you install Portal and make sure the features are all enabled, a series of portlets will now be available to be added to your Portal pages.  These portlets are all lists of something, such as the "List of Blogs" portlet.  These are all special instances of a web content portlet preconfigured to also setup a piece of content that represents a search against Connections.  Staying with the List of Blogs example, this particular list should display all of the blog posts that the current user has access to.  It is the equivalent of searching for everything and then changing the scope to Blogs in Connections.

This leads me to the next important point, which is Social Rendering makes use of the Connections Search API to find the content it displays.  It truly is a search operation, the results of which are what is displayed in the portlet.

Now that we know how we obtain the data, the second half of the equation is what is responsible for rendering the list.  This is a bit more complex of an answer.  In the WCM Library Explorer you should be able to find the IBM Connections library.  This is the library that is setup when Social Rendering is enabled that includes the components which are responsible for the design of the Social Rendering lists.  There are the expected authoring and presentation templates, but these are very generic and point to secondary components with reference another level of component.  I have found ti generally safe to use these same components for most lists.  The magic really happens when the content is run through the PZN engine and the PZN component applied.  The PZN component functions like a standard WCM navigator in that it has a header, body, and footer design block.  These blogs call HTML components which contain the markup that is applied to the search results.  This would be the injection point for customization as you can have the component reference a custom PZN component that links to custom HTML components.

In short, Social Rendering is a search result from Connections that is then handed to the PZN engine where UI elements are applied to the list of results.  The search type / criteria can be manipulated in the piece of content and the UI controlled with the PZN and associated HTML components.  These are then displayed with the standard web content portlets that are used for all WCM content on a Portal page.

The out-of-the-box lists all make use of the OneUI standard and are responsive UI friendly to fit into the Portal default UI.  Your cusotmizations may change this or not require the OneUI standard, but it is good to note this fact.

Hopefully this is more helpful than confusing to those looking in from the outside.  For some specific information about social rendering, refer to the Portal Wiki.

As an additional tip, one should also note that there are synergies between the Social Rendering lists and the IBM Connections Portlets for WebSphere Portal from IBM Greenhouse.  I intended to cover that in a bit more detail in a subsequent post.  Just be sure to grab the correct version of the portlets as the older versions do not have the same support for Social Rendering.

Saturday, July 20, 2013

Connections Mobile Update

If you have not looked recently, there has been another major update released for the mobile application for Connections.  They now support IBM Docs for SmartCloud users.  There is a small footnote that it is only for iPad at the moment, but I surely hope the rest of the platforms see this capability before too long.

Sunday, May 19, 2013

Surveys for IBM Connections

In the event you missed it, IBM Forms Experience Builder 8.5 brings a new capability to IBM Connections, Community Surveys.  This has been asked for by multiple customers I have worked with and am very excited to see this addition!

Here is the doc to get you started.

Tuesday, February 19, 2013

Yammer Starter

I recently had the pleasure of assisting an author bring his book vision to fruition and would like to share the output of these efforts.  Please take a moment and check it out.  This is a great resource if you are introducing someone to Yammer for the first time.

Thursday, February 07, 2013

Open Mic Webcast: Installing and Configuring Metrics in IBM Connections 4.0 - 27 February 2013

This is a very near and dear topic for me, so I thought I would share.  Metrics and I have been frenemies for a bit now, maybe for you as well.


IBM Collaboration Solutions (Lotus) support wants to help you take full advantage of your products. Join us for our Open Mic webcasts as technical experts share their knowledge and answer your questions.

These webcasts are designed to address specific topics and provide an in-depth and focused technical exchange in a convenient online webcast format.

This event's topic is "Installing and Configuring Metrics in IBM Connections 4.0."


Topic: Installing and Configuring Metrics in IBM Connections 4.0
Day: Wednesday, February 27, 2013
Time: 11:00 AM EST (16:00 UTC/GMT, UTC-5 hours) for 60 minutes

To ask a question in advance of this event, post your question as a response to this forum post.

For more information about our Open Mic webcasts, visit the IBM Collaboration Solutions Support Open Mics page.


<Slides will be attached here prior to the event>

Add to calendar


Web conference

Join the IBM Smartcloud meeting to view a slide presentation and participate in group web chat:

Phone conference

Participant passcode: 1397034

USA Toll-Free: 866-803-2145
USA Toll: 1-210-795-1099

International dial-in numbers:

CHINACHINA A:86-400-810-477510800-712-1319
CHINACHINA B:86-400-810-477510800-120-1319
CZECH REPUBLIC420-2-25-98-56-22800-700-227
HONG KONG852-3001-3847800-930-445
INDIAINDIA A:91-22-61501632000-800-852-1232
INDIAINDIA B:91-22-61501632000-800-001-6218
INDIAINDIA C:91-22-615016321800-300-00465
MEXICOGUADALAJARA (JAL):52-33-3208-7391001-866-886-2374
MEXICOMEXICO CITY:52-55-5062-9191001-866-886-2374
NEW ZEALAND64-9-970-47530800-446-096
SAUDI ARABIA800-8-110015
SLOVAK REPUBLIC421-2-322-422-32
SOUTH AFRICA080-09-98844
SOUTH KOREA82-2-6744-106700798-14800-6849
UNITED KINGDOMBIRMINGHAM:44-121-210-90320800-376-8334
UNITED KINGDOMGLASGOW:44-141-202-32320800-376-8334
UNITED KINGDOMLEEDS:44-113-301-21320800-376-8334
UNITED KINGDOMLONDON:44-20-7108-63150800-376-8334
UNITED KINGDOMMANCHESTER:44-161-601-14320800-376-8334
Restrictions may exist when accessing freephone/toll free numbers using a mobile telephone.