SYSPRO Avanti Web Service

Exploring

This is a web service that hosts the SYSPRO Web UI (Avanti) web site for remote accessing.

It handles the communication between the web browser and SYSPRO (for Avanti to generate user interfaces for screens) and also manages user logins.

This service is used by:

  • SYSPRO Web UI (Avanti)

  • The default location for this service is:

    inetpub > wwwroot > SYSPROAvanti

Overview topic

SYSPRO Services

Topics

SYSPRO Web UI (Avanti)

SYSPRO Avanti Installation

SYSPRO Installer

PDF and Video Resources

Feature Guides

Install Guides

Starting

  • Microsoft .NET Framework 4.8

  • SYSPRO 8 Server

  • SYSPRO 8 Service Upgrade Manager

  • SYSPRO 8 e.net Communications Load Balancer

    A valid endpoint must be configured in the Setup Options program of SYSPRO 8.

  • SYSPRO 8 Avanti Initialization Service connection

  • Internet Information Services (IIS) 7.0 Core Web Engine Feature

  • Internet Information Services (IIS) 7.0 World Wide Web Publishing Feature

  • Internet Information Services (IIS) WebSocket Protocol Feature

We recommend that you use Windows Server 2019 (or higher) when running SYSPRO Web UI (Avanti).

The following technology is also required when using more than 30 instances of the SYSPRO Web UI (Avanti) - as defined against the Maximum number of instances allowed setup option (Setup Options > System Setup > System-Wide Personalization):

  • Windows Server 2022: Datacenter Edition

  • SYSPRO Application Gateway (Container Solution)

  • This service is installed using the SYSPRO Installer Application.

  • This service should be installed on a web server that is accessible to any client with web browsers used for Avanti.

  • IIS must be installed along with ASP.NET development features (as illustrated):

The Setup Options program lets you configure how SYSPRO behaves across all modules. These settings can affect processing within this program.

Setup Options > System Setup > E.Net Service Details

  • The ports and the machine name for the SYSPRO 8 e.net Communications Load Balancer must be configured correctly for Avanti.

Setup Options > System Setup > Connectivity

  • The Avanti url must match the entry at the Avanti website address field (e.g. on a local machine it should be http://192.168.5.16/sysproavanti/, where 192.168.5.16 indicates the IP address of the machine where SYSPRO Web UI (Avanti) is installed).

Solving

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

The web.config 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)

This service outputs an event log to the SYSPROAIS file.

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

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

This (and similar errors) often states that The requested page cannot be accessed because the related configuration data for the page is invalid.

These errors occur when there is a problem reading the configuration file for the web server or web application.

Verify the configuration settings in System Setup, in particular at the E.net services tab.

Service operators are created by SYSPRO and are used by SYSPRO services to obtain information about SYSPRO.

The service operator code starts with a double underscore to differentiate them from other operators. A default company code must be assigned to each service operator within the Operator Maintenance program, as we use the company code to log in the service operator via e.net .

The following is a list of service operators and their function within SYSPRO:

  • The __ADSYNC service operator is used by the SYSPRO 8 Active Directory Sync Service to push Microsoft Active Directory (AD) information into SYSPRO for Active Directory managed operators.

  • The __DFM service operator is used by the SYSPRO 8 Document Flow Manager Folder Poller and SYSPRO 8 Document Flow Manager Queue Poller to monitor folders, send files to the queue and process files.

  • The __ESP service operator is used by the following services:

    • SYSPRO 8 Espresso Service,

    • SYSPRO 8 Espresso Notification Service,

    • SYSPRO Espresso Development Plugin and the

    • SYSPRO Avanti Web Service to obtain information for the password reset and forgot password functionality.

  • The __POS service operator is used by the SYSPRO 8 Point of Sale Services to determine and validate the setup options and required credentials at start up, update the required databases and post to SYSPRO (if the Point of Sale operator doesn't have access to SYSPRO).

  • The __RUL service operator is used by the SYSPRO 8 Rules Engine Service and the SYSPRO 8 Rules Data Service.

  • The __SA service operator is used by the SYSPRO 8 Analytics service to make business object calls.

  • The __SAI service operator is used by the SYSPRO 8 Machine Learning service.

  • The __SRS service operator is used by the SYSPRO 8 Reporting Host Service and the SYSPRO 8 Cognitive Service to manage client-side report printing.

  • Only specific services use service operators to log in via e.net.

  • SYSPRO creates service operators by copying the ADMIN operator. If the ADMIN operator record doesn't exist (i.e. it may have been deleted), then the current operator is used when saving system details from the Setup Options program.

Service operators are signed in by a SYSPRO service and are used for any functionality that is required by the service to obtain information about SYSPRO.

Normal operators sign in to SYSPRO with a username and password. They access certain programs and functions to perform specific tasks.

For example:

the __SRS service operator is used by the SYSPRO 8 Reporting Host Service to obtain information about the companies in an environment, but it isn't used by the business object to retrieve the data for a report, as that would be the specific normal operator that submits the request for the report.