Integration of HTTP/ HTTPs WCF Services (REST

& SOAP) in SharePoint 2013

Amin, Adnan http://www.MSTechTalk.com

adnan.amin@hotmail.com

Contents

WCF Service integration with SharePoint (SOAP) ......................................................................................... 2

WCF Service Development (SOAP) ............................................................................................................ 2

Consuming WCF Service (SOAP) in SharePoint custom web part ............................................................. 4

Consuming WCF HTTP & HTTPS REST based Service in SharePoint web part .............................................. 7

Develop HTTP & HTTPS REST Service ........................................................................................................ 7

Consuming REST Services in SharePoint ................................................................................................. 10

Consuming HTTP REST Service ............................................................................................................ 10

Consuming HTTPS REST Service .......................................................................................................... 10

Scenario: Develop a custom web part for SharePoint 2013 which include few input fields and a file

attachment control. On submitting form, data should be saved in SQL Server table using WCF service.

WCF Service integration with SharePoint (SOAP)

WCF Service Development (SOAP)

Open visual studio 2012/2013, and create a new project, Select WCF Service Application as shown in

below image.

Delete the default file, and add create a new WCF Service.

I have created a separate layer for Business Logic (class library project) for database related queries,

where I have created an entity framework file and added database table. It will create entity class and

CRUD operations for my entity “SubDivision”.

I have added the reference of Business Layer in my service application.

Now create a new service application, and call the AddSubdivision method to insert record in database.

public void AddSubDivision(BusinessLogic.Subdivision item) { SubdivisionManager _manager = new SubdivisionManager(); _manager.AddSubDivision(item); }

In attached code solution, you can also find a service file named FileTranserService

which include the script to upload a file on the server.

Now add the file upload code in Upload method:

public void UploadFile(RemoteFileInfo request) { FileStream targetStream = null; Stream sourceStream = request.FileByteStream; string uploadFolder = @"C:\UploadFiles\"; string filePath = Path.Combine(uploadFolder, request.FileName); using (targetStream = new FileStream(filePath, FileMode.Create, FileAccess.Write, FileShare.None)) { //read from the input stream in 6K chunks //and save to output stream const int bufferLen = 65000; byte[] buffer = new byte[bufferLen]; int count = 0; while ((count = sourceStream.Read(buffer, 0, bufferLen)) > 0) { targetStream.Write(buffer, 0, count); } targetStream.Close();

sourceStream.Close(); } }

Consuming WCF Service (SOAP) in SharePoint custom web part

I have created a visual web part in visual studio. Then I have create a simple input form which contains

few input controls including a file control.

Now add the service references to web part solution and select services.

Click on Discover button, it will show current running web services, services can also be selected by

giving full URL. Now select the service and give it a reference name like DNBServiceRefrence and press

OK. It will create a service reference for DNB Service. Similarly, create service reference for

FileTransferService.

After adding service references, you are able to call them . But before calling them, you need to defince

service bindings and Endpoint details in SharePoint site’s web.config.

The Binding details for both services will be:

You can also check the difference in binding of both services, Bind for FileTransportService include extra

parameters to upload files.

Also set the httpRuntime in web.config to max upload size:

<httpRuntime maxRequestLength="2097152"

The above binding details shows the binding for upload of max file size.

After doing all these configurations, you can now integrate service in custom web part to submit data to

database.

Important: The binding details defined above can be dynamically added in SharePoint site’s

web.config using SPWebConfigModification class at the time of feature activation.

Consuming WCF HTTP & HTTPS REST based Service in SharePoint web part

Develop HTTP & HTTPS REST Service REST is nothing but using the current features of the “Web” in a simple and effective way. In REST, we

add one more constraint to the current URI, every URI should uniquely represent every RESOURCE data.

Below is the list of HTTP methods for getting, creating, updating and deleting a resource on the web.

GET Get a resource

PUT Create and update a resource

DELETE Deletes a resource

POST Submits data to the source

In WCF REST service there are two type of method headers WebGet & WebInvoke, I have developed

REST service using WebInvoke headers.

Make sure to add below two namespaces in service contract file

using System.ServiceModel; using System.ServiceModel.Web;

Now modify service contract file as below:

Similarly, define the file upload method

Above scripts show the defining of service contract for REST based WCF service.

Now, we have to define the methods in code to update the data. The methods definition is quite simple:

Important here, the endpoint binding details for REST service is defined in the Web.Config of WCF

application.

HTTP REST Service Binding

For Max file size, also define maxResuestLenght:

<httpRuntime executionTimeout="3600" maxRequestLength="2147483647"/>

HTTPS REST Service Binding

I have used below bindings for HTTPS based service, and it worked for me.

I also have defined maxRequestLength for maximum file upload size.

Consuming REST Services in SharePoint

REST service is quite simple to be integrated in SharePoint as compare to SOAP based services. They do

not require any binding details in SharePoint site’s web.config. REST services are called using URL of the

methods.

Consuming HTTP REST Service

HTTP REST service can easily called in SharePoint custom web part. I have called the below code which

submitting the form data.

Above code first post file on the server, then submits data on the servicer which then saved in database

by WCF service.

The service URLs can be set dynamically by multiple ways (through web part properties or web.config).

Consuming HTTPS REST Service

Calling of HTTPS REST service is quite similar, but it requires certificate validation, I used below code to

validate the certificate.

I have called OverrideCertificateValidation() method before service code execution. The Rest block of

code is same like HTTP REST service call.

Just a small modification required in SharePoint site’s web.config, set the maxRequestLenth to allow the

maximum upload lenght.

<httpRuntime maxRequestLength="2097152" />