Differences

This shows you the differences between two versions of the page.

--- cobi.wms:installation_guides [2022/05/02 13:23] – tkammer
+++ cobi.wms:installation_guides [2023/08/10 14:30] (current) – tkammer
@@ Line 1: / Line 1: @@
-====== Step-by-step implementation guides ======
+====== Installation Guides ======
 The steps you need to follow for implementing COBI.wms depend on the type of your SAP Business One installation.  Follow the steps under the section that describes your environment.
-===== On-premises or private cloud, MS SQL Server, SBO 9.3 or earlier =====
-If you have an **on-premises or private cloud** installation of SAP Business One **Version 9.3 or older**, based on Microsoft **SQL Server** then please refer to the following steps.  Note that the **Integration Framework** must be installed already.
-  - Import the **[[B1i Scenario Package]]**
-    - Afterwards, copy the **Trigger** URL as described in the linked page and temporarily save it somewhere
-  - Follow all the steps of the following section (on-prem with Service Layer), with the following differences:
-    - Use the Trigger URL for the ''APIURL'' field of the SAP Business One company connection added to the Management Database
-    - Make sure that TCP Port 8080 for Integration Framework is opened on the server
 ===== On-premises or private cloud, with Service Layer =====
@@ Line 19: / Line 9: @@
   - Create the **[[Management Database]]**
     - Create the database itself by copy-pasting the correct creation script into //SQL Server Management Studio// or //HANA Studio//
-    - Import licenses by using the appropriate ''INSERT'' statement from the Management Database documentation
+    - Add SAP Business One connections by using the appropriate ''INSERT'' statement from the Management Database
-    - Add SAP Business One connections by using the appropriate ''INSERT'' statement from the Management Database documentation
+    - Import licenses by using the appropriate ''INSERT'' statement from the Management Database documentationdocumentation
   - (For HANA: Install and start the **[[HANA Proxy]]**)
-  - Install COBI.wms from the Google Play Store on an Android device that can access the SAP Business One server
   - Make sure that the TCP ports for direct DB queries and Service Layer are not blocked
     - MS SQL Server: 1433
     - HANA Proxy: 30075
     - Service Layer: 50000 (https) or 50001 (http)
-  - (optional) Use **{{cobiwms-config.html}}** to generate a Settings QR Code
+  - Install COBI.wms from the Google Play Store on an Android device that can access the SAP Business One server
-  - Open COBI.wms on the Android device and scan the Settings QR Code (or enter the settings manually)
+  - (optional) Use **{{cobiwms-config.html}}** to generate a Settings QR Code to scan with the app
+  - Open COBI.wms on the Android device and scan the Settings QR Code or enter the settings manually
   - Click Connect and take note of the device ID on the right side of the screen below the Login button
-  - Assign a license to that device ID (see Management Database documentation again)
+  - Assign a license to that device ID (see [[Management_database#license_management | License Management]])
-  - Log in to COBI.wms with an empty username/password and make a test booking
+  - Log in to COBI.wms and make a test booking
-  - (optional) Create COBI.wms users in the Management Database
+  - (optional) Create COBI.wms users in the Management Database (see [[management_database#cobiwms_users | COBI.wms Users]])
-  - (optional) Disable all modules for all devices and enable them for users instead to force user login
+  - (optional) Disable all modules for all devices and enable them for users instead to force user login (see [[management_database#permission_management | Permission Management]])
+===== (SBO 9.3 or earlier only) On-premises or private cloud, MS SQL Server =====
+**Warning: The use of Integration Framework with COBI.wms is deprecated and highly discouraged for new installations.  Most new COBI.wms features are only available when using Service Layer.**
+If you have an **on-premises or private cloud** installation of SAP Business One **Version 9.3 or older**, based on Microsoft **SQL Server** then please refer to the following steps.  Note that the **Integration Framework** must be installed already.
+  - Import the **[[B1i Scenario Package]]**
+    - Afterwards, copy the **Trigger** URL as described in the linked page and temporarily save it somewhere
+  - Follow all the steps of the previous section (on-prem with Service Layer), with the following differences:
+    - Use the Trigger URL for the ''APIURL'' field of the SAP Business One company connection added to the Management Database
+    - Make sure that TCP Port 8080 for Integration Framework is opened on the server
 ===== Public cloud =====
@@ Line 59: / Line 61: @@
 When connecting to a cloud deployment of SAP Business One, COBI.wms cannot establish a direct database connection and instead has to request all data over Service Layer.  To improve the functionality and performance of these data requests, the app can create a number of SQL Queries while logging in to a company database.
-This is done by checking **Update SQL queries** in the login screen, below the login button, before logging in.  (This will create the Queries if they were not created yet, and update them to the newest version if they were already created but not up-to-date, so it's recommended to do this once for every new version of COBI.wms.)
+This is done by checking **Update SQL Queries** in the login screen, below the login button, before logging in.  (This will create the Queries if they were not created yet, and update them to the newest version if they were already created but not up-to-date, so it's recommended to do this once for every new version of COBI.wms.)
 For this SQL Query creation/update to work correctly, the SAP user you've entered for the connection settings (see step 3 of the previous section) has to be either a superuser, or have the permission **Modify SQL Queries in Service Layer** under the "General" category.  This permission is only available since **SAP Business One Version 10 FP2108**.  In older versions, you must use a superuser.