Skip to main content
Kinetic Community

SharePoint Document Upload

This handler uploads a document to a SharePoint document library.

Downloads

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

sharepoint_document_upload_v1.zip

This handler utilizes the Kinetic Task 2.0 encrypted task info value feature.  If you would like to use this handler within Kinetic Task 1.0, please see the solution article: Using Handlers with Encrypted Task Info Values in Kinetic Task 1.0

Detailed Description

This handler uploads a file to a SharePoint document library using an HTTP Put method call. Before making the call, the handler builds the URL based on the inputted parameters. This URL is the location where the file will be uploaded to. The call is then made using the Rest Client gem and the file is uploaded to the specified SharePoint document library. If the document library has versioning enabled, a duplicate file name will be uploaded as a new version and the file will be overwritten if versioning is disabled (versioning is disabled by default in new libraries). Any errors that occurs 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 get the Homepage URL
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. Using this site as an example:

https://sharepoint.company.com/devel...ages/Home.aspx

The URL that would be inputted is "https://sharepoint.company.com/development", where "development" is the sub-site and "sharepoint.compnay.com" is the base site.

Parameters

Name Description
Document Library Name The title of the document library that the file will be placed in.
Document Name The name that the document will have on the SharePoint server.
Attachment Question Menu Label The menu label of the attachment question where the photo will be uploaded to.

Sample Configuration

Parameter Example Configuration
Document Library Name Shared Documents
Document Name @answers['Document']
Attachment Question Menu Label Document

Note: When using this in conjunction with a service item it is helpful to note that if you set the Document Name as the answer to your Attachment Question Menu Label (ie, both are Document in the Sample Configuration) the Document Name will use the File Name, which is useful if you don't want to worry about renaming your files.

Results

This handler returns no results

Change Log

Version Date Description
1 2013-10-04 Initial Version