User Tools

Site Tools


cobi.wms:installation_guides

This is an old revision of the document!


Step-by-step implementation 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.

    1. Afterwards, copy the Trigger URL as described in the linked page and temporarily save it somewhere
  1. Follow all the steps of the following section (on-prem with Service Layer), with the following differences:
    1. Use the Trigger URL for the APIURL field of the SAP Business One company connection added to the Management Database
    2. Make sure that TCP Port 8080 for Integration Framework is opened on the server

On-premises or private cloud, with Service Layer

If you have an on-premises or private cloud installation of SAP Business One with Service Layer available (which means it is either based on SAP HANA, or the version of SAP Business One is 10.0 or newer) then follow these steps:

    1. Create the database itself by copy-pasting the correct creation script into SQL Server Management Studio or HANA Studio
    2. Import licenses by using the appropriate INSERT statement from the Management Database documentation
    3. Add SAP Business One connections by using the appropriate INSERT statement from the Management Database documentation
  1. (For HANA: Install and start the HANA Proxy)
  2. Install COBI.wms from the Google Play Store on an Android device that can access the SAP Business One server
  3. Make sure that the TCP ports for direct DB queries and Service Layer are not blocked
    1. MS SQL Server: 1433
    2. HANA Proxy: 30075
    3. Service Layer: 50000 (https) or 50001 (http)
  4. (optional) Use cobiwms-config.html to generate a Settings QR Code
  5. Open COBI.wms on the Android device and scan the Settings QR Code (or enter the settings manually)
  6. Click Connect and take note of the device ID on the right side of the screen below the Login button
  7. Assign a license to that device ID (see Management Database documentation again)
  8. Log in to COBI.wms with an empty username/password and make a test booking
  9. (optional) Create COBI.wms users in the Management Database
  10. (optional) Disable all modules for all devices and enable them for users instead to force user login

Public cloud

Prerequisites

If you are using SAP Business One from a public cloud (SAP-hosted or partner-hosted) then first of all, your cloud provider must make Service Layer accessible. Talk to your provider for details about this.

Configuring the app

To configure the connection of the app to your SAP Business One cloud account, open cobiwms-config.html in a new tab of your browser, and follow these steps:

  1. Choose Companies (public cloud) at the top of the page.
  2. Click on New to start creating a new Company connection.
  3. Enter the connection settings as instructed. (Fill at least Service Layer URL, Username, and Password.)
  4. (To add additional company connections, like for a testing database, repeat steps 2 and 3.)
  5. Click on Generate QR Code to display a QR Code containing the entered settings.
  6. Start COBI.wms on your Android device and open the Settings screen if it doesn't open automatically.
  7. Scan the QR Code on your monitor. (If your device's built-in scanner doesn't support QR Code, or you're using a regular Android device without a barcode scanner, then tap the barcode icon at the top right of the screen to open the device's camera for scanning. After the QR Code is recognized, tap on Use on the bottom right.)

Creating SQL Queries

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, above the login button. (It will create them if they were not created yet, otherwise update them to the newest version.)

For this SQL Query creation/update to work correctly, the SAP user you've entered for the connection settings in step 3 in 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.

All types of installation

There are some steps you might need to take which are independent of the SAP Business One installation:

cobi.wms/installation_guides.1651490087.txt.gz · Last modified: 2022/05/02 13:14 by tkammer

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki