Configure Sana Web Service for SAP Business One Cloud

This article provides information about Sana Web service for SAP Business One Cloud and how to configure it. It is used for communication between Sana and SAP Business One Cloud using Service Layer. This connection allows Sana to use data and business logic of SAP Business One Cloud.

The Sana Web service for SAP Business One Cloud is hosted in the Internet Information Services (IIS) Manager. Sana delivers the installer to install and configure the Sana Web service for SAP Business One. When it is installed, you can access the Web service using the Web interface and reconfigure it after installation, if there is a necessity.

For more information, see Install Sana Web Service for SAP Business One Cloud.

Prerequisites

Before configuring the Sana Web service for SAP Business One Cloud check the prerequisites:

• The Sana Web service for SAP Business One Cloud must be installed.

• The Web service URL must be available and accessible.

• The user that is used to authorize the Web service must be set up.

• The SAP Business One Cloud Service Layer service URL must be available.

• The SAP Business One Cloud company details are available.

Set Up Sana Web Service for SAP Business One Cloud

Step 1: Open the Sana Web service for SAP Business One in the Web browser. Use the Web service URL to open it. When you open the Web service in the Web browser, you will be asked to enter credentials of the user that is used to authorize the Sana Web service for SAP Business One Cloud. This is the Sana user you specified during installation of the Sana Web service for SAP Business One. Then, you will see the Sana Web service configuration page.

Step 2: When you log in to the Sana Web service configuration page, all parameters will be filled in because you already had to configure the Web service during installation.

Using this page, you can easily reconfigure the Sana Web service for SAP Business One Cloud through a Web interface.

Field	Description
Active Connection	Select the connection type, Beta or Live.
Sana Username	Enter the credentials of the user that is used to authenticate the Sana Web service for SAP Business One. You can enter any username and password. You will need to enter the credentials of this user and Sana Web service URL in the ERP connection settings in Sana Admin.
Sana Password
Service Layer URL	Enter the Service Layer URL. You must request it from your SAP Business One Cloud implementation partner.
Company Database	Enter the name of the SAP Business One Cloud HANA or SQL database / company name on which the Sana add-on is installed according to the specified connection type (Beta or Live).
SAP Username	Enter the credentials of the dedicated database user that is used to log in to the SAP company the Sana add-on is assigned to. This must be a super user with an Indirect Access user or professional license in SAP Business One Cloud.
SAP Password
Log Directory	The path to the folder where the log files are stored. For more information about this field, see Logging in this article.
API Gateway
Enable API Gateway	The API Gateway is only necessary if you want to allow your customers to download sales reports directly from the web store in PDF format generated by SAP Business One for sales documents such as orders, invoices, shipments, etc. SAP Business One API Gateway Service must be already installed.
API Gateway URL	Enter API Gateway URL. You can find it in the System Landscape Directory (SLD), under Services.
SAP User Name	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 with an Indirect Access user or professional license in SAP Business One Cloud.
SAP Password
DB Instance	Enter the database instance.

Step 3: Click Test Connection to check connection to SAP Business One Cloud via the Sana Web service.

Step 4: Click Update to save Sana Web service settings.

Logging

In SAP Business One click: Web Store > Setup > Parameters > Log Settings.

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 log 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.

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 Service Layer calls within a single API call take. Developers and technical specialists can collect performance data to analyze it and identify performance bottlenecks.

Log files are stored in the log folder. If necessary, you can change the path to the log files in the Log Directory field on the Sana Web service configuration page.

Before changing the log directory path, open the folder where the Sana Web service for SAP Business One Cloud is installed. Find the appsettings.json file and open it in Notepad. Make sure that SapBizOneCloud is set to false.

Now, open the Sana Web service configuration page. In the Log Directory field you can change the path where the log files must be stored.