Technical FAQs for "PrizmDoc"

How can I verify that the services are running and healthy on a headless server?

You can use curl to make some simple GET requests to the endpoints that report service health:

curl -s http://localhost:18681/PCCIS/V1/Service/Current/Info

curl -s http://localhost:3000/health

curl -s http://localhost:3000/servicesConnection

If curl is unavailable you can use wget:

wget -qO- <URL>

I am receiving a 401 Unauthorized when trying to use PrizmDoc Cloud. What could be the issue?

This error is likely the result of neglecting to specify your API key.

To fix this, specify your API key in the headers of your request to create a viewing session.

I’m receiving Uncaught ReferenceError: viewLabel is not defined when trying to embed the PrizmDoc Viewer in my web application. What could be the issue?

This error indicates that the language property in the viewer initialization has not been specified or is undefined.

To fix this, ensure you are loading viewerCustomizations.js.

If the version you are working with predates viewerCustomizations.js, you can get a copy of viewerCustomizations.js from the viewer assets hosted here and update your viewer initialization code.

I’m receiving the error “Uncaught TypeError: Cannot read property ‘viewer’ of undefined” when trying to embed the PrizmDoc Viewer in my web application. What could be the issue?

This indicates that the template property in the viewer initialization has not been specified or is undefined.

To fix this, ensure you are loading viewerCustomizations.js.

If the version you are working with predates viewerCustomizations.js, you can get a copy of viewerCustomizations.js from the viewer assets, hosted here, and update your viewer initialization code.

On Windows, are there any restrictions on the type of account that I can install PrizmDoc under? If so, what are they?

The account that you install PrizmDoc under has to be part of the Local Administrators group. As the installer creates Windows services, administrative-level permissions are required.

What does it mean when I see “Email Address is not Registered” when entering in an email in the Evaluation Dialog?

You will see this error if you have not registered on the Accusoft website.

To register your email address, please visit the following link below:

https://my.accusoft.com/Account/FirstTimeUser?Length=7

Does viewing HTML in PrizmDoc Viewer allow JavaScript execution or local file access? Can PrizmDoc Viewer block externally-referenced content from being rendered?

When viewing HTML in PrizmDoc, JavaScript and local file access are disabled.

Additionally, you may configure the security.htmlRendering.blockExternalContent setting found in PrizmDoc’s Central Configuration file. When rendering any source document which uses HTML content, this setting controls whether or not externally-referenced content, such as images and iframes, will be blocked. This option affects any source document file type which uses HTML, including HTML, EML, and MSG.

When running setup.sh and entering the information for a node-locked license, such as configuration file, solution name, and solution key, the following error occurs:

The licensing configuration file you provided is invalid. Please retry
your request or break the licensing process:

What would cause this issue?

This issue may be caused by a trailing space on the configuration file copied to the Linux server.

To remove the space, run the following command, making sure to replace
configurationfilename with the name of your configuration file.

truncate -s -1 **configurationfilename**

For example:

truncate -s -1 /usr/share/prizm/licenseconfiguration.txt

Can I run PrizmDoc Viewer in a Windows Docker container?

No, you cannot run PrizmDoc Viewer in a Windows Docker container. This is because Windows Docker containers do not provide the full environment that a Virtual Machine or regular Windows system install provides.

However, this is not the same thing as using a Windows system as a Docker Host, which actually can run PrizmDoc Viewer in a Linux Docker container.

Why does my font look different when rendered in PrizmDoc Editor?

If the font in the document is not a font loaded on the server running PrizmDoc Editor, then Editor will attempt to substitute a font that is closest in appearance to the font used in the document.

Where can I find code samples for PrizmDoc Editor?

Code samples are embedded in the PrizmDoc Editor API documentation.

What server operating system do I need to run PrizmDoc Editor?

PrizmDoc Editor is delivered as docker image. You can run it on any docker host.