Top
SharePoint Integration Process
  • 28 Feb 2024
  • 3 Minutes To Read
  • Dark
    Light
  • PDF

SharePoint Integration Process

  • Dark
    Light
  • PDF

Article Summary

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 Full Access using One-click Integration

your title goes here

With one-click integration, Whatfix crawls content only from the subsites that you specify but still has access to other subsites in your Repository.

  1. On the Whatfix Guidance dashboard, click Settings.
    ia_left_nav_settings

  2. Click Repositories.
    ia_left%20nav_repositories%20

  1. Click the SharePoint tile.
    RB_DB_CaggintegrateSP

  2. Enter a title and the URL of your SharePoint Repository.
    RB_DB_reposharepoint

Info

The title you provide here is used as the tag name for the default tag attached to all the content fetched.

  1. Click Next.
    RB_DB_reponextSP

  2. Select the type of SharePoint content that you want to fetch from the repository and then click + Add.
    RB_DB_repoSPaddbutton

your title goes here

You can add multiple content types to integrate.

  1. 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
Note

To know how to generate this information in your SharePoint application, see Generating information for SharePoint subsite integration.

  1. Click Integrate.
    RB_DB_repointegrateSP

  2. Once the SharePoint login page loads, enter your credentials and then click Log In.

Note
  • After you have created an Integration request, your Repository is listed under Integrated Applications in the Processing state.
    SP_processing_state
  • Once all the content is indexed, you can access them on the Whatfix Dashboard.
    RB_DB_CRclickrepo
  • 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.
    RB_DB_CaggSavedasdraft
your title goes here

If you face any issues while integrating, contact support@whatfix.com.

With Restricted Access

your title goes here

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
your title goes here

Use the following steps to create a SharePoint integration,

  1. On the Whatfix Guidance dashboard, click Settings.
    ia_left_nav_settings

  2. Click Repositories.
    ia_left%20nav_repositories%20

  1. Click the SharePoint tile.
    RB_DB_CaggintegrateSP

  2. Enter a title and the URL of your SharePoint Repository.
    RB_DB_reposharepoint

Info

The title you provide here is used as the tag name for the default tag attached to all the content fetched.

  1. Select the checkbox to restrict access to the sub-site.
    RB_DB_repoclickfraccessSP

  2. Click Next.

  3. Enter the Client ID and Client Secret in the respective fields.
    RB_DB_repoclientinfo

  4. Click Next.
    RB_DB_reponextSP

  5. Select the type of SharePoint content that you want to fetch from the repository and then click the + Add button.
    RB_DB_repoSPaddbutton

your title goes here

You can add multiple content types to integrate.

  1. 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
    integ.png
Note

To know how to generate this information in your SharePoint application, see Generating information for SharePoint subsite integration.

  1. Click Integrate.
    RB_DB_repointegrateSP

  2. Once the SharePoint login page loads, enter your credentials and then click Log In.

Note
  • After you have created an Integration request, your Repository is listed under Integrated Applications in the Processing state.
    SP_processing_state

  • Depending on how big your Repository is, the content sync might take between 24 - 72 hours to complete.
    RB_DB_CRclickrepo

  • 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.

your title goes here

If you face any issues while integrating, contact support@whatfix.com.


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.