SharePoint

Raffle Search as an application for SharePoint

Raffle can provide a Sharepoint App that will insert the Raffle Search Widget on a Sharepoint Online site.

Steps

You will receive the following from Raffle Support:
- Tool ID
- SharePoint Solution file
Go to the App Catalog in the Sharepoint Site (https://<subdomain>.sharepoint.com/sites/AppCatalog)
Click APPS FOR SHAREPOINT
Click UPLOAD or drag the file into the page
- Confirm that you trust the app, as it needs full access to the page to inject the widget
- For the application to be available immediately, use the NEW button, and DO NOT check “Make this solution available to all sites in the organization” while deploying
Go to the Sharepoint site where the Raffle Search UI will be implemented
Click the gear icon in the top right corner
Click ADD AN APP
- The app should now be available on the sites
- If you already have a version of the Raffle extension added to the website, delete it from Site Contents before adding the new one
- Check the Recycle Bin in the same view, and the Second Stage Recycle Bin at /_layouts/15/AdminRecycleBin.aspx?View=2 and delete the previous version
Locate the Raffle Search application
- It might take a couple or so minutes for the application to be available if the notes in Step 4 were not followed
Click ADD to save the changes

Configuring the App

In order to configure the app with the right settings, you need to create a hidden list that will contain these options:

create a hidden List inside the site where the tool should be used; it must be named raffle-search
add the following columns:
- raffleUid
- targetId (for Embedded Search UI)
- sharepointSearchContainerStyle (for disabling the default SharePoint search bar)
the first entry of the list should have the previous fields populated with the information associated with the tool (found inside the raffle web application on tool editing page)
- raffleUid → tool UID
- targetId → element selector (for Embedded Search UI)
- sharepointSearchContainerStyle → style for disabling the Sharepoint default search bar:
```
#O365_SearchBoxContainer_container{display:none;}
```

The Raffle Search widget will now appear in the top bar on all the pages on the site.

Raffle Search will, by default, overlap the existing Sharepoint search bar. To remove the existing search bar, use the official powershell cmdlets documented here.

Connect-PnPOnline -url
https://<subdomain>.sharepoint.com/sites/<site> -interactive

Set-PnPSearchSettings -SearchBoxInNavBar Hidden -Scope Web