Programmatic Access to and Extensibility of the IBM SmartCloud for Social Business

IBM SmartCloud for Social Business:
Programmatic Access & Extensibility

Philippe Riand, IBM Collaboration Solutions Social Application Development Architect
Niklas Heidloff, IBM Collaboration Solutions App Dev Advocate
Mark Wallace, IBM Collaboration Solutions Social Business Toolkit SDK Architect

12/10/13

Disclaimers
IBM’s statements regarding its plans, directions, and intent are subject to change or
withdrawal without notice at IBM’s sole discretion.
Information regarding potential future products is intended to outline our general product
direction and it should not be relied on in making a purchasing decision.
The information mentioned regarding potential future products is not a commitment,
promise, or legal obligation to deliver any material, code or functionality. Information about
potential future products may not be incorporated into any contract. The development,
release, and timing of any future features or functionality described for our products remains
at our sole discretion.
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.

2

© 2013 IBM Corporation

Agenda
●
●
●
●

Quick introduction to SmartCloud for Social Business
Real life scenarios involving the platform
Getting started for developers using the SDK
References, what's coming next and conclusion


What's is Smartcloud for Social Business?
●

Smartcloud for Social Business is a
social framework
●
Provides a set of social services
that can be consumed by any
application
●
Social: Profiles, communities,
activities, files, activity streams...
●
Instant messaging and meetings
●
Email
●
Provides an end user UI for
accessing the social data
●
Web and Mobile


What is relevant from an Application Development Standpoint?
●

●

●

●

Extending or consume cloud services
●
Integrating with the Smartcloud UI
●
Consuming our cloud social services in other applications
Profiles, communities, activities...
Provisioning and managing your customers and users
●
Working with BSS provisioning UI and APIs
●
Creating subscriptions
Customizing the cloud look and feel
●
Themes, logos, URLs
Extensibility is based on open standards
●
The services are exposed through a series of REST APIs
●
Based on either the ATOM standard, or the OpenSocial
specifications
●
Security and authentication - OAuth, SAML


Scenarios: Extensibility and Social Apps
●

●

6

Extensibility / Inside – Out
●
Extend the SmartCloud for Social Business user interface to include
jumping off points to your functions
●
Examples: Extensions to communities, embedded experiences in the
activity streams
●
Via the Smartcloud Extension Manager
Social Apps / Outside – In
●
Utilize the services of SmartCloud for Social Business as
infrastructure for your offerings
●
Examples: Context based searches in IBM Connections from apps,
discussions stored in communities
●
Via the Social Business Tookit SDK


Sample Scenario: Partner Community
●

●

7

IBM SmartCloud for Social Business (SC4SB) provides a big set of out
of the box functionality, for example:
●
Ability to invite guests
●
File synchronization for offline mobile usage
●
Communities with forums, files, etc.
Apps can be developed to extend the SC4SB functionality to implement
specific business requirements, specifically:
●
Workflow functionality / task assignments
●
Internal discussions


●

●

●

●

8

Zeta Insurance is a fictive health insurance company that sells their
products through partners, the insurance brokers
For the communication with partners a SC4SB community is used
●
New partners can easily be added as guests
●
Product brochures are stored in the community as files
●
Brokers can ask questions about products via forums
Insurances brokers use the out of the box SC4SB community UX
●
Web UI and mobile app
●
File synch to mobile app for offline usage
The Zeta Insurance support team uses an internal support app
●
To avoid that multiple people work on same question
●
To avoid having internal discussions in front of partners


Zeta Insurance
Support Specialists

Insurance Brokers

Paul Zhou

Samantha Daryn

Alan Goodwin

SC4SB Community
Internal Support App

9


Getting Started with SmartCloud for Social Business
●

Free trial is offered, at no cost!
●
60 days of no-cost access
●
Full suite of collaboration tools
●
Unlimited web meetings for up to 199 participants
●
Webmail, calendar, and contacts
●
25 accounts, each with 1.0 GB of collaboration and 1.0 GB of mail
●
https://www.ibm.com/cloud-computing/social/us/en/


The SmartCloud Administration UI
●

●

The SmartCloud Administration UI is available to the organization
administrators
●
Role to set at the user account level
For developers, it allows:
●
Management of internal apps
●
OAuth Keys
●
Management of the extensions
●
Action items, menus...
●
Add custom fields to Profiles
●
Ex: External identity on Twitter, Facebook...


Managing the Extensions
Administration → Manage Organization
Organization Extensions → Add Extension


OAuth for API Access
Create the credentials for OAuth 1.0a & 2.0


The Social Business SDK
●

●

●

●

Provides ready to use code libraries to connect with the social platform
●
Targets JavaTM, JavaScript and XPages developers
●
Supports Dojo and JQuery as JavaScript libraries
Large set of reusable code snippets
●
550+ JavaScript code snippets
●
200+ Java code snippets
●
XPages, and more coming
Layered APIs
●
Core layer handling all the low level details (authentication, servers...)
●
Higher level wrappers hiding the REST services and providing an easy
to use API
●
Full ATOM/JSON content is always available
UI controls to directly embed social data and behaviors within HTML
pages
●
Growing list of available components: communities, files, profiles...

The Social Business Playground and the API Explorer
●

●

●

Developer's landing place to understand the Social APIs and the SDK
●
Available on IBM GreenHouse from any browser
http://bit.ly/sbtplayground
Exposes JavaScript, Java and XPages Snippets
●
The code snippets are ready to be copy/paste into applications
API Explorer
●
Shows REST APIs in action
●
A subset of the APIs are currently available, but the goal is to expose
all the APIs this way


The Social Business Playground and the API Explorer


Get Access to the Community
●

●

●

The developers entry points
●
IBM DeveloperWorks: https://developer.ibm.com/social
●
IBM Greenhouse playground for APIs:
https://greenhouse.lotus.com/sbt/sbtplayground.nsf/Home.xsp
●
SDK Documentation: http://bit.ly/ibmsbtdoc
Leveraging the existing developer hubs
●
SBT YouTube channel: http://www.youtube.com/user/IBMSBT
●
Bi-weekly webminars, see: https://www.ibmdw.net/social/events/
●
Source code on GitHub: https://github.com/OpenNTF/SocialSDK
●
Presentation on SlideShare: http://www.slideshare.net/IBMSBT
Questions and answers StackOverflow:
http://stackoverflow.com/questions/tagged/ibmsbt


Using the Social Business SDK
●

Sign up for SmartCloud for Social Business trial
●

●

Create your first SDK-based application
●

●

Deploy JavaScript library and Server Assets

Explore SDK samples
●

●

Takes < 5 mins to create an account and you just need an email address
www.ibm.com/cloud-computing/social/us/en/startatrial/

Show different types of samples

Integrate your application with SmartCloud for Social Business
●

Using SmartCloud Navigation bar


Creating a Social Application
●

Clone our Git repository or copy source (master or release)
https://github.com/OpenNTF/SocialSDK.git
https://github.com/OpenNTF/SocialSDK/archive/master.zip
https://github.com/OpenNTF/SocialSDK/releases

●

Build commons and sdk projects
cd to SocialSDK/commons and run mvn clean install
cd to SocialSDK/sdk and run mvn clean install
Builds available in a public Maven repository soon

●

Configure your preferred J2EE server in Eclipse
Social Business Toolkit SDK – Installation Guide

●

Import Social Business Toolkit JS Library and My Social sample
SocialSDK/sdk/com.ibm.sbt.web
SocialSDK/samples/j2ee/templates/mysocial.webapp

1) Configure SmartCloud endpoint
Select OAuth 2.0 endpoint in managed beans xml
Configure OAuth 2.0 settings in sbt.properties
smartcloudOA2.url=<https://apps.na.collabserv.com>
smartcloudOA2.appName=<mysocial_local>
smartcloudOA2.clientID=<app_XXXX>
smartcloudOA2.clientSecret=<XXXXXX>


Sc
re
en
sh
t
s
o



Eclipse IDE (Java EE)
Web applications deployed to Tomcat


Enable SSL (context.xml and keystore)
Provide configuration (sbt.properties)


mysocial.webapp → managed-beans.xml

mysocial.webapp → web.xml

mysocial.webapp → pom.xml

mysocial.webapp → index.html (head)

mysocial.webapp → index.html (body)

mysocial.webapp → Grant Access

mysocial.webapp → Social Data

mysocial.webapp → Custom Actions

Sc
re
en
sh
t
s
o

Explore SDK Samples


Playground

Demonstration Snippet

API Snippets

Control Snippets

REST Snippets

Sc
re
en
sh
t
s
o

Integrate Your Application


Admin → Mange Organizations → Organization Extensions

Add Extension → Service → Top Navigation bar

Apps → My Social App

mysocial.webapp → index.html → Add SmartCloud theme

mysocial.webapp → index.html → Add SmartCloud Navigation bar

mysocial.webapp → SmartCloud Navigation bar

SmartCloud for Social Business Documentation
●

http://www-10.lotus.com/ldd/bhwiki.nsf


What is Coming Next?
●
●
●
●
●

●

Continuing on the API parity and completeness
Embedded Experience for the Activity Streams
Access SPIs using MQTT broker and custom events
Custom login page
Community applications
All APIs exposed in the
Playground - API Explorer


Resources and Questions
●
●
●
●
●
●
●

74

Home page: http://ibmdw.net/social
SDK: http://ibmsbt.openntf.org
GitHub: https://github.com/OpenNTF/SocialSDK
StackOverflow: #ibmsbt
Twitter: @ibmsbt
YouTube: http://youtube.com/ibmsbt
Playground: http://bit.ly/sbtplayground


Acknowledgements and Disclaimers
Availability: 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.
The workshops, sessions and materials have been prepared by IBM or the session speakers and reflect their own views. They are
provided for informational purposes only, and are neither intended to, nor shall have the effect of being, legal or other guidance or
advice to any participant. While efforts were made to verify the completeness and accuracy of the information contained in this
presentation, it is provided AS-IS without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising
out of the use of, or otherwise related to, this presentation or any other materials. Nothing contained in this presentation 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.
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. 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.

© Copyright IBM Corporation 2013. All rights reserved.
– U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.
IBM, the IBM logo, ibm.com, Rational, the Rational logo, Telelogic, the Telelogic logo, Green Hat, the Green Hat logo, and other IBM
products and services are trademarks or registered trademarks of International Business Machines Corporation in the United States,
other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a
trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information
was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is
available on the Web at “Copyright and trademark information” at www.ibm.com/legal/copytrade.shtml
Other company, product, or service names may be trademarks or service marks of others.

75


Programmatic Access to and Extensibility of the IBM SmartCloud for Social Business

More Related Content

What's hot (13)

Similar to Programmatic Access to and Extensibility of the IBM SmartCloud for Social Business (20)

More from IBM Connections Developers (11)

Recently uploaded (20)

Programmatic Access to and Extensibility of the IBM SmartCloud for Social Business