Articles in this section

Connect SharePoint Online Libraries

You can connect as many SharePoint Online libraries as you'd like with QorusDocs. You can either connect multiple libraries as one SharePoint Online library content source, or you can create multiple Content Sources that each point to one SharePoint Online library only. Or even a bit of both.

Before you can connect any SharePoint Online libraries or lists to QorusDocs, you need to have at least 'Contribute' rights to these places in SharePoint Online, and you also need to belong to the QorusDocs Admin role.  

In this article you will learn the main steps when creating a new SharePoint Online library content source which are as follows:

  1. Add a new SharePoint Online Library Content Source
  2. Copy and Paste the link to your SharePoint Online site in the connector settings
  3. Set any advanced options (Optional)
  4. Select SharePoint Online Library search locations to add to your new Content Source
  5. Select SharePoint Online Library save locations to add to your new Content Source(Optional)
  6. The search options available for SharePoint library Content Sources
  7. How to set up search filters for SharePoint library Content Sources
  8. What to do if newly added content is not showing up in Search Results
  9. What to do if your SharePoint library structure changes

Let's get started with the steps.

1. Add a new SharePoint Online library content source

First, you’ll need to log into Hub Central, from the left navigation menu, click on ‘Content Sources’ under ‘Manage’, then click on ‘Add’, to add the ‘SharePoint Online Library’:

Back to the top

2. Copy and paste the link to your SharePoint Online site in the connector settings

On the 'Configure Content Source' screen:

  1. Give your SharePoint Online Library content source a name.
  2. Copy and paste the URL for the SharePoint Online site that houses the library or libraries you'd like to connect.

If you don't plan on setting any advanced options, click on the 'Next' button (bottom right) to go to the next step which is selecting the SharePoint Online library search locations to add to your new content source.

Also, if you are unsure where to get the URL of your SharePoint site, visit the ‘home’ page of your SharePoint site. You then copy/paste the URL directly from your browser’s address bar.

Sales_and_Marketing_site.png

Back to the top

3. Set any advanced options (optional)

Click on 'Show Advanced Options' to see the options available.

Advanced options available

Search location image

By default, QorusDocs will display the SharePoint logo next to SharePoint Online content sources in the Search pane. You can however add your own custom images for each content source, making it easier for users to differentiate between content sources, especially if you have many connected to your QorusDocs Hub.

To do that, click on the box indicated below:

After clicking on the box, select an image from your computer. Note that your image should be 50 pixels by 50 pixels for the best results.

Search Type

By default, the Search Type will be set to Smart Search – which is our AI-powered search capability. However, if you’d prefer to offer a Keyword Search experience to users of this Content Source, then you can select this option in the Search Type section.

For a more information about configuring Search Types for your SharePoint Content Sources, as well as the implications for the user experience, click here.

QPilot: Enable Content Source

Enabling the option 'display this Content Source in QPilot Sources will allow users to reference this content source when prompting QPilot to generate or search a content.

You can learn more about Connecting your QPilot Content Source here.

Ranking Model

It’s essentially the relevance formula SharePoint uses to score and order your documents when QorusDocs queries the library. The ranking score affects what appears at the top when you search within that content source in QorusDocs. This is mainly used for general-purpose content libraries without special filtering needs.

Content source delimiters

Delimiters are a sequence of one or more characters used to specify the boundary between separate regions of text, like a text placeholder. You can read more about them here.

By default, delimiters are defined at Hub level - meaning that they apply to all content across your QorusDocs Hub, no matter the content source from which the content is served.

Here, you can override the delimiters set at Hub level and enforce content source specific delimiters. The delimiters you specify here are the only ones that will be considered valid for the content served via this content source. 

Learn more about How to define Smart Field Delimiters here.

PDF Conversion

By default, you have the ability to convert to PDF: 

If you'd like to prevent files that are served up from this content source from having any PDF conversion options enabled, then you can turn this off here, by unchecking the box: 

When you're ready, click 'Next' (bottom right) to move on to the next step.

Back to the top

4. Select SharePoint Online library search locations to add to your new content source

To choose the places you'd like to make searchable with QorusDocs, otherwise known as search locations, all you need to do is check the boxes next to the libraries and/or folders you'd like to include as part of your content source.

After selecting the search locations, click on 'Finish'. Otherwise, carry on with the step below to add save locations to your content source.

Back to the top

5. Select SharePoint Online library save locations to add to your new content source (optional)

'Save' locations work hand in hand with the QorusDocs ClipCreate and the Cart

Here again, all you need to do is check the boxes next to the libraries and/or folders you'd like to make available as places that users can choose to save new files to. 

Although here we've deliberately picked different libraries for our search and save location, there's nothing preventing you from setting up the same libraries/folders to be both search and save locations.

Then, you can also optionally assign a style template to the save locations that you’ve selected.

Assigning a style template automatically applies all your brand colors, fonts, and styles to the content clipped to these save locations, so that you can be assured that clipped documents are always on brand.

After clicking on ‘Select template’, a new window will pop up (see the screenshot below), prompting you to insert and apply the URL of the SharePoint library where your Word style template is saved (this can be any library and does not have to be one that you’ve selected as a Search or Save location for this content source)
To get the URL where the Word Style is saved, In your SharePoint site, navigate to the library where the style template is saved, and copy the URL (up until and including the folder name) directly from your browser's address bar.

When you click on ‘Save selection’, the following window will pop up prompting you to confirm if you want to associate this style template to all the selected Content Sources across your QorusDocs Hub, or for just this specific content source.

Then when you’re done, click ‘Finish’.

For those who need to cater for multiple styles, you can set up a unique Word style template for each Content Source. The Content Source you clip to will then determine what Word style template gets applied.

Back to the top

The search options available for SharePoint library content sources

In the Search pane, this is how our content source that connects to multiple libraries shows up: 

The newly added content source can be searched using the search box, browsed by simply clicking on the content source name, and also searched with the help of search filters. You can find in-depth information about search capabilities in this article

Back to the top

How to set up search filters for SharePoint library content sources

QorusDocs automatically builds up the list of search filters for a content source based on the Managed Metadata columns it finds in the libraries you've connected. So the setup does not actually take place in QorusDocs at all, it takes place in SharePoint itself. 

If you've never heard of Managed Metadata, then you might want to check out this article first.

Otherwise, proceed to this article to learn how to create Managed Metadata columns in SharePoint.

You'll want to add the Managed Metadata columns to your SharePoint Online libraries, and then categorize your content by filling in those columns. This is considered best practice and can be key in ensuring that your content remains easy to find, especially when you have a large volume of files and potential search results to wade through.

Once you're done, your custom SharePoint Online library search filters will become available in the QorusDocs search pane along with 2 other filters, the file type and last modified filters as shown below.

Back to the top

What to do if newly added content is not showing up in Search Results

If you’ve recently added new content and you’ve set the Search Type to ‘Smart Search’, then please be aware that our AI needs to index the content first before it can become searchable. QorusDocs AI automatically indexes your content twice a day in the background. If you’d like to trigger the indexing before then, there is an option to do that. To learn more about how to do that, click here.

What to do if your SharePoint library structure changes

QorusDocs won't automatically pick up any fundamental changes in your SharePoint structure, such as renaming libraries or folders, or adding, deleting or renaming Managed Metadata columns in the libraries connected to QorusDocs. For this reason, you will need to update your content source in QorusDocs, so we can pick up the structural changes you've made in SharePoint. 

To do that, click on 'edit' next to the SharePoint Online library content source: 

This will take you to the search location setup screen.

If the only things that have changed are the Managed Metadata columns associated with your libraries, then there's no need to do anything here - simply click on 'Finish' and QorusDocs will rebuild the list of custom search filters to include your Managed Metadata column changes.

If libraries/folders have been renamed or deleted, then you can make changes to the search and save locations you had previously selected here.

When you're done, click on 'Finish'

If you are editing the advanced options, the link will be greyed out by default to prevent accidental changes. To modify the SPO link, click the pencil icon.

After editing the options, a success message will be displayed mentioning the Content Source has been updated.

Back to the top

 

mceclip0.png

 

 

 

Was this article helpful?
2 out of 2 found this helpful

Comments

0 comments

Please sign in to leave a comment.