Setting up the Microsoft SharePoint web part
  • 13 Sep 2022
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Setting up the Microsoft SharePoint web part

  • Dark
    Light
  • PDF

Liquit Workspace 3.4 or higher is recommended to use the Liquit Workspace SharePoint Webpart.

The Microsoft SharePoint Webpart allows SharePoint to show Liquit applications with an improved user experience . After downloading the sppkg, the contents should be distributed via the app catalog of the target tennant.

You can find the SharePoint Webpart on the download page.

When you add the Liquit Workspace SharePoint Webpart the first time to your Workspace the following screen will be shown:

Initial setup.png

To make changes to the SharePoint webpart you need to edit it, to do this, hover over the Liquit SharePoint Webpart and click on the pencil icon illustrated below:

pencil

When clicked the property pane will become available to you, there are sever al options available. Below is a list of properties and what their respective functionality is.

Configuration options

Settings

Name Description Pane Default value
Zone The FQDN on which the targeted Liquit Workspace zone can be found (e.g. workspace.liquit.com) Connection
Identity source The identity source needed to authenticate, you need to select a shared identity source for this, if you have for example Azure Active Directory setup this would be an ideal choice. The name should correspond with the name in Liquit Workspace. Connection
Title An optional title to be shown above the Liquit Workspace Microsoft SharePoint webpart. When you use a “Classic” SharePoint page to display the webpart Microsoft SharePoint will automatically prepend the Webpart with the title “Liquit Workspace”. Layout
Show title When switched on this switch will configure to display the configured title Layout Off
Show This dropdown allows you to select the desired view, you can switch between a catalog or workspace view. Layout Workspace
Icon Size Allows you to select the desired icon size, the following options are available:
  • Small Shows small icons
  • Medium Shows medium icons
  • Large Shows large icons
Layout Small
Sorting Allows you to set the default sorting, the following options are available:
  • No sorting Reverts back to the user defined sorting.
  • Sort ascending Sorts the applications on ascending alphabetical order.
  • Sort descending Sorts the applications on descending alphabetical order.
  • Sort on popularity (user) Sorts the applications on how many times the user has initiated an application. This is only available on Liquit Workspace Server 3.4 and up.
  • Sort on usage Sorts the applications on usage, the last used application will appear first followed by the second last used and so on.This is only available on Liquit Workspace Server 3.4 and up.
Layout No sorting
Show apps as tiles When switched on the application icons will be rendered as tiles. Layout Off
Theme Allows you to select your desired theme, these are based on the SharePoint site themes. The following options are available:
  • Light theme a theme that uses the SharePoint site theme’s defined light colors.
  • Dark theme a theme that uses the SharePoint site theme’s defined dark colors.
Layout Light theme
Filters Defines whether or not filters should be displayed in the Liquit Workspace Microsoft SharePoint Webpart. Filters On
Use pop up authentication This enables the popup authentication, this should be used when it is not guaranteed a session is available in Liquit Workspace 3.4. This requires a minimum of Liquit Workspace Server 3.4. Advanced Off

Security settings

When you have enabled Content Security Policy (CSP) and/or Cross-Origin Resource Sharing within your Liquit Workspace zone it is important that you add the entries shown below to the websites. This will ensure the Microsoft SharePoint is able to communicate with your Liquit Workspace zone:

Website: [your SharePoint tenant]-*.sharepoint.com

If you want to more specific you can enhance this even further, making the scheme like so:
Website: [your SharePoint tenant]-[app-id].sharepoint.com

image.png

Viva Connections

It is also possible to use the SharePoint wb part to be used in Viva Connections. You can do this by setting up Viva Connections and add the Liquit SharePoint web part to the chosen page.


Was this article helpful?