Install Sana Web Service for SAP Business One Cloud

A Sana web store connects to SAP Business One Cloud through the Web service implemented by Sana. The Sana Web service for SAP Business One Cloud is hosted in the Internet Information Services (IIS) Manager. It uses SAP Business One Service Layer to establish connection between Sana and SAP Business One Cloud.

The Sana Web service for SAP Business One Cloud can be installed on any server as long as it can be used as a connection between Sana and SAP Business One Cloud using the Service Layer.

Sana delivers the installer to install and configure the Sana Web service for SAP Business One Cloud.

NOTE

Only registered Sana partners can download the Sana Web Service installer for SAP Business One Cloud from the Sana Community website. If you are a customer, please contact your Sana partner or Sana project manager.

Prerequisites

  • The Sana Web service for SAP Business One. Only registered Sana partners can download it from the Sana Community web site. If you are a customer, please contact your Sana partner or Sana project manager.

  • Windows Server 2012 R2 or higher

  • Internet Information Services (IIS) Manager 7.5 or higher.

  • Anonymous Authentication role service must be installed on the server. Anonymous Authentication is used to gain access to the Sana Web service for SAP Business One.

  • .NET Core:

    • Sana Commerce Cloud 1.0.56 and higher for SAP Business One - .NET Core 7.0 or higher. You can download the Hosting Bundle here.
    • Sana Commerce Cloud SCC100 - 1.0.51 for SAP Business One - .NET Core 3.1.0 or higher. You can download the Hosting Bundle here.
  • It is required to secure data transfer between the Sana web store and SAP Business One Cloud. Thus, you must obtain the SSL certificate for the Web service domain. SSL certificate is issued by a certificate authority (CA), which takes steps to verify that your web address actually belongs to your organization. The server where you install the Sana Web service for SAP Business One must support TLS 1.2. The Sana Web service for SAP Business One Cloud must run over HTTPS.

Step 1: Run Web Service Installer.exe. You can find the Sana Web Service Installer in the Connector folder of the Sana add-on package for SAP Business One Cloud.

Step 2: Go to the Installation /Upgrade step. Fill in the fields and set up the necessary settings.

Field 

Description 

Connection Type(Beta / Live) 

Select the connection type, Beta or Live.

When you select the connection type, the fields Site Name and Application Pool will be automatically prefilled with the default name, but you can change it. 

Site Name and Application Pool

Enter the web site name which will be used in the IIS Manager for the Sana Web Service. The name of the application pool is automatically predefined with the web site name.

NOTE

In the Site Name field you can see all web sites that are available in the IIS Manager on the server. If the Sana Web Service for SAP Business One Cloud is already installed and you need to upgrade it to the latest version, you can also use the installer. You can select the existing web site which hosts the Sana Web Service for the SAP Business One Cloud and upgrade it. If you need to upgrade the Sana Web Service, at first create the backup of your existing Web Service. 

Physical Path 

Select the location where the Sana Web Service must be installed. This is the path where the Sana Web Service content will be stored.

By default, the Sana Web Service is installed to this folder:
C:\inetpub\wwwroot 

Port 

Enter the port on which the Sana Web Service for SAP Business One Cloud must run. The requests to the Sana Web Service are made through this port. 

Host Name (Optional) 

Enter the host name, if you want to access the Sana Web Service for the SAP Business One Cloud by the domain name. The host name is not required. If you leave this field empty, you will be able to access the Sana Web Service by the server IP address. 

SSL Certificate 

Add the SSL certificate and enter the password, if it is password-protected.

By encrypting your Sana Web Service for SAP Business One using SSL, you make your data and the network more secure and more reliable. The Sana Web Service will run over HTTPS.

NOTE

If you don't have the SSL certificate yet, you can install the Sana Web Service without it, and secure it with SSL manually once you obtain the security certificate. For more information, see Secure Sana Web Service with SSL.

Select service type 

Sana Commerce Cloud uses the Service Layer to connect to SAP Business One Cloud. It also depends on the database you are using - SAP HANA or SQL.

  • HANA Service Layer - Select this service type if you connect Sana Commerce Cloud to SAP Business One Cloud using Service Layer and you have the SAP HANA database.
  • SQL Service Layer - Select this service type if you connect Sana Commerce Cloud to SAP Business One Cloud using Service Layer and you have the SQL database. The SQL database is supported from Sana Commerce Cloud 1.0.17 in SAP Business One Cloud. To install Sana Commerce Cloud into SAP Business One Cloud with the SQL database, you must have SAP Business One Cloud 10.0 FP 2102 or higher.

Step 3: Click Install.

The Sana Web Service Installer will create the web site and application pool for the Sana Web Service in the IIS Manager, extract the ERP Web Service files to the installation folder, and set up the Web Service authentication. If you have added the SSL certificate, it will also set up the Sana Web Service for SAP Business One Cloud to use SSL.

Step 4: When the Sana Web Service is installed, click Next. On the Configuration step, fill in the fields and set up the necessary settings to configure the Sana Web Service for SAP Business One Cloud.

Field 

Description 

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 URL 

Enter the SAP Business One Cloud Service Layer service URL. It should be in the following format:

https://<IP>:<port>/b1s/v1

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 

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

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

Database Instance

Enter the database instance.

Step 5: Click Save and Test Connection. If the Sana Web Service has been successfully configured and connected to the Service Layer, click Finish.

When the Sana Web Service for SAP Business One Cloud is installed, it will automatically open in the default Web browser. If you can see the Web Service login page, then the Sana Web Service has been installed successfully.

NOTE

When the Sana Web Service for SAP Business One Cloud is installed, you will need to enter the URL of the Web service and Sana user credentials on the ERP connection page in Sana Admin to establish connection between Sana and SAP Business One Cloud. If you don't have access to Sana Admin, send the Sana Web service URL and user credentials to the person who is responsible for the Sana web store maintenance. For more information, see ERP Connection.

You can reconfigure the Sana Web Service at any time, if there is a necessity. For more information, see Configure Sana Web Service for SAP Business One Cloud.

See Also

Service Layer Performance Optimization