page_type

products

languages

extensions

description

sample

office-sp

office-365

aspx

contentType

technologies

createdDate

samples

Add-ins

8/11/2015 2:10:00 PM

Use the Search REST and OData endpoint, in a SharePoint Add-in, to programmatically search content are return the results.

Calling the Search REST\OData endpoint in SharePoint Add-ins

SharePoint add-in model is considered as a legacy option for extending SharePoint user interface. Please see SharePoint Framework documentation and the SharePoint Framework samples for the future proven option to extend SharePoint Online. Possible backend services should be using Azure Active Directly based registration and related app models.

Summary

Use the Search REST\OData endpoint, in a SharePoint Add-in, to programmatically search content are return the results.

Applies to

SharePoint Online and on-premise SharePoint 2013 and later

Provided by

Scott Hillier, Critical Path Training

Prerequisites

This sample requires the following:

A SharePoint 2013 (or later) development environment that is configured for add-in isolation. (A SharePoint Online Developer Site is automatically configured. For an on premise development environment, see Set up an on-premises development environment for SharePoint Add-ins )
Visual Studio and the Office Developer Tools for Visual Studio installed on your developer computer
Basic familiarity with RESTful web services

Description of the code

The sample accepts a query using the keyword query language (KQL) syntax as an input. It subsequently makes a call to the search engine using the SharePoint search REST\OData endpoint. The results are then displayed in a table, which is built dynamically using JQuery and JavaScript.

The code that uses the REST\OData endpoint for Search is located in the Add-in.js file of the project. The Default.aspx page of the add-in appears after you install and launch the add-in. When you enter a search term and press Search, the page looks similar to the following.

The sample demonstrates the following:

How to construct a REST\OData query to the Search endpoint.
How to parse the JSON-formatted data returned from the SharePoint and how to display it dynamically.

To use the sample

Open Visual Studio as an administrator.
Open the .sln file.
In Solution Explorer, highlight the SharePoint add-in project and replace the Site URL property with the URL of your SharePoint developer site.
Press F5.
After the add-in installs, the consent page opens. Click Trust It.
Enter a KQL query string in the text box beside the Search button and click the button. In a moment, the page refreshes and the returned data is displayed in a table.