Configure Sana Web Service

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 Business One 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 Secure Sana Web Service with 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.

Related Articles

Create DI Server Service Task