Configure Sana Web Service
Applies to: Sana for SAP Business One on-premise
If you need to configure the Sana Web Service for SAP Business One Cloud, see Configure Sana Web Service for SAP Business One Cloud.
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.