Skip to main content
Kinetic Community

SharePoint Site Create

This handler adds a new Site to a SharePoint top level site.

Downloads

By downloading this file, you acknowledge that you agree to our Terms of Service

sharepoint_site_create_v1.zip

The SharePoint handlers require Kinetic Task 2.0 and version 0.8.8 or above of the JOpenSSL library. To fulfill these requirements, either make sure all of your handlers that require OpenSSL are all on version 0.8.8 or above OR configure the handlers to execute in a distributed task engine that is only responsible for SharePoint handlers. For more information on configuring distributed task engines, see Configuring Distributed Task Engines.

Note: This handler requires that Microsoft SharePoint must be setup to support Basic Authentication and SSL to correctly authenticate the calls the handler makes. A step-by-step process to setting this up can be found here.

Detailed Description

This handler makes a SOAP call (using Savon) to the SharePoint Web Services to create a new site under the given homepage url. After configuring Savon to work with the given account credentials (make sure that the account has permission to create a site), the Site Template value is modified so SharePoint will recognize it. The inputted information is then passed to SharePoint via a SOAP call, where the Site is created with the given url appended to the homepage url. The newly created Site will not appear in the quick launch or top link bar of the parent website, so it will be needed to manually added before it shows up there. Any errors that occur during this process will be caught and re-raised by the handler. Authentication is done through SSL, so the SharePoint site being accessed needs to be setup to allow SSL connections.

Note: Make sure the SharePoint Web Services database is turned on.

How to Obtain the Homepage URL Info Value

To find the homepage url, all you have to do is look at the URL of any page on the SharePoint site. The url that should be inputted should contain both the base url (the top-most site in the collection) and the sub-site that you are on. For example, given the following URL:    

https://sharepoint.company.com/development/SitePages/Home.aspx

The base site is "sharepoint.company.com", the sub-site is "development" and the 'HomePage URL' task info values should be set to:

https://sharepoint.company.com/development

Parameters

Edit section
Name Description
Title The title of the new Site.
URL The URL that will identify the new site. The new URL will be appended to the top level URL, so the final URL will have the form of http://homepage_url/new_sites_url.
Description A description of the new Site.
Site Template The site template that will be used for the Site. Will be chosen from the drop down list.

Sample Configuration

Edit section
Parameter Example Configuration
Title Testing Handler
URL testinghandler
Description This Site was created from a handler
Site Template Blank Site

Results

This handler returns no results

Change LogEdit section

Version Date Description
1 2013-10-08 Initial Version