An important message to our customers about the current COVID-19/Coronavirus situation. LEARN MORE.
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
GET
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
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?
Uncaught ReferenceError: viewLabel is not defined
This error indicates that the language property in the viewer initialization has not been specified or is undefined.
language
To fix this, ensure you are loading viewerCustomizations.js.
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.
template
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.
How do I store and retrieve documents in subdirectories of the configured documents directory in PrizmDoc PAS?
You can retrieve documents from subdirectories when dealing with local files. Simply pass the subfolder in the fileName parameter when creating the viewing session. You can test this by manually placing a document inside a subfolder and making the following POST request:
fileName
POST
`http://localhost:3000/ViewingSession` { "source": { "type": "document" "fileName": "folder/document.pdf" } }
How do I get Viewing Packages working in PrizmDoc?
Viewing Package Full Setup Instructions
We recommend pre-converting documents through a feature called viewing packages and it can be turned on in PAS Configuration.
viewingPackages – default: disabled – Enable Pre-Conversion Services and APIs, which allow you to pre-convert documents and cache on-demand document views in PAS, to improve the speed at which documents can be viewed, as well as reduce the processing time in PrizmDoc Server for repeat document views.
default: disabled
Enable Viewing Packages Feature
feature.viewingPackages: enabled
Since viewing packages also use a database you will need to create a database for PAS, configure a database, and run the scripts that are included to create the tables necessary for viewing packages to work.
Configuring Database
Install Microsoft SQL Express
Note 1: If you have Visual Studio installed, you might have to uninstall the recent versions of C++ that are installed before MSSQL Express will successfully install.
Remove Visual Studio C++ Redistributables
Note 2: When installing, use all default install settings except for setting a custom database instance id and set mixed mode authentication so a custom password can be set.
Turn On TCP/IP For Database Instance
Step 1:
Step 2:
Set Port 1433 for TCP/IP Connection
Restart SQL Express Instance
Right-click and select "Restart" or double-click and select "Restart".
"Restart"
Install Microsoft SQL Management Studio
Install from this downloads page
Connect To Database Instance In Microsoft SQL Management Studio
Create A Database In Microsoft SQL Management Studio
PAS Config Database Settings
feature.viewingPackages: "enabled" database.adapter: "sqlserver" database.host: "localhost" database.port: 1433 database.user: "sa" database.password: "Password1" database.database: "prizmdb" # Default timeout for the duration of a viewing session defaults.viewingSessionTimeout: "20m" viewingPackagesData.storage: "database" viewingPackagesProcesses.storage: "database" viewingSessionsData.storage: "database" viewingSessionsProcessesMetadata.storage: "database" viewingPackagesArtifactsMetadata.storage: "database" viewingPackagesArtifacts.storage: "filesystem" viewingPackagesArtifacts.path: "%ALLUSERSPROFILE%\\Accusoft\\Prizm\\ViewingPackages"
Create the database tables
Restart PAS
Create Viewing Package
Get State of Viewing Package Creator Processing
Get Viewing Package Info With Document Id
Create Viewing Session From Viewing Package With Document Id
View Document In Viewing Package With The Created Viewing Session Id
For examples of creating viewing packages, click on the link below to see the various ways of using them:
Viewing Package Creators
I have a PDF of a form that I’m sending to PrizmDoc to have it auto-detect, but PrizmDoc does not find any fields in the document. What would cause this?
Currently only PDF files with embedded AcroForms will be auto-detected. If the PDF document has an embedded image of a form, PrizmDoc will not find any results from auto-detection.
With a fully-running PrizmDoc environment (version prior to v10.5), I’m noticing times where the system becomes unresponsive. That is, at some point, it no longer processes requests being made to the backend and I have to restart PrizmDoc in order to alleviate it. What could be causing this?
Prior to version 10.5, PrizmDoc used ProxyServer as its image processing system. Our Development Team eventually began seeing that the ProxyServer exhibited architectural problems that lead to a multitude of issues, such as unresponsiveness.
Starting in version 10.5, the Development Team created the Prizm Content Connect Imaging Service (PCCIS), which is far more stable.
To resolve this issue we suggest upgrading to the latest revision of PrizmDoc. Please see the product page for more information found here: https://www.accusoft.com/products/prizmdoc/overview/
When specifying the Amazon AWS access keys or IAM Role associated to the S3 bucket, what are the minimum necessary rights that I need to have for licensing to function?
The security policy associated to the IAM Role or User who has access to the S3 bucket needs to contain specific S3 bucket rights below:
listObjects
putObject
deleteObjects
Are there any specific applications or folders which should be excluded in order for PrizmDoc to work on a system with antivirus software?
As a suggestion, the first place to start would be your antivirus logs to ensure there are no entries specific to the following services:
conhost.exe
node.exe
policyhost.exe
PrizmApplicationServices.exe
wmiprvse.exe
If there are, you can exclude those files or the following folders where PrizmDoc is installed by default. If you modified the folder name for PrizmDoc, ensure to include that name.
C:\Prizm
C:\ProgramData\Accusoft
Please consult your antivirus documentation for instructions on how to add exclusions.
If I have a PDF document that only has an embedded image in it (no text objects, etc.), can PrizmDoc Viewer take it and create a searchable PDF file from it?
Yes. PrizmDoc’s Content Conversion Services can take an image-only PDF and create a searchable PDF file from it. This can be done by modifying the input.dest.pdfOptions.ocr options object; see our documentation here.
input.dest.pdfOptions.ocr
If you are attempting to make a searchable PDF from an existing PDF document, please note that the source PDF file should be an image-only PDF. PrizmDoc will not create a searchable file from already-existing vector content.
This feature was introduced in PrizmDoc 13.1, please see our Release Notes for more information.