- 1. Prerequisites
To configure Enterpryze Mobile integration with SAP Business One, you need to make sure that the following prerequisites are met:
- To run the Enterpryze Web Application, please ensure you are using the latest version of Mozilla Firefox or Google Chrome web browser
- SAP B1 version 9.1 PL 05 or higher installed for SQL instances 2012 or higher and SAP B1 version 9.1 PL 06 + SAP HDB Client version 1.0.85 or higher installed for SAP HANA instances
- Firewall configuration of the SAP server (must be same server that the SAP DI API resides on) so that port 8099 (or another port of your choosing) on the IP address of the SAP server is open for incoming and outgoing communication with Enterpryze Cloud IP’s
- Minimum of .NET Framework 4.5.2 installed on SAP Server for the Enterpryze Data Service to run
- 1 Professional Licenced SAP User credential – used for integration to allow data exchange between SAP and Enterpryze Mobile. ‘Professional User’ type of license needs to be assigned to the user
- SAP Employees – SAP Employees created in SAP can be linked to new Enterpryze Users in order to display SAP data linked to their Employee record in the Enterpryze Mobile feed – ‘My Feed’
- 1.1 SAP version
To check your SAP version
- Log into SAP
- Go to Help/About SAP Business One
- Check the SAP Business One version on the screen displayed
- 1.2 Server Firewall configuration
You need to make sure your server can communicate both ways with Enterpryze servers.
Enterpryze environment uses the popular TCP/IP and HTTPS protocols to communicate, so your network setup will be very simple, provided you follow the below guidelines:
Overview – SAP Enterpryze communication
Your setup checklist
- The Enterpryze Data Service has been installed and it is running (started) in Windows Services on your SAP server
- The port number that has been provided during the installation of the data service is open between the IP addresses of 126.96.36.199, 188.8.131.52, 184.108.40.206 and 220.127.116.11 – and your Internet facing router/firewall
- The port forwarding for the designated port between the router and your SAP server has been configured
- 1.3 Pro Licenced SAP User setup
- Log into SAP
- Go to Administration/Setup/General/Users
- Enter user code and password. Make sure the tick box ‘Password Never Expires’ is ticked.Press ‘Add’ button
- Go to Administration/License/License Administration
- Display ‘erp’ user from the list on the left side of the window
- Make sure that the user has got ‘Professional User’ type of license assigned
- 1.4 SAP Employee link to Enterpryze user setup
In order for a Enterpryze user to view their own data on both the web and in the mobile apps for Enterpryze, they must have an Employee Master Data record set up in SAP. The Employee number from this must then be set against the user in Enterpryze.
- In SAP Business One go to Modules and then Human Resources
- Open the Employee Master Data
- The Employee master data will open in find mode, so select the add button on the top ribbon
- First name
- Email Address
- Employee ID; Automatically populated- this is the number you will need for Enterpryze for the user
Additional Set up
Sales Employee: If the user is a sales employee. Please define in here. You can “define new” and set up the user- please add your employee first and then define the user and update
Technician; Please assign the role of Technician for users who need access to the service module. Go to membership and from the dropdown select “Technician”
Entering in Enterpryze
Go to set up> User and find the user. Click on edit and under SAP employee ID and select the SAP Employee from the drop down list.
- Network Configuration Guide: Testing your configuration and connection
Check the access to the Enterpryze Data Service (EDS)
Locally where it is installed
Open the web browser on the server where your EDS is located and navigate to:
It should only take a few seconds for something similar to the following to be displayed:
If you have to wait and then get an error message, instead of the desired response:
The most likely causes of such problems are:
- The EDS is not running – please make sure it is started
- You are not on the same computer where the EDS is installed – please check whether you are really accessing the service locally
- There are additional security measures, like e.g. server’s own firewall enabled or security/anti-virus software, preventing the service from working. Please make sure there is nothing in the way of this communication
From a computer in your company’s network
Open the web browser on a PC/Laptop within your local network and navigate to:
http://<The IP Address of your server where the EDS is installed>:8099/DI/Tools/HeartBeat
You should get the same type of response as above. If you do not, the most likely problems are:
- The URL address you entered is incorrect – please make sure you used http and not https, you entered the IP address of the computer where the EDS is installed and there are no spelling errors
- There is something between your computer and the server blocking access – likely a firewall
- There is no network route between your computer and the server. Are you sure you are in the same network/subnet?
From the Enterpryze Cloud
The most likely reason for this test to fail is an error in the firewall or port forwarding setup.
Please double check your IP addresses and port numbers for simple errors (e.g. wrong digit somewhere, misplaced dot etc.)
Please double check your firewall rules and forwarding – you may want to return to the previous step.
Have you really provided the IP address (and not e.g. your own) as the destination for forwarded traffic?
Check the data transfer from EDS, using Enterpryze Cloud
This step will ensure that the actual data from your SAP Business One can be read and written from the Enterpryze Cloud.
This is the ultimate way to verify the communication required for Enterpryze to work.
Please log in at https://apps.enterpryze.com/#/common/login and proceed to the Administration Settings section.
After you have completed the connection in Step 3 – Connect
Verify the connection by using the Check Data Access button
You can use any table you want to test, SAP Business One’s OCRD (Business Partners) table seems relevant for most scenarios, hence we based our example below on that very table:
If you can see the data – your configuration was successful, congratulations!
You are now welcome to import some data under the Data Import tab to start working with Enterpryze.
If any error messages appear, please let our support know and we will be happy to help.