Thursday, December 1, 2016

How to Create Multiple Communities in IBM Connections or Connections Cloud?

As a non developer, this was easier than I imagined it would be, once help arrived from my friends.

I have a Lotus IBM Quickr customer, my last one, so any Quickr sites, contact me I am available! Anyway, I am moving them from Quickr to the IBM Connections Cloud environment.

This post is not about the move itself, but about how one can create over 200 new communities(200+ Places and 220GB of data) without having to hire an intern to do it manually.

I posted to the chat for IBM Connections people and my friends Christoph and Ben pointed me to the Connections API documentation. Yes, it looks and reads like gibberish so I asked if there was an easier way and one of them found a blog post by Julius.

Julius, as it turned out, was also in the chat and I asked if this post would work for Connections Cloud, no one knew. So we tried. And failed. Christoph said we needed a header, which as it turns out was the correct answer, an atom+xml header.

Confused yet? Well you could review Julius's blog post where he covers almost everything, but here is what you need to know.

Using Firefox and the RESTClient plugin you get a nice little UI that lets you create your request in pretty simple XML terms. Thanks Julius for coding something simple enough for me to figure out how to swap in the information to make it work.

These are the steps:
1) Set the header. I did not even see the little menu on top of the screen with a drop down to create headers.
Click on Headers to see the choices and select Custom Header.










When the next window comes up, enter the text as in my screen shot. To remember this for future need, click on  the Save to favorite box then say ok.








2) For the Method drop down box, select POST
3) For the URL, you need to use: https://apps.na.collabserv.com/communities/service/atom/communities/my
4) The body field, this is where the fun starts.

This is what my code looked like in basic form.
<?xml version="1.0" encoding="UTF-8"?>

<entry
xmlns="http://www.w3.org/2005/Atom"
xmlns:app="http://www.w3.org/2007/app"
xmlns:snx="http://www.ibm.com/xmlns/prod/sn">
<id>ignored</id>

<title type="text">Jefferson Airplane</title>

<summary type="text">ignored</summary>
<content type="html">Music group in san francisco</content>
<published>ignored</published>

<author>
<name>Keith Brooks</name>
<email>keith@keithbrooks.com</email>
<snx:userid>18675309</snx:userid>
<snx:userState>active</snx:userState>
</author>

<updated>ignored</updated>

<category term="community" scheme="http://www.ibm.com/xmlns/prod/sn/type"></category>
<snx:membercount>ignored</snx:membercount>
<snx:communityType>private</snx:communityType>
</entry>

 5) Once run you should get a 201 Created reply and when you go to the communities you will see it.


Next step is to include members and format the communities. Will post an edit or a new post with that code for those in need.

Thank you again Julius, Christoph and Ben!