} How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution { Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 1
TABLE OF CONTENTS The Great Debate Between Jive and SharePoint................................. 3 Making SharePoint a True Social Business Solution.............................. 3 Getting IT Buy-in for Jive.............................................. 4 How to Approach the Jive + SharePoint Integration.......................... 4 How the Jive for SharePoint Connector Works.............................. 5 FIGURE 1: On Premise Jive / On Premise SharePoint Installation.................... 5 FIGURE 2: Hosted/Cloud Jive Instance with On-Premise SharePoint Installation...... 6 FIGURE 3: SharePoint Integration Options for Jive for SharePoint Connector........ 7 Maintaining Security with Both Systems.................................. 8 Customer Use Case: Higher Education Company............................ 8 Conclusion........................................................ 9 APPENDIX SharePoint to Jive Communication Details................................. 10 SharePoint and Jive REST/Authentication Communication Diagram.............. 11 Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 2
The Great Debate Between Jive and SharePoint The emergence of cloud-based enterprise collaboration platforms like Jive has caused a massive disruption within IT departments across the globe. The fact that teams now have the ability to launch enterprise-wide IT systems without any involvement from IT has imposed a new set of challenges for IT professionals to address. They have built their careers as the protectors of information, so when a system like Jive presents itself as an alternative to SharePoint a prominent system within enterprise IT organizations they re inclined to reject Jive and stick with what they know keeps corporate assets safe. Yet they are not getting much support from Microsoft, as they have not released a roadmap for Yammer integration for on-premise instances, and SharePoint 2013 does not offer the rich social collaboration that companies expect and Jive offers. Having said that, there are things that SharePoint does much better than Jive and others that Jive cannot do at all. So if you are looking to have a complete social collaboration solution for your enterprise, the answer is obvious you need an integrated solution that combines SharePoint and Jive. Making SharePoint a True Social Business Solution Many SharePoint administrators claim that SharePoint can do everything Jive can do; they just need to develop and configure SharePoint. Yes, SharePoint can be customized to offer more social aspects with quite a bit of development, but it almost never makes economic sense to launch a project to develop a capability in place of a product that has already been proven and brought to market. Attempting to develop SharePoint to mimic Jive would be like trying to develop a native email application because you don t like Outlook. Not only is it ridiculously expensive, but you now have to provide support and upgrades to keep up with the same features that Outlook will develop and deploy over time. The same logic prevails here; no shop has the ability (nor is it cost effective) to develop a social business platform that is as rich as Jive. And with four releases each year, it is economically and logistically impossible to keep up. The we can build it all in SharePoint argument often distracts from the true issue, which is that an enterprise does not have to run Jive or SharePoint exclusively; both are needed, and both can run smoothly together. SharePoint provides rich features that Jive doesn t, and it shouldn t be ignored. There are so many things that SharePoint uniquely can do that add value to the enterprise. Anytime you need a robust workflow, document security, record management, integration with InfoPath, and a host of other features, SharePoint is the industry standard. The Jive integration to SharePoint is simple, powerful and robust providing powerful search, tagging, and discussion tools (and lots more) against content that is often difficult for many in the enterprise to access. This means that SharePoint can now become a very powerful backend to the friendly, easy-to-use Jive user interface. Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 3
Getting IT Buy-in for Jive The last part of the puzzle is how to get the SharePoint admins to support Jive. The argument is easy and has two parts. First, instead of thinking that they will lose their position as the gatekeepers to IT, explain to the SharePoint developers that by allowing users to take control of their Content and Places (Space/Group vice a Brochure Site), they will have more time to develop the exciting applications, workflows, and lists that SharePoint does so well. The second part of the argument, that we are seeing many SharePoint developers explore, is that fact that Jive is a new technology in the same space. By learning how to develop in Jive and SharePoint, they can make themselves highly valuable to not only their current company, but any company running both applications. Learning this new skill could make them one of the proverbial pink unicorns 1 as we refer to them at JCS. How to Approach the Jive + SharePoint Integration So now let s say you ve made the decision that you want both Jive and SharePoint to maximize your company s productivity how do you implement the solution? It is not as easy as configuring the Jive for SharePoint connector and launching, because this can be confusing to users. Users will be confused about where to put documents (Jive or SharePoint) and why. Most SharePoint intranets are composed of static brochure sites, with little information, and many levels and rabbit holes that users get lost in. In addition, before SharePoint 2013, the native search in SharePoint was not very effective. If a company had been using SharePoint as an intranet, and they launched a Jive instance without moving the intranet to Jive, there was much confusion. One of the biggest issues to address within the joint Jive/SharePoint solution is the starting point for end users. Jive naturally lends itself as a starting point because it has a home page. But if you have an existing SharePoint brochure site, you ll now have two home pages in existence. Some users are very comfortable in SharePoint and they want to continue to work there, and others will gravitate towards Jive because it is far more user-friendly. This argument is very similar to the Apple vs. Windows issue. One is good at some things and the other is good at other things, but they can be used in the same enterprise structure. So how do you implement a successful collaboration environment and maximize the ROI you get from each system? In our experience, the right way to do this is to make Jive the new intranet and use SharePoint as the powerful backend. This enables any applications, web services, or other previous development projects to continue to be used. It also allows the very expensive SharePoint developers to use their time to develop more complex solutions for the enterprise instead of maintaining brochure sites. The question then becomes how to connect SharePoint and make it easy for users to work in the system they need to and still see what is going on in the other system. The Jive for SharePoint connector allows users to do just that. 1 Pink Unicorns are creatures of myth and legend; often discussed but rarely actually observed. They possess mystical powers of healing and influence. An IT employee comfortable with both Jive and SharePoint and skilled to wrest the best value from either qualifies as a Pink Unicorn. Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 4
How the Jive for SharePoint Connector Works The Jive for SharePoint connector shows documents uploaded in SharePoint within the Jive Group/Space. It also allows the content in Jive to be displayed in SharePoint through Web Parts, which are installed with a custom.wsp file that is installed in the SharePoint farm. A service account, with Full Control permission, is also needed to allow the SharePoint connector to work. Any application or forms that users want/need to fill out can be accessed through Jive by using a Formatted Text widget and using HTML links. This will allow the user to navigate seamlessly between Jive and SharePoint. The following network diagrams illustrate generic examples of how information flows between the Jive servers and the SharePoint Farm (servers). The first diagram is a common connection when Jive is installed on premise. As you can see, the network flows are all internal, and it is basically the Jive app servers communicating with the SharePoint web service. FIGURE 1: On Premise Jive / On Premise SharePoint Installation Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 5
FIGURE 2: Hosted/Cloud Jive Instance with On-Premise SharePoint Installation Figure 2 illustrates how the Jive for SharePoint network flows work when the SharePoint Servers are on premise and the Jive servers are either hosted or cloud. As you can see, some firewall configurations are required to allow the Jive servers to communicate with the SharePoint farms. Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 6
The Jive for SharePoint solution can be configured to work with both on-premise and hosted/ cloud solutions. The concept remains the same if the SharePoint farm is hosted as well. The only issue with having a hosted SharePoint solution is that the.wsp file needs to be loaded into the farm, not just the site collection, so if the hosted solution is not dedicated, the provider might not allow the installation of the.wsp file. The other issue to consider is that the provider must be able/willing to allow the connection between Jive and the SharePoint farm through their firewall. There are four different integration options with the Jive for SharePoint connector (See Figure 3 below): 1. None: This means that you choose not to use any integration with SharePoint from Jive. 2. New Site Storage Only: In this case, Jive will provision a SharePoint site in the selected Site Collection, but it will not be able to be accessed by anyone but SharePoint administrators. This SharePoint site will be used to store Jive content and binaries. The content will not be able to be accessed through SharePoint, only through the Jive Group/ Space it is socialized with. If the connection is lost, the data is disconnected as well. 3. New Site With Jive Functionality: In this case a new SharePoint site is created and the Jive web parts are automatically inserted in the SharePoint. All content will still be stored in SharePoint as in option two, but the data is accessible in both Jive and SharePoint. All SharePoint documents will be able to be seen in the Jive Group/Space. 4. Existing Site: In this option, the data is stored in the existing SharePoint site but the SharePoint site admin will have to add the Jive web parts that they want. The web parts added to the SharePoint site will determine the amount of Jive content that can be seen in SharePoint, but SharePoint documents will still be able to be seen in Jive. FIGURE 3: SharePoint Integration Options for Jive for SharePoint Connector Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 7
Maintaining Security with Both Systems Security is always a big question when prospective customers are looking at the Jive for SharePoint connector. The quick answer is that Jive does not override SharePoint permissions. Users must be provisioned in SharePoint, and there must be a common user attribute in both Jive and SharePoint. Most current implementations use email address as this attribute. There are generally two different ways that permissions are dictated in the integration. The first is if there is an existing SharePoint site that is being connected to Jive. In this case, permissions are managed separately. If a user is invited into the Jive group, but is not provisioned in SharePoint, they will be able to see the documents in Jive, but not any of the documents in SharePoint, nor will they be able to access the socialized SharePoint site. The other case is if Jive is used to provision a SharePoint site using the service account. In this case, Jive permissions will be carried over to the new SharePoint site, but only if the user is provisioned in SharePoint. By using this general rule of thumb, it is easy to set up your Jive for SharePoint governance and choose whether you want Jive to manage SharePoint permissions or if you want to keep them separate. Customer Use Case: Higher Education Company A leading private education company needed to find a social and informal learning solution that allowed for quick collaboration, breaking silos, and sharing knowledge among boots on the ground, which led them to Jive. Prior to launching their Jive instance, the company had been utilizing SharePoint as their intranet and document portal. Due to the developer-heavy nature of SharePoint, requests from the business usually resulted in a lengthy response time and high costs, which caused a number of inefficiencies for the business. But they couldn t simply shut down SharePoint and start using Jive all documents had to continue to be stored in SharePoint due to federal requirements. Once they recognized the opportunity to combine Jive and SharePoint to create a seamless solution that met their business requirements, they reached out to JCS to help integrate the two platforms. JCS worked with Jive and the customer to overcome the challenges of connecting an internal SharePoint instance to an externally hosted Jive instance. The relationship that JCS built with Jive s SharePoint team has produced numerous enhancements for customers and reduced testing times for Jive. This resulted in a more seamless integration between Jive and SharePoint. Initially, all of the customer s Jive groups were connected to SharePoint to meet the legal department s requirement. In a short time, over two hundred groups were connected to SharePoint with no issues. Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 8
With this new capability, specific use cases emerged documenting and demonstrating the business value gained: SOX audit requirements forced a structure in SharePoint that made it hard to get input from document owners and approvers. By adding Jive collaboration to the existing SharePoint content, stakeholders could easily find and edit their documents. Approvals that used to take up to three weeks are now completed within 48 hours, including C-level executives. One of the broader uses enabled Human Resources to immediately provide answers to common employee questions while simultaneously reducing their work required. Over the years, the HR team had accumulated a large volume of reference documents in SharePoint. Unfortunately, they were difficult to find, which resulted in several emails per day from employees with questions that could have been answered if only the documents had been easier to find. Once Jive connected to SharePoint, one benefits coordinator was able to quickly create a space in Jive that connected to the SharePoint library. She pulled the most frequently used documents into the Jive space and was able to reduce her questions received via email by directing people to Jive. The new SharePoint connector allowed people to work within whatever platform (Jive or SharePoint) they chose. This reduced both initial and on-going training and support costs. It also eased the transition from working in SharePoint to working in Jive. Because SharePoint and Jive each have their use in the enterprise stack, it is not a decision of one versus the other. The natural evolution seems to a move away from a static SharePoint intranet to a social Jive intranet with SharePoint housing those documents with a higher requirement for control, audit or release authority. In the end, connecting the two platforms strengthened the use of each. Conclusion One of the most important things to keep in mind about Jive is that it isn t limited to only operating as a standalone solution, although it is very strong on its own. It s an adaptable platform that integrates well with other critical business systems, which allows companies of all sizes and industries to create an ideal collaboration platform that suits their unique business needs. SharePoint is broadly deployed and will continue to uniquely provide benefits to large companies. But for those who want to evolve into a truly social business, new tools are required. Continuing SharePoint s powerful position as the backend solution while upgrading to Jive s user-friendly interface and powerful search engine creates a best of both worlds enterprise collaboration solution. Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 9
APPENDIX A SharePoint to Jive Communication Details SharePoint will make many calls to the Jive instance and use the Rest Web Service CallJiveApi. These API calls are designed to help to keep SharePoint in sync with Jive. CallJiveApi is built into the custom service implementation that is deployed to SharePoint SharePoint Server GET/POST Rest API calls to Jive are used for the following: Get Jive Container information (Example: SocialGroup ID) Get confirmation about success/failures of Jive Actions Post information that will link Jive Container to Sharepoint Site Post Jive Discussion content Post Jive Status Updates Various calls are also made to handle a Jive request/response HTTP Headers Used in GET/POST Rest API calls to Jive **: X J Application : SHAREPOINT : j-sp-authentication : Current Custom Jive Authentication Token j-sp-username : Current SharePoint User Name **Please note that Network Appliances must allow the above headers safe passage from your SharePoint Application to Jive Application. SharePoint to Jive GET/POST Rest API Example Flow: SharePoint will generate a new WebRequest/WebResponse when making a GET/POST to Jive. Examples: To GET a User s Avatar Image from Jive, a WebRequest with a URI like the following is created and executed: http://{0}/image/avatar/{1}, where {0} is the Jive URL {1} is the Image ID To POST an uploaded document, a WebRequest with a URI like the following is created and executed: http://{0}/document/createtoactivity/{1}/{2}7fullactivity-true, where {0} is the Jive URL {1} is the containtertype {2} is the containterid and the uploaded content is POSTED as an Activity Stream. Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 10
SharePoint and Jive REST/Authentication Communication Diagram Sending registration info every 10 minutes from Jive to Sharepoint: Making web calls tunnelled via Web Service (including both data and resources), Jive side will use identity mapping to translate SharePoint user name to Jive user and impersonate: Whitepaper: How to Combine Jive and SharePoint to Create an Enterprise Social Collaboration Solution Page 11