Skip to main content
Skip table of contents

Scan Workflow-related System Settings

CategoryLevelKeyDefault valueUsed byDescription
NETWORKExpertftp-port21Terminal ServerThe port used for FTP server communication.
NETWORKAdvancedftp-anonymoustrueTerminal Server

If enabled, anonymous login is allowed for FTP server authorization.

NETWORKAdvancedscanServerTypeWebDAV,HTTP,FTPTerminal Server

The transfer protocols allowed for scanned document transfer from an MFD to YSoft SafeQ. The possible values are:

  • "FTP" – for FTP protocol
  • "WebDAV" – for a WebDAV protocol. Can be secured by SSL/TLS, see webdavSsl system property, only KM and Xerox devices are supported. Also if using WebDAV with a network load balancer, please refer to this article.
  • "SwA" - for SOAP with Attachments. Can be used as a secure alternative to FTP on Fuji Xerox devices. Please review the limitation of this method and recommendation for additional setup in Requirements and known limitations of YSoft SafeQ Embedded Terminal for FujiXerox
  • "HTTP" is also available as secure alternative for FTP on all Brother and Konica Minolta BSI devices. 
  • "WebDAV,FTP" – WebDAV will be used for all MFD vendors that support it. For other vendors, FTP will be used. Note that MFDs using WebDAV must be correctly configured in order to function.
NETWORKAdvancedscanServerUsernameanonymousTerminal Server

The username used by embedded terminals to authorize on a scan server (FTP or WebDAV) before sending data.

NETWORKAdvancedscanServerPasswordcode,-31,-2,43,-90,-103,124,3,-49,58,-107,-31,40,74,-57,-1,-120Terminal Server

The password used by embedded terminals to authorize on a scan server (FTP or WebDAV) before sending data.

NETWORKAdvancedworkflowStorageTypelocal

Terminal Server

Workflow Processing System

The scan storage type. It can be:

  • local: a local server folder
  • remote: a network shared folder
  • webdav: a webdav server shared folder
NETWORKAdvancedworkflowStorageRootC:\SafeQ6\SPOC\terminalserver\scan

Terminal Server

Workflow Processing System

The root path to scan storage. Can be a relative path to WPS/Terminal Server or a UNC path, see the workflowStorageType parameter.
NETWORKAdvancedworkflowRemoteStorageUsername

Terminal Server

Workflow Processing System

The username to access remote scan storage, e.g., "qa13s162\Administrator"
NETWORKAdvancedworkflowRemoteStoragePassword

code,-31,-2,43,-90,-103,124,3,-49,58,-107,-31,40,74,-57,-1,-120

Terminal Server

Workflow Processing System

The encrypted password to access remote scan storage.
NETWORKExpertwebdavSslEnabledTerminal ServerEnable the use of the SSL protocol for connection to WebDAV repositories. When this setting is enabled, all WebDAV connections will be secured. When it is disabled, encryption for WebDAV connections is disabled.
NETWORKExpertwebdavPort5610Terminal ServerThe port used to connect to the WebDAV server.
NETWORKExpertsoapWithAttachmentsSslEnabledTerminal ServerEnable the use of SSL protocol for connection to SOAP with Attachments (SwA) endpoints. When this setting is enabled, all SOAP with Attachments connections will be secured. When it is disabled, encryption for SOAP with Attachments connections is disabled.
EXPERTExpertocrPoolSize1Workflow Processing System

The maximum number of scan jobs that involve OCR that will be processed in parallel by a single Workflow Processing System server (scan server). More jobs will wait in a queue. See also ocrProcessesPerJob, which controls the number of OCR threads that can be used to process a single job.

Together, these two options limit the number of CPU cores that can be used for OCR processing. For example, ocrPoolSize = 2 and ocrProcessesPerJob = 3 means that the system will process a maximum of two jobs in parallel and will utilize as many as 6 CPU cores in total.

If the customer produces a large number of small jobs, you should increase ocrPoolSize and keep ocrProcessesPerJob low.

If the customer produces large jobs, you should keep ocrPoolSize low and increase ocrProcessesPerJob.

EXPERTExpertocrProcessesPerJob1Workflow Processing System

The maximum number of simultaneous OCR threads that can be used to process a single job. Higher numbers speed up the processing of large scan jobs. The maximum supported value is 8. See also ocrPoolSize, which controls the number of jobs that involve OCR that can be processed in parallel.

Note that the number of OCR threads actually used to process a single job is further limited by the number of pages and the total number of CPU cores in the system. Also note that the final document synthesis is done in a single thread because it cannot be parallelized.

Example: ocrPoolSize = 2 and ocrProcessesPerJob = 2. At most, two jobs are processed simultaneously. More jobs will wait in a queue. Each job utilizes, at most, two CPU cores. In total, OCR processing may utilize as many as 4 CPU cores. If the host only has four cores, other applications running on the same host may not have enough resources.

EXPERTExpertocrDefaultProfileDisabledWorkflow Processing System

The default OCR profile used for all workflows in the OCR processing step. It can be overwritten on a workflow level, see the ocrProfilePerWorkflow system property. Use this property to set advanced OCR engine parameters (e.g., balance the speed and accuracy of OCR, blank page removal conditions, etc.). If you need any help, please contact Y Soft.

Please note that YSoft SafeQ is tested only with the default OCR configuration and it is not possible to test all combinations of different OCR configurations. If you change the configuration, you should test that OCR is working properly.

Note: This setting is affecting only OCR processing, other processing using the OCR engine (e.g., highlighted text extraction) is not affected.

EXPERTExpertocrProfilePerWorkflow
Workflow Processing System

It enables an option to overwrite the default profile (stored in the ocrDefaultProfile system property) per workflow. A new checkbox "Change default OCR Profile" will be available under the OCR processing step in the workflow definition after enabling this property.

Please note that YSoft SafeQ is tested only with the default OCR configuration and it is not possible to test all combinations of different configurations. If you change the configuration, you should test that OCR is working properly.

EXPERTExpertocrInputFileTypeJPGWorkflow Processing SystemThis specifies the file format of the scan document that is being sent from the MFD for OCR processing.
FEATURESBasicsharepointClientId
Workflow Processing System

The GUID on which the WPS connector add-in is registered (see Impersonation in Sharepoint 2013).

FEATURESBasicsharepointIssuerId
Workflow Processing System

The GUID on which the identification certificate is registered in Sharepoint (see Impersonation in Sharepoint 2013).

FEATURESBasicsharepointClientCertificateThumbprint
Workflow Processing SystemThe thumbprint of the identification certificate (must be installed in the WPS certification storage). Be aware of hidden leading symbols if you copy/paste the value.
NETWORKExpertuseProxyDisabledWorkflow Processing SystemInstructs the system to use a proxy for connecting to the Internet.
NETWORKExpertuseHostProxyDisabledWorkflow Processing SystemInstructs the system to use the proxy that the system administrator has set up for the host system.
NETWORKExpertproxyEndpoint
Workflow Processing SystemSpecify the endpoint for the proxy in the format IP:Port. Example: 127.0.0.1:9999. The parameter is used if useHostProxy is disabled.
NETWORKExpertproxyAuthenticateDisabledWorkflow Processing SystemInstructs the system to authenticate to the specified property proxyEndpoint.
NETWORKExpertproxyUser
Workflow Processing SystemThe username to use for authentication to the property proxyEndpoint. Example, "username" or "domain\user". The parameter is used if proxyAuthenticate is enabled.
NETWORKExpertproxyPassword
Workflow Processing System

The password to use for authentication to the property proxyEndpoint. Use an encription tool to set this value. The parameter is used if proxyAuthenticate is enabled.

NOTIFICATIONSBasicmailserver

Management Server

Mobile Print Server 

Site Server 

Workflow Processing System 

Payment System

The IP address or hostname of the primary mail (SMTP) server. Used by YSoft SafeQ to send all emails, including scans, notifications, alerts, and reports.
NOTIFICATIONSAdvancedmailSmtpPort25

Management Server

Mobile Print Server 

Site Server 

Workflow Processing System 

Payment System

The TCP port used for communication with the SMTP mail server
NOTIFICATIONSAdvancedmailSmtpEncryptionNONE

Management Server

Mobile Print Server 

Site Server 

Terminal Server

Workflow Processing System 

Payment System

NONE is the default value, which means no encryption is used.

When set to the SSL/TLS option, then the direct SSL/TLS (port 465) is used for communication.

When set to the STARTTLS option, then a STARTTLS command is sent after the communication channel is created (port 587) to upgrade to the secured channel.

NOTE: Mobile Print Server does not support the SSL/TLS encryption option. It always uses STARTTLS. This behavior can be overridden by setting "handleSslTlsMailSmtpEncryptionOptionAsStartTls" in mps.config to false. Then there will be no encryption used for the SSL/TLS option.


NOTIFICATIONSBasicmailuser

Management Server

Mobile Print Server 

Site Server 

Workflow Processing System 

Payment System

The username used to log into the SMTP server. Use only if your SMTP server requires authentication, otherwise, leave empty.
NOTIFICATIONSBasicmailpass

Management Server

Mobile Print Server 

Site Server 

Workflow Processing System 

Payment System

The password used to log into the SMTP server. Use only if your SMTP server requires authentication, otherwise, leave empty.
NOTIFICATIONSBasicmailfromnoreply@ysoft.com

Management Server

Mobile Print Server 

Site Server 

Workflow Processing System 

Payment System

The notification sender's email address for emails sent by YSoft SafeQ (that is, what will be in the From: header).
NOTIFICATIONSExpertmailEncodingutf-8

Site Server 

Workflow Processing System

The encoding used for creating email messages.
EXPERTExpertscanDateFormatyyyy-MM-dd

Site Server 

Workflow Processing System

The C# string format for the date used in the scanDate variable.
EXPERTExpertscanTimeFormatHH-mm-ss-fff

Site Server 

Workflow Processing System 

The C# string format for the time used in scanTime variable. The list of formats is available here https://msdn.microsoft.com/en-US/library/8kb3ddd4(v=vs.110).aspx

Note, be careful when using scanTime/scanDate variables in file names. They may contain invalid characters (for example, ":").

FEATURESBasicfilesystemReplacementCharacter-Workflow Processing SystemThe character to be used for replacement when a forbidden character for FILESYSTEM connector is encountered.
FEATURESBasicsharepoint2010ReplacementCharacter-Workflow Processing SystemThe character to be used for replacement when a forbidden character for SHAREPOINT_2010 connector is encountered.
FEATURESBasicsharepoint2013ReplacementCharacter-Workflow Processing SystemThe character to be used for replacement when a forbidden character for SHAREPOINT_2013 connector is encountered.
FEATURESBasicsharepoint2016ReplacementCharacter-Workflow Processing SystemThe character to be used for replacement when a forbidden character for SHAREPOINT_2016 connector is encountered.
FEATURESBasicsharepointOnlineReplacementCharacter-Workflow Processing SystemThe character to be used for replacement when a forbidden character for SHAREPOINT_ONLINE connector is encountered.
FEATURESBasicdropboxReplacementCharacter-Workflow Processing SystemThe character to be used for replacement when a forbidden character for DROPBOX connector is encountered.
FEATURESBasiconedriveReplacementCharacter-Workflow Processing SystemThe character to be used for replacement when a forbidden character for ONEDRIVE connector is encountered.
FEATURESAdvancedscanJobsDetailAccountingDisabled

Management Server

Site Server

If enabled, the administrator can enter detailed prices for the accounting of scan jobs depending on color (B&W/color) and paper size (large/small).

TERMINAL ADMINISTRATIONAdvancedsharpPdfCompressionLevelLOWTerminal Server

Specifies the PDF compression level for Sharp devices, can be:

  • LOW = the highest quality, the biggest file
  • MIDDLE
  • HIGH = the lowest quality, the smallest file
TERMINAL ADMINISTRATIONExperthpScanJobAssemblyEnabledDisabledTerminal ServerThis property enables native HP scan job assembly feature. When disabled, the feature is hidden.




JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.