Web Part Error: This portlet encountered an error - Web Parts for Microsoft SharePoint - English - Foundation 23.1 - OnBase - external

Web Parts for Microsoft SharePoint

Platform
OnBase
Product
Web Parts for Microsoft SharePoint
Release
Foundation 23.1
License

When attempting to load OnBase Web Parts, users may encounter the following error:

  • This portlet encountered an error.

When attempting to load Workflow Web Parts, users may encounter the following error:

  • You have insufficient rights to a workflow queue in the portlet configuration.

Also, the following error may be logged to the Diagnostics Console:

  • Failed to get session for session id.

These errors indicate that users are not being authenticated properly. This issue is commonly caused by a mismatch between the Web Server URL provided in the OnBase DWP file and the dmsVirtualRoot value in the Web Server's Web.config.

The ContentLink URL provided in the OnBase DWP file is case sensitive—it must exactly match the value provided for the dmsVirtualRoot in the Web Server's Web.config.

If the information in the DWP file is incorrect, delete the DWP file from the SharePoint Web Part Gallery, make the appropriate changes to the file, and then re-upload the file to SharePoint. See or Web Part Upload & Activation (SharePoint 2019) for more information.