- 26 Aug 2024
- 3 Minutes To Read
-
Print
-
DarkLight
-
PDF
SharePoint Integration Process
- Updated On 26 Aug 2024
- 3 Minutes To Read
-
Print
-
DarkLight
-
PDF
Whatfix-SharePoint integration enables you to fetch and display articles in SharePoint as contextual links in the Self Help widget. You can fetch all the content or only articles in particular folders.
Use the following steps to integrate a SharePoint repository,
With one-click integration, Whatfix crawls content only from the subsites that you specify but still has access to other subsites in your Repository.
-
On the Whatfix Guidance dashboard, click Settings.
-
Click Repositories.
-
Click the SharePoint tile.
-
Enter a title and the URL of your SharePoint Repository.
The title you provide here is used as the tag name for the default tag attached to all the content fetched.
-
Click Next.
-
Select the type of SharePoint content that you want to fetch from the repository and then click + Add.
Add multiple content types to integrate.
- Based on the content type you select, enter the necessary
details in the fields that appear.
- Article- List Name
- Documents- List Name, Library Name, Folder Absolute Path (optional)
- Site Page- List Name
To know how to generate this information in your SharePoint application, see Generating information for SharePoint subsite integration.
-
Click Integrate.
-
Once the SharePoint login page loads, enter your credentials and then click Log In.
- After you have created an Integration request, your Repository is listed under Integrated Applications in the Processing state.
- Once all the content is indexed, you can access them on the Whatfix Dashboard.
- The content fetched can be added to the Self Help widget in the same way as you would add any other Whatfix content.
- If you have Smart Context enabled, you must add the global-page tag for the content to reflect in the Self Help widget on your application. For more information, see Add Repository Content to Self Help and Task List.
- If you click Cancel or close the integration pop-up, the integration request is Saved as a draft in the Integrated Repositories section.
If you face any issues while integrating, contact support@whatfix.com.
In this method of integration, Whatfix crawls and has access only to the subsites that you specify and not to any other subsites in your Repository.
To enable SharePoint integration with restricted access to subsites, you must first generate the following credentials and keep them handy.
- Client ID
- Client Secret Key
For more information, see Generating ClientID and SecretKey for SharePoint integration.
Use the following steps to create a SharePoint integration,
-
On the Whatfix Guidance dashboard, click Settings.
-
Click Repositories.
-
Click the SharePoint tile.
-
Enter a title and the URL of your SharePoint Repository.
The title you provide here is used as the tag name for the default tag attached to all the content fetched.
-
Select the checkbox to restrict access to the sub-site.
-
Click Next.
-
Enter the Client ID and Client Secret in the respective fields.
-
Click Next.
-
Select the type of SharePoint content that you want to fetch from the repository and then click the + Add button.
Add multiple content types to integrate.
- Based on the content type you select, enter the necessary
details in the fields that appear.
- Article- List Name
- Documents- List Name, Library Name, Folder Absolute Path (optional)
- Site Page- List Name
To know how to generate this information in your SharePoint application, see Generating information for SharePoint subsite integration.
-
Click Integrate.
-
Once the SharePoint login page loads, enter your credentials and then click Log In.
-
After you have created an Integration request, your Repository is listed under Integrated Applications in the Processing state.
-
Depending on how big your Repository is, the content sync might take between 24 - 72 hours to complete.
-
Once all the content is indexed, you can access them on the Whatfix Dashboard.
-
The content fetched can be added to the Self Help widget in the same way as you would add any other Whatfix content.
-
If you have Smart Context enabled, you must add the global-page tag for the content to reflect in the Self Help widget on your application. For more information, see Add Repository Content to Self Help and Task List.
-
If you click Cancel or close the integration pop-up, the integration request is Saved as a draft in the Integrated Repositories section.
If you face any issues while integrating, contact support@whatfix.com.