Scan Viewer (UI Element) - Revision history

Dgreenwood at 15:50, 13 April 2026

2026-04-13T15:50:28Z

← Older revision		Revision as of 10:50, 13 April 2026
Line 29:		Line 29:
	* Scanned images will be refused if using an HTTP address.		* Scanned images will be refused if using an HTTP address.
	''Design users and administrators:''		''Design users and administrators:''
	* ~~A self-signed certificate on the Grooper web server should be sufficient for scenarios where Grooper is isolated to your own network.~~		* '''At minimum''' a [[Install_and_Setup#How to create and bind a self-signed certificate\|self-signed certificate]] must be installed on the Grooper web server. ''This is generally acceptable for test environments.''
	* For information on how to create and bind a ~~self-signed certificate,~~ [[Install_and_Setup#How to create and bind a self-signed certificate\|~~review this part of~~ the ~~Install and Setup article~~.]]		* '''Best practice:''' Use an internally issued certificate managed by your organization's IT.
	\|}		\|}

Dgreenwood: /* Installing Grooper Desktop */

2026-01-13T14:30:21Z

Installing Grooper Desktop

← Older revision		Revision as of 09:30, 13 January 2026
Line 41:		Line 41:
	* Grooper Desktop must be running (started) in order to scan.		* Grooper Desktop must be running (started) in order to scan.
	* Once installed, users will use the Review activity's "Scan Viewer" to scan documents into Grooper.		* Once installed, users will use the Review activity's "Scan Viewer" to scan documents into Grooper.
	* Grooper Desktop drives the scanner from the Scan Viewer. It ~~starts and stops the scanner~~ from the ~~Scan Viewer UI~~. It ~~"listens" for~~ images ~~being scanned and sends them~~ to the Grooper Repository.		* Grooper Desktop is performs three core functions:
			** It drives and manages the document scanner from the Scan Viewer.
			** It listens on a designated local port for communication from the scanner’s capture components, receiving scan data as it is produced.
			** It uploads the scanned images to the Grooper Repository hosted on the Grooper web server.
	{{#lst:Install and Setup\|antivirus_advice}}		{{#lst:Install and Setup\|antivirus_advice}}
	<big>To install Grooper Desktop:</big>		<big>To install Grooper Desktop:</big>

Dgreenwood: /* Encountering "Unable to load Grooper.HPC.dll" and "Grooper.HPC.dll not found" errors */

2026-01-13T14:23:55Z

Encountering "Unable to load Grooper.HPC.dll" and "Grooper.HPC.dll not found" errors

← Older revision		Revision as of 09:23, 13 January 2026
Line 594:		Line 594:
	** For most scenarios, a self-signed certificate is sufficient to connect using HTTPS. For information on how to create and bind a self-signed certificate to the Grooper website, [[Install_and_Setup#How to create and bind a self-signed certificate\|review this part of the Install and Setup article.]]		** For most scenarios, a self-signed certificate is sufficient to connect using HTTPS. For information on how to create and bind a self-signed certificate to the Grooper website, [[Install_and_Setup#How to create and bind a self-signed certificate\|review this part of the Install and Setup article.]]

	=== Encountering "Unable to load Grooper.HPC.dll~~" and "Grooper.HPC.dll not found~~" errors ===		=== Encountering "Unable to load Grooper.HPC.dll" errors ===

	These errors can crop up in multiple contexts in Grooper. However, it is most commonly encountered during scanning. These errors most commonly occurs due to:		These errors can crop up in multiple contexts in Grooper. However, it is most commonly encountered during scanning. These errors most commonly occurs due to:

Dgreenwood: /* The Scan Viewer for end-users */

2026-01-13T14:22:20Z

The Scan Viewer for end-users

← Older revision		Revision as of 09:22, 13 January 2026
Line 110:		Line 110:
	⚠		⚠
	\|		\|
	'''''BE AWARE: For Grooper Desktop to scan to the Grooper web server, ~~you must~~ connect securely in the browser (HTTPS).'''''		'''''BE AWARE: For Grooper Desktop to scan to the Grooper web server, it is best practice to connect securely in the browser (HTTPS).'''''

	''All users:''		''All users:''
	* Always use HTTPS to connect to the Grooper web app.		* Always use HTTPS to connect to the Grooper web app.
	* NEVER use HTTP to connect to the Grooper web app.		* NEVER use HTTP to connect to the Grooper web app.
	* Scanned images ~~will~~ be refused if using an HTTP address.		* Scanned images may be refused by your organization's browser policies if using an HTTP address.
	''Design users and administrators:''		''Design users and administrators:''
	* A self-signed certificate on the Grooper web server should be sufficient for scenarios where Grooper is isolated to your own network.		* A self-signed certificate on the Grooper web server should be sufficient for scenarios where Grooper is isolated to your own network.

Dgreenwood: /* Troubleshooting */

2026-01-13T14:21:58Z

Troubleshooting

← Older revision		Revision as of 09:21, 13 January 2026
Line 495:		Line 495:
	⚠		⚠
	\|		\|
	'''''BE AWARE: For Grooper Desktop to scan to the Grooper web server, ~~you must~~ connect securely in the browser (HTTPS).'''''		'''''BE AWARE: For Grooper Desktop to scan to the Grooper web server, it is best practice to connect securely in the browser (HTTPS).'''''

	''All users:''		''All users:''
	* Always use HTTPS to connect to the Grooper web app.		* Always use HTTPS to connect to the Grooper web app.
	* NEVER use HTTP to connect to the Grooper web app.		* NEVER use HTTP to connect to the Grooper web app.
	* Scanned images ~~will~~ be refused if using an HTTP address.		* Scanned images may be refused by your organization's browser policies if using an HTTP address.
	''Design users and administrators:''		''Design users and administrators:''
	* A self-signed certificate on the Grooper web server should be sufficient for scenarios where Grooper is isolated to your own network.		* A self-signed certificate on the Grooper web server should be sufficient for scenarios where Grooper is isolated to your own network.

Dgreenwood: /* Verifying Grooper Desktop is communicating with the Grooper web server */

2026-01-12T22:44:40Z

Verifying Grooper Desktop is communicating with the Grooper web server

← Older revision		Revision as of 17:44, 12 January 2026
Line 583:		Line 583:
	To send images to the Grooper web server, Grooper Desktop (installed on a user's workstation) must be able to communicate with the web server via the Grooper web app launched from your browser.		To send images to the Grooper web server, Grooper Desktop (installed on a user's workstation) must be able to communicate with the web server via the Grooper web app launched from your browser.

	[[File:2025 ScanViewer 03 Troubleshooting-01.png\|right\|thumb\|600px\|If Grooper Desktop is running, these errors may indicate your browser is denying traffic ~~from Grooper Desktop to the Grooper web server~~.]]		[[File:2025 ScanViewer 03 Troubleshooting-01.png\|right\|thumb\|600px\|If Grooper Desktop is running, these errors may indicate your browser is denying traffic.]]

	If your '''browser''' is denying traffic from Grooper Desktop to the Grooper web server, you will see a series of connection errors in the browser console.		If your '''browser''' is denying traffic from Grooper Desktop to the Grooper web server, you will see a series of connection errors in the browser console.
	* To open the console on Chromium browsers (Chrome & Edge) press <kbd>Ctrl + Shift + J</kbd> on your keyboard.		* To open the console on Chromium browsers (Chrome & Edge) press <kbd>Ctrl + Shift + J</kbd> on your keyboard.
	* If the browser is denying traffic, you will see the following error:		* If the browser is denying traffic, you will see the following error in the console when the Scan Viewer is open:
	** <code><nowiki>~~POST http://localhost:13950/scanner/ping~~ net::~~ERR_CONNECTION REFUSED~~</nowiki></code>		** <code><nowiki>net::ERR_CONNECTION_REFUSED</nowiki></code>
	**<li class="attn-bullet"> ~~Make sure~~ Grooper Desktop is running ~~first. This error~~ will ~~also occur in the browser if the service is not running~~.		**<li class="attn-bullet"> Be aware, if Grooper Desktop is '''not''' running, the same errors will appear for a different reason.
	* ~~Your~~ browser is managed by your organization~~. They will determine~~ what traffic is ~~allowable from a browser~~.		* If your browser is managed by your organization, they control what traffic is and is not allowed.
	** The most common solution for this issue is simply to connect to the Grooper app securely using HTTPS instead of HTTP.		** The most common solution for this issue is simply to connect to the Grooper app securely using HTTPS instead of HTTP because many enterprise browsers block insecure localhost traffic.
	** For most scenarios, a self-signed certificate is sufficient to connect using HTTPS. For information on how to create and bind a self-signed certificate to the Grooper website, [[Install_and_Setup#How to create and bind a self-signed certificate\|review this part of the Install and Setup article.]]		** For most scenarios, a self-signed certificate is sufficient to connect using HTTPS. For information on how to create and bind a self-signed certificate to the Grooper website, [[Install_and_Setup#How to create and bind a self-signed certificate\|review this part of the Install and Setup article.]]

Dgreenwood: /* Verifying Grooper Desktop is communicating with the Grooper web server */

2026-01-12T22:35:06Z

Verifying Grooper Desktop is communicating with the Grooper web server

← Older revision		Revision as of 17:35, 12 January 2026
Line 592:		Line 592:
	* Your browser is managed by your organization. They will determine what traffic is allowable from a browser.		* Your browser is managed by your organization. They will determine what traffic is allowable from a browser.
	** The most common solution for this issue is simply to connect to the Grooper app securely using HTTPS instead of HTTP.		** The most common solution for this issue is simply to connect to the Grooper app securely using HTTPS instead of HTTP.
	** ~~You can~~		** For most scenarios, a self-signed certificate is sufficient to connect using HTTPS. For information on how to create and bind a self-signed certificate to the Grooper website, [[Install_and_Setup#How to create and bind a self-signed certificate\|review this part of the Install and Setup article.]]

	=== Encountering "Unable to load Grooper.HPC.dll" and "Grooper.HPC.dll not found" errors ===		=== Encountering "Unable to load Grooper.HPC.dll" and "Grooper.HPC.dll not found" errors ===

Dgreenwood: /* Verifying Grooper Desktop is communicating with the Grooper web server */

2026-01-12T22:33:27Z

Verifying Grooper Desktop is communicating with the Grooper web server

← Older revision		Revision as of 17:33, 12 January 2026
Line 582:		Line 582:

	To send images to the Grooper web server, Grooper Desktop (installed on a user's workstation) must be able to communicate with the web server via the Grooper web app launched from your browser.		To send images to the Grooper web server, Grooper Desktop (installed on a user's workstation) must be able to communicate with the web server via the Grooper web app launched from your browser.
	:*<li class="~~fyi~~-bullet"> ~~Example: The~~ Grooper ~~web server~~ will ~~deny traffic~~ if ~~users attempt to use an HTTP URL when operating~~ the ~~Scan Viewer~~. ~~You should always use HTTPS~~ to connect to the Grooper ~~web~~ app.
			[[File:2025 ScanViewer 03 Troubleshooting-01.png\|right\|thumb\|600px\|If Grooper Desktop is running, these errors may indicate your browser is denying traffic from Grooper Desktop to the Grooper web server.]]

			If your '''browser''' is denying traffic from Grooper Desktop to the Grooper web server, you will see a series of connection errors in the browser console.
			* To open the console on Chromium browsers (Chrome & Edge) press <kbd>Ctrl + Shift + J</kbd> on your keyboard.
			* If the browser is denying traffic, you will see the following error:
			** <code><nowiki>POST http://localhost:13950/scanner/ping net::ERR_CONNECTION REFUSED</nowiki></code>
			**<li class="attn-bullet"> Make sure Grooper Desktop is running first. This error will also occur in the browser if the service is not running.
			* Your browser is managed by your organization. They will determine what traffic is allowable from a browser.
			** The most common solution for this issue is simply to connect to the Grooper app securely using HTTPS instead of HTTP.
			** You can

	=== Encountering "Unable to load Grooper.HPC.dll" and "Grooper.HPC.dll not found" errors ===		=== Encountering "Unable to load Grooper.HPC.dll" and "Grooper.HPC.dll not found" errors ===

Dgreenwood: /* Verifying Grooper Desktop is communicating with the Grooper web server */

2026-01-12T20:31:46Z

Verifying Grooper Desktop is communicating with the Grooper web server

← Older revision		Revision as of 15:31, 12 January 2026
Line 581:		Line 581:
	* '''It uploads the scanned images to the Grooper Repository hosted on the Grooper web server.'''		* '''It uploads the scanned images to the Grooper Repository hosted on the Grooper web server.'''

	To send images to the Grooper web server, Grooper Desktop (installed on a user's workstation) must be able to communicate with the web server.		To send images to the Grooper web server, Grooper Desktop (installed on a user's workstation) must be able to communicate with the web server via the Grooper web app launched from your browser.
	:*<li class="fyi-bullet"> Example: The Grooper web server will deny traffic if users attempt to use an HTTP URL when operating the Scan Viewer. You should always use HTTPS to connect to the Grooper web app.		:*<li class="fyi-bullet"> Example: The Grooper web server will deny traffic if users attempt to use an HTTP URL when operating the Scan Viewer. You should always use HTTPS to connect to the Grooper web app.

Dgreenwood: /* Verifying Grooper Desktop has reserved URLs */

2026-01-12T18:00:22Z

Verifying Grooper Desktop has reserved URLs

@@ Line 527: / Line 527: @@
 If you need to use a different port, replace <code>13950</code> with the port number you want to assign.
-==== Verifying Grooper Desktop is communicating with the Grooper web server ====
+=== Verifying Grooper Desktop is listening and actively being used ===
 Grooper Desktop is a service that performs three core functions:
 * It drives and manages the document scanner when used from the Grooper Scan Viewer.
 * It listens on a designated local port for communication from the scanner’s capture components, receiving scan data as it is produced.
-* It uploads the scanned images to the Grooper Repository hosted on the Grooper web server.
+* '''It uploads the scanned images to the Grooper Repository hosted on the Grooper web server.'''
 To send images to the Grooper web server, Grooper Desktop (installed on a user's workstation) must be able to communicate with the web server.