Skip to main content
Kinetic Community

SharePoint Contact Create

This handler creates a new contact in a SharePoint Contact list.

Downloads

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

sharepoint_contact_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 contact in a Contact list. Savon is then configured to work with the given account credentials. Next the Batch XML structure is built to give the Web Service the information it needs to create the new contact, which is then passed via a SOAP call to SharePoint, where the contact is created and posted to the list. 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

Name Description
Contact List Name The name of the contact list that the contact will be added to.
Last Name The last name of the contact.
First Name The first name of the contact.
Email The email of the contact.
Company The company associated with the contact.
Job Title The job title of the contact.
Work Phone The work phone number of the contact.
Home Phone The home phone number of the contact.
Cell Phone The cell phone number of the contact.

Sample Configuration

Parameter Example Configuration
Contact List Name Contacts
Last Name User
First Name Test
Email test.user@acme.com
Company Kinetic Data
Job Title Test Position
Work Phone 123.456.7890
Home Phone 012.890.4567
Cell Phone 567.476.1234

Results

This handler does not return any results.

Change Log

Version Date Description
1 2013-10-08 Initial Version