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