SYSPRO 8 Point of Sale e.net Communication Service

Exploring

This service allows the SYSPRO Point of Sale applications to interact with the core SYSPRO product.

Based on Windows Communication Foundation, this service exposes the SYSPRO64.DLL library to internal and external applications that need to interact with SYSPRO (e.g. SYSPRO Espresso, Predictive Search, third party developer applications, etc.).

Data is retrieved from the SYSPRO database using the open e.net architecture, without compromising data integrity.

This service replaces the legacy SYSPRO e.net WCF Service (originally developed to replace SYSPRO Web Services and DCOM) and provides for load balancing functionality, as well as being fault tolerant (e.g. if a channel fails, a new thread is initiated automatically to prevent the whole service from failing).

This service is used by:

  • SYSPRO Point of Sale

  • The default location for this service is:

    Program Files > SYSPRO > SYSPRO 8 Point of Sale Services

Overview topic

SYSPRO Services

Topics

Installing SYSPRO Point of Sale

SYSPRO Point of Sale

PDF and Video Resources

Install Guides

Starting

  • This service is installed using the SYSPRO 8 Point of Sale autorun (available from: https://syspro8install.azureedge.net/iso/SYSPRO8POSAutorun.iso).

    You will be required to configure settings for the service during the installation.

Solving


You can debug this service by editing the associated config file in elevated mode (i.e. with administrator privileges).

The SYSPRO.8.Point.of.sale.enet.Communications.config.exe file is located in the folder to which you installed the service.

You can view monitoring and troubleshooting messages about this service using the Event Viewer function in Windows:

(Control Panel > System and Security Administrative Tools > Event Viewer > Applications and Service Logs)

You can start, stop, restart and configure this service using the Services function in Windows:

(Control Panel > System and Security Administrative Tools > Services)

Referencing

You should only update this file for temporary debugging purposes (i.e. not as a method to update values for the service).

Any temporary changes made to the configuration files are reset to their original installation values when this application is next updated. Because these temporary changes are not carried forward, forgetting that you made them could hamper troubleshooting efforts if unexpected issues arise.

Key Description

Language

This indicates the default language to use with SYSPRO communication. You can manually override this during logon.

LogDetail

This indicates the default logging detail used by SYSPRO. You can manually override this during logon.

Instance

This indicates the default instance of SYSPRO with which the service will communicate.

SYSPRO instances are reflected in your Windows Registry to identify the \Base folder of your SYSPRO install, where the required .dll and .exe files are located.

baseaddress

This indicates the template base address used by the service. For REST and SOAP communication, the schema must be left as http:// (even if a different binding is used) as the service configures this automatically.

DetailedLog

When set to true the service outputs a detailed log file to the temp folder of the machine on which the service is installed.

servicesoapbinding

This indicates the communication binding for the service to use for SOAP communication.

servicerestport

This is the port that the service will use to host the REST endpoint.

You must add the REST port to the firewall manually.

servicesoapport

This is the port that the service will use to host the SOAP endpoint.

If set, SOAP communication must be performed using an address that includes the port number (e.g. http://localhost:{PortNumber}/SYSPROWCFService/Soap).

servicerestportchildrange

The internal range of REST ports used by the hive processes of the service.

The range should include the same number of items as the hive process count.

hiveprocesscount

The number of hive processes to start to process SYSPRO WCF Service requests.

ReceiveTimeout

The maximum length of time a call to the service can take.

SendTimeout

The maximum length of time a call to the service can take.