OnBase: PDF documents fail to load in the Web Client after upgrading to version 25.1.3.1000 or higher
Description
After upgrading to OnBase 25.1.3.1000 or higher, PDFs Documents does not load in the OnBase Web Client. Instead, only the gray loading screen is displayed, and the thumbnail appears with a red X.
The following screenshot demonstrates the behavior:
Resolution
This issue occurs due to a security vulnerability with the Hyland Rendering and Conversion Service (HyRCS), which is a component of the OnBase Application Server used for rendering PDFs. A change was made to the OnBase Application Server to require .NET 8 to be installed alongside the existing requirement of the .NET Framework.
This change is important because it is the first time that the OnBase Application Server has a requirement of .NET. Note that the .NET Framework is not the same as .NET. Going forward, the OnBase Application Server will have both a .NET Framework version requirement and a .NET version requirement. This change is applicable to OnBase 25.1.3.1000 and higher, along with future version releases.
To resolve this issue, ensure that .NET 8 is installed on the machine running the OnBase Application Server. This is required to display PDFs within the OnBase Web Client. It is highly recommended in OnBase 25.1 environments to install .NET 8 on the OnBase Application Server (see the below section for more information). Follow best practices to ensure the .NET Framework and .NET 8 runtimes are regularly updated as Microsoft releases security patches.
Installing .NET 8
Unlike .NET Framework that is included with the Windows OS, .NET 8 is distributed separately and may need to be installed if it is not already present. .NET 8 can be installed via an installer, WinGet, or other application deployment mechanism. Refer to Download .NET 8.0 (Linux, macOS, and Windows).
Related Articles
Cost of PDF Frameworks
Customer was looking for Price of PDF Framworks $1800 annually, minimum 3 year subscription, plus maintenance.OnBase Reference Guide
OnBase Reference Guide MRGOnBase: Blank screen when attempting to view Epic Documents in Web Client after installing Web Server
Description After a new installation of Web Server, when attempting to view documents from Epic in OnBase Web Client, a blank screen is presented: Additionally, when attempting to view the document directly through Epic Media Manager, a blank screen ...OnBase: Redaction button will not stay selected in the Web Client
Description In OnBase 18 Web Client, when opening a document within the Legacy Viewer (ActiveX), it is possible to select the redaction button once and continue adding redactions one after another. However, in OnBase Foundation Web Client it is ...OnBase: Logins from Web Client are logged as Core Services instead of HTML Web Client in the hsi.securitylog file when using IdP authentication
Description When a user logs into the Web Client using IdP authentication, the event logged in the hsi.securitylog file is Core Services instead of HTML Web Client. The event is logged as HTML Web Client when using authentication other than IdP, such ...