Configure Shopping Cart Printing¶

With shopping cart printing, the user can print from any application on the local workstation via the Windows print dialog directly into SEAL Operator. For this, you have to install Windows Integration from SEAL Systems on the local workstation.

Up to Windows Integration 4.2.x, a PowerShell script is used for the interaction with SEAL Operator. As of Windows Intergration 4.3.0, the SEAL OP-CLI script shopping-cart is used for this.

For more information about SEAL OP-CLI, refer to the SEAL OP-CLI documentation.

Installation of Windows Integration 4.3.0, SEAL OP-CLI Script¶

Hint - test before integration

If SEAL OP-CLI has been misconfigured, for example, when the OIDC configuration is not valid, the call of SEAL OP-CLI might not terminate. In the shell, you can abort it by pressing Ctrl-C.

If SEAL OP-CLI is called within Windows Integration (WD), the job is displayed as erroneous in the queue but cannot be deleted from there. For aborting the SEAL OP-CLI, the Node process belonging to the SEAL OP-CLI call has to be killed manually in the process list via Task Manager.

Call a SEAL OP-CLI script in the shell before integration. This way, you ensure that the configuration of SEAL OP-CLI is correct.

Install SEAL OP-CLI on the local workstation. For more information, refer to the SEAL OP-CLI documentation.
Contact your Technical Project Manager at SEAL Systems to get Windows Integration version 4.3.0 or higher.
Copy the Windows Integration installation files to any directory on the local workstation that you want to use shopping cart printing with.

Hint - no blanks

The path of the directory with the installation files must not contain blanks! Otherwise, the installation script will fail.

Edit the following file:

<windows_integration_install_dir>\install\wd\install-spc-printer.customer.bat

Search for the following keys and specify the needed information:
- SERVERNAME: name of the SEAL Operator server (only the server name without URL or port number)
- SPC_INSTALLDIR: installation directory unless SEAL OP-CLI has been installed in the <windows_integration_install_dir>\install\wd\ directory
- CLIENT_ID: client ID unless the default client ID is used for the --auth-client-id of the shopping-cart script
- CLIENT_SECRET: client secret unless the default client secret is used for the --auth-client-secret parameter of the shopping-cart script
- LOGLEVEL: specify the log level used for the shopping-cart script; available values are debug, error, info or warn, default value is info
hint - defaults

The defaults for CLIENT_ID and CLIENT_SECRET are the values specified in the SEAL-specific Keycloak installation. For more information, refer to the SEAL Interfaces for OIDC documentation.

hint - environment variables

CLIENT_ID and CLIENT_SECRET can also be specified as environment variables. For more information, refer to Configure the OIDC Settings.

hint - AUTH_ISSUER_URL environment variable

To reduce the network load a bit, specify the issuer URL with the AUTH_ISSUER_URL environment variable. If it is specified, SEAL OP-CLI will not request the URL from SEAL Operator with each call.
Save the file.
Open a Command Prompt (Administrator) and change to the following directory:
```
cd <windows_integration_install_dir>\install\wd\
```
Execute the installation script:
```
install-spc-printer.bat
```
As result, the SEAL Master Driver and two printers for shopping cart printing will be installed on the local workstation:
- SPC Office Dialog printer for small-sized MS Office documents in formats such as DIN A4 or letter
- SPC CAD Dialog printer for larger documents in formats such as DIN A0, ANSI E or larger
In the OIDC identity provider, configure the redirection URLs if necessary. They should contain the server name of the SEAL Operator server as defined before in the key SERVERNAME. If Keycloak is used as OIDC identity provider, refer to the SEAL Interfaces for OIDC documentation for this.
hint - standard specification of Valid Redirect URIs in Keycloak

For the seal-print-client client:
- https://localhost:3000/*
- https://<operator_server>:3000/*
For the seal-opcli client:
- https://localhost:1234/*

When printing a document via one of the installed shopping cart printers, the document is uploaded into the My Documents panel. If it doesn't exist yet, the PLOSSYS Pool panel will be generated containing the document. Otherwise the document will be added to the list in the panel.

Hint - log and error messages

SEAL OP-CLI writes all messages to stderr and the result in JSON format to stdout.

To avoid that an extra window is opened for the messages output to stdout and stderr, Show window in the port monitor dialog has been deactivated.

To redirect the messages and results into files, expand the script call in the following script:

<opcli_install_dir>\cmd\opcli.bat

To append the log messages to a file, expand the call as follows:

"%~dp0..\node.exe" "--no-warnings" "%~dp0..\bin\opcli" %* 2>> %TEMP%\opcli-shopping-cart.log

To append the log messages and the result to a file, expand the call as follows:

"%~dp0..\node.exe" "--no-warnings" "%~dp0..\bin\opcli" %* 2>> %TEMP%\opcli-shopping-cart.log 2>&1

To append the log message to a file and writing the result in another file without appending, expand the call as follows:

"%~dp0..\node.exe" "--no-warnings" "%~dp0..\bin\opcli" %* 2>> %TEMP%\opcli-shopping-cart.log 1> %TEMP%\opcli-shopping-cart.json

Installation of Windows Integration 4.2.x, PowerShell Script¶

Contact your Technical Project Manager at SEAL Systems to get Windows Integration version 4.2.x.
Copy the Windows Integration installation files to any directory on the local workstation that you want to use shopping cart printing with.

Hint - no blanks

The path of the directory with the installation files must not contain blanks! Otherwise, the installation script will fail.

Edit the following file:

<windows_integration_install_dir>\install\wd\install-spc-printer.customer.bat

Search for the following key and specify the needed information:
- SERVERNAME: name of the SEAL Operator server (only the server name without URL or port number)
Save the file.
Open a Command Prompt (Administrator) and change to the following directory:
```
cd <windows_integration_install_dir>\install\wd\
```
Execute the installation script:
```
install-spc-printer.bat
```
As result, the SEAL Master Driver and two printers for shopping cart printing are installed on the local workstation:
- SPC Office Dialog printer for small-sized MS Office documents in formats such as DIN A4 or letter
- SPC CAD Dialog printer for larger documents in formats such as DIN A0, ANSI E or larger
In the OIDC identity provider, configure the redirection URLs if necessary. They should contain the server name of the SEAL Operator server as defined before in the key SERVERNAME. If Keycloak is used as OIDC identity provider, refer to the SEAL Interfaces for OIDC documentation for this.

When printing a document via one of the installed shopping cart printers, the document is uploaded into the My Documents panel. If it doesn't exist yet, the PLOSSYS 4 Pool panel will be generated containing the document. Otherwise the document will be added to the list in the panel.

Hint - logfile

Messages concerning the shopping cart printing are logged into the following file on the local workstation:

<user_home_directory>\AppData\Roaming\SEAL Systems\Operator\log\sealmon2operator.log