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 8.0.0.1 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 8.0.0.1 and make sure the 8.0.0.1 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!

http://www-10.lotus.com/ldd/lfwiki.nsf/xpDocViewer.xsp?lookupName=Forms+Experience+Builder+8.5+documentation#action=openDocument&res_title=Surveys_in_IBM_Connections_communities_FEB_850&content=pdcontent

Here is the doc to get you started.

Tuesday, February 19, 2013

Yammer Starter

http://www.packtpub.com/yammer-starter/book

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.

Abstract

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."

Content

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.

Presentation

<Slides will be attached here prior to the event>


Add to calendar

OpenMic_ConnectionsMetrics_02272013.icsOpenMic_ConnectionsMetrics_02272013.ics


Web conference

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

http://www.ibm.com/collaboration/meeting/join?id=3379867

Phone conference

Participant passcode: 1397034

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

International dial-in numbers:

ARGENTINA0800-777-0483
AUSTRALIAADELAIDE:61-8-8121-48751-800-993-891
AUSTRALIABRISBANE:61-7-3102-09771-800-993-891
AUSTRALIACANBERRA:61-2-6100-19771-800-993-891
AUSTRALIAMELBOURNE:61-3-9010-77461-800-993-891
AUSTRALIAPERTH:61-8-9467-52561-800-993-891
AUSTRALIASYDNEY:61-2-8205-81111-800-993-891
AUSTRIA43-1-92-80-2990800-005-020
BELGIUM32-2-403-10450800-4-9978
BRAZIL55-11-3958-07690800-8911977
CANADA866-845-8496
CHILE1230-020-0254
CHINACHINA A:86-400-810-477510800-712-1319
CHINACHINA B:86-400-810-477510800-120-1319
COLOMBIA01800-9-156417
CZECH REPUBLIC420-2-25-98-56-22800-700-227
DENMARK45-7014-02778088-6033
ESTONIA800-011-1111
FINLAND358-9-5424-71480-800-1-13084
FRANCELYON:33-4-26-69-12-92080-510-1036
FRANCEMARSEILLE:33-4-86-06-00-92080-510-1036
FRANCEPARIS:33-1-70-70-74-22080-510-1036
GERMANY49-69-2222-78020800-000-3328
GREECE30-80-1-100-067800800-12-6968
HONG KONG852-3001-3847800-930-445
HUNGARY36-1-700-881806-800-17998
INDIAINDIA A:91-22-61501632000-800-852-1232
INDIAINDIA B:91-22-61501632000-800-001-6218
INDIAINDIA C:91-22-615016321800-300-00465
INDONESIA001-803-011-3781
IRELAND353-1-431-97131800-932-282
ISRAEL1-80-9214888
ITALYMILAN:39-02-3601-0952800-986-557
ITALYROME:39-06-8751-6065800-986-557
ITALYTORINO:39-011-510-0165800-986-557
JAPANOSAKA:81-6-7739-477600531-12-1855
JAPANTOKYO:81-3-5539-516900531-12-1855
LATVIA8000-2931
LUXEMBOURG352-27-000-13558002-9341
MALAYSIA1-800-80-2326
MEXICOGUADALAJARA (JAL):52-33-3208-7391001-866-886-2374
MEXICOMEXICO CITY:52-55-5062-9191001-866-886-2374
MEXICOMONTERREY:52-81-2482-0691001-866-886-2374
NETHERLANDS31-20-718-85180800-020-1250
NEW ZEALAND64-9-970-47530800-446-096
NORWAY47-21-59-00-54800-10097
PANAMA011-001-800-5072068
PERU0800-53780
PHILIPPINES63-2-858-3740
POLAND00-800-1212016
PORTUGAL8008-60385
ROMANIA40-31-630-01-22
RUSSIA8-10-8002-9693011
SAUDI ARABIA800-8-110015
SINGAPORE65-6883-9213800-120-4336
SLOVAK REPUBLIC421-2-322-422-32
SOUTH AFRICA080-09-98844
SOUTH KOREA82-2-6744-106700798-14800-6849
SPAIN34-91-414-29-40800-098-585
SWEDEN46-8-505-78-5530200-890-172
SWITZERLAND41-44-580-75290800-001-028
TAIWAN886-2-2795-736300801-137-710
THAILAND001-800-1206-65645
TURKEY00-800-151-0841
UNITED ARAB EMIRATES8000-35702381
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
URUGUAY000-413-598-3406
USA1-210-795-1099866-803-2145
VENEZUELA0800-1-00-3751
Restrictions may exist when accessing freephone/toll free numbers using a mobile telephone.