This page contains Dispatcher Paragon end user interface documentation for administrators. 

Installation

Dispatcher Paragon end user interface is installed automatically, no configuration is necessary.

Dispatcher Paragon end user interface installer will create:

  • Windows service Dispatcher Paragon end user interface
  • Web interface accessible via default URL https://<SPOC_HOST>:9443/end-user/ui
  • Default installation directory in <install_dir>\SPOC\EUI\

Enable Dispatcher Paragon end user interface features

If you want to use all of the Dispatcher Paragon end user interface features, you have to configure Dispatcher Paragon Payment System and YSoft SafeQ Mobile Print Server in the Dispatcher Paragon management interface. Payment gateways need to be configured in Dispatcher Paragon Payment System.

Dispatcher Paragon Payment System

Install and enable YSoft Payment System in the Dispatcher Paragon management interface by setting the Enable YSoft Payment System configuration option (property name: enablePaymentSystem) to enabled.

When Enable YSoft Payment System option is disabled, Payment menu item, My deposit widget and user's balance are not visible in the Dispatcher Paragon end user interface.

Dispatcher Paragon Mobile Print Server

 Install and enable Dispatcher Paragon Mobile Print Server in the Dispatcher Paragon management interface by setting the Enable Mobile Print Server  option (Property name: enableMobilePrintServer ) to enabled.

When Enable Mobile Print Server option is disabled, Upload job menu item is not visible and users are not able to upload jobs via the Dispatcher Paragon end user interface web.

Processing of uploaded jobs

Files uploaded to the Dispatcher Paragon end user interface are further processed by other subsystems. Here is a rough description of the process:

  1. Files are physically saved into a hot folder on the Dispatcher Paragon end user interface server. Its default location is <install_dir>SPOC\server\mobile.
  2. Files are processed by Dispatcher Paragon Mobile Print Server and removed from the hot folder.
  3. Data are sent to Dispatcher Paragon FlexiSpooler (mode for server spooling).
  4. Dispatcher Paragon FlexiSpooler saves jobs data into folder <FLEXI_SPOOLER_HOME>\Service\JobStore\controller-<ID>\
  5. Job metadata are sent to Dispatcher Paragon Spooler Controller and YSoft Management.

Changing the hot folder

The path to the hot folder depends on the configuration of Dispatcher Paragon, Dispatcher Paragon end user interface and YSoft SafeQ Mobile Print Server. You can change the path to the hot folder by the following steps.

  1. Change Dispatcher Paragon system setting "Mobile Print Server spool directory" (alias mpsSpoolDir).
  2. Change the Dispatcher Paragon end user interface configuration "spoc.homeDirectory". See section Advanced configuration for more detail.
  3. Change the YSoft SafeQ Mobile Print Server configuration "folderSources".
  4. Here is example of final path "%safeq_home_directory%/server/mobile/" (home directory will be replaced by the value of "spoc.homeDirectory").

Payment gateways

Configure at least one payment gateway connector in Dispatcher Paragon Payment System (Electronic payment tab). After configuration, the users are able to use Payment gateways in the Dispatcher Paragon end user interface.

Supported payment gateways are:

(tick) PayPal

(tick) DIBS

Account connection

If you use an external payment system provider which needs a user's permission to access their account, the administrator needs to set up the provider's name and logo URL in Dispatcher Paragon Payment System administration. This name and logo are used in the Dispatcher Paragon end user interface in the Account connection menu.

Advanced configuration

If the Dispatcher Paragon end user interface is deployed on the same server as Dispatcher Paragon Spooler Controler (SPOC), no configuration is needed, everything is preconfigured.

Configuration of Dispatcher Paragon end user interface can be edited or added into environment-configuration.properties file located in <install_dir>\SPOC\EUI\ui-conf\

The following parameters are editable:

Element(s)

Description

restClient.yps.maxTotalConnections

Maximum number of simultaneous connections to Dispatcher Paragon Payment System. The default value is 200.

web.channel

Determines channel used by the web of Dispatcher Paragon end user interface. The default value is https. Valid values are http, https or any. Value https will force redirect from http to https channel.

web.http.port

Port for http channel. The default value is 9090.

web.https.port

Port for https channel. The default value is 9443.

safeq.authentication.address

Address for communication with Dispatcher Paragon. Default value is "tcp://127.0.0.1:5555".

spoc.homeDirectory

Path to the home directory of YSoft SafeQ Spooler Controler. This option is used for determining the hot folder location. The default value is "../..", which usually means <install_dir>\SPOC.

remoteService.callDurationThresholdInMillis

The threshold for calls to remote systems (Dispatcher Paragon Payment System and Dispatcher Paragon). When calls take longer a warning will be logged. Value is in milliseconds. The default value is 1000.


See also file C:\<install_dir>\SPOC\EUI\webapps\end-user\WEB-INF\classes\defaults.properties for all properties that can be customized in environment-configuration.properties file for a particular end user interface instance.

Customizable Error pages

Error pages can be customized for errors 403 Forbidden, 404 Not Found, and 500 Internal Server Error. It is possible to change an image, page title (text in the browser's tab), header, and error description.

If you want to know, where to configure customizable error pages, see section Advanced configuration.

Beware special characters and encoding. Properties files are by default encoded in ISO-8859-1. To convert special characters, use for example this tool.

Element

Description

              error.image

Image to be displayed on the error page - it can be anything, you just have to specify a folder of the image. Supported image files are: JPG, PNG, GIF and BMP.

              error.XXX.title
            
              error.XXX.header
            
              error.XXX.description

Title, header, and description of the error page

(XXX stands for the required error code - 403, 404, or 500)

Example of custom error pages:

##############################################################################################
# Error pages
##############################################################################################

#full path to custom image on error pages
error.image=C:/Users/administrator/Documents/EUI/src/main/resources/custom.png

#custom title, header and description for individual errors
error.403.title=Forbidden
error.403.header=Woops!
error.403.description=403 error
 
error.404.title=Not found
error.404.header=Woops!
error.404.description=You are looking where you shouldn't.

error.500.title=Internal Server Error
error.500.header=Woops!
error.500.description=Something went wrong.

Related documentation

Using the Dispatcher Paragon End User Interface