ERP User GuideSAP Business One

SAP Business One

Sana Commerce 9.3
Your connector

Configure Sana Web Service

 NOTE

Applies to: Sana for SAP Business One on-premise

If you need to configure the Sana Web Service for SAP Business One Cloud, see this article.

A Sana web store connects to SAP Business One through the Web service implemented by Sana. The Sana Web service for SAP Business One is hosted in the Internet Information Services (IIS) Manager and it is installed on the same machine where the DI Server components are installed. The Sana Web service uses the DI Server to communicate with SAP Business One.

Sana delivers the installer to install and configure the Sana Web service for SAP Business One, but you can use the window Configure Sana Web Service to reconfigure the Web service after installation, if there is a necessity. For more information, see "Install Sana Web Service".

Set up Sana Web service

Step 1: In SAP Business One, click: Web Store > Setup > Services > Configure Sana Web Service.

Step 2: In the Web Service Folder field, enter the path to the folder where the Sana Web service is installed.

Step 3: Click Configure. Set up the connection, database and SAP Business One settings.

The table below provides description of the fields in the Configure Sana Web Service window.

Field Description
General Settings
Web Service Folder Select the location where the Sana Web service is installed.
Active Connection Select the active type of the Sana Web service connection.
Database Settings
Database Server Enter the SQL or HANA database server name SAP Business One connects to. This can be either the name or the IP address of the server where the License Server is installed.
Database Type Select the database type, either the SQL Server version or the SAP HANA database.
Database Name Enter the name of the SQL or SAP HANA database that you need to connect to.
Database Username Enter the user credentials of the SQL or HANA database.
Database Password
SAP Business One Settings
Company Username Enter the credentials of the user that is used to log in to the SAP company the Sana add-on is assigned to. This must be a super user in SAP Business One.
For more information, see "SAP Company User".
Company Password
License Server Enter the name of the SAP License server.
Language Language is the mandatory parameter for DI Server connection. It is used to get information and error messages from SAP Business One in the selected language. Usually, this is the same language as the default language of SAP Business One, but you can choose another language.
IIS Settings
Protocol The protocol (HTTP or HTTPS) on which the Sana Web service is running. Sana requires to secure data transfer between the Sana web store and SAP Business One with the SSL certificate. Thus, the Sana Web service must run over HTTPS. The server which hosts the Sana Web service for SAP Business One must support TLS 1.2.

The Sana Web service installer allows to install the Web service with the SSL certificate. For more information, see "Install Sana Web Service".

If you installed the Sana Web service without the SSL certificate, then you must secure the Web service manually. For more information, see "Set up Web Service to Use SSL ".
Authentication Type For security reasons, only Windows Authentication can be used to gain access to the Sana Web service for SAP Business One.

Step 4: When the Sana Web service is configured, click Update to save the settings of the Sana Web service.

All settings of the Sana Web service are stored in the "Web.config" file of the Sana Web service, which you can find in the folder where the Web service is installed.

Logging

Use the checkbox Enable Logs, to enable and disable logging.

When logging is enabled, all requests from the Sana web store to SAP Business One and responses will be saved to the output directory. Logs can be used for troubleshooting and debugging. If some request is executed with an error, you can also see the error messages in the log files.

By default, logging is disabled as it affects performance. Thus, it is better to use logging only for troubleshooting and debugging purposes.

In the field Log Output Directory, enter the path to the folder where the log files should be stored. The user who runs the Web service must have the "write" permissions to the folder which is specified in the Log Output Directory field.

Use the checkbox Enable Performance Logs, to enable and disable the performance logs.

Using the performance logs, you can see how long each API call and all DI Server calls within a single API call take. Developers and technical specialists can collect performance data to analyze it and identify performance bottlenecks.

See also:

DI Server Service Task
ERP User GuideSAP Business One