User Tools

Site Tools


implementation:scan:install_addon

3.1. Install Produmex Scan Add-on

3.1.1. Install the add-on

3.1.1.1. On Premise

3.1.1.1.1. Registering the Add-On

Extract the content of the .zip file on your local machine.
The .zip file contains two files:

  • BXMobileWH9Setup.ard
  • BXMobileWH9Setup.exe

In SAP Business One, open the Add-On Administration window (Main menu > Administration > Add-Ons > Add-On Administration).
Click on 'Register Add-On' button.

Click on the '…' button beside the Registration Data File and browse the BXMobileWH9Setup.ard file. SAP Business One will fill out the path to the .exe file automatically. Enable 'Install as Part of Registration' and click on the 'OK' button. Add-on registration

First SAP Business One will register the add-on and then it will start the installation wizard.

3.1.1.1.2. Proceeding with the installation

If the 'Install as Part of Registration' checkbox was turned on, the installation will start right away with starting the install wizard. Click on the 'Next' button to start the installation.

Accept the End-User License Agreement by selecting the 'I accept the agreement' option, and then click on the 'Next' button.

Make sure all components are checked and that there is enough disk space. Click on the 'Next' button.

Click on the 'Install' button to proceed with the installation.

If the installation process takes too long time, then SAP Business One will ask you if the installation finished successfully.

System message

If the installation was successful, click on the 'Yes' button.
Please note: If there was an error during installation, it will be failed regardless of your answer.

3.1.1.1.3. Activating the Add-on

Now you can see the add-on under Company-Assigned Add-Ons, on the right part of the window.
Make sure the 'Active' box is checked.
Change the Default Group from 'Disabled' to 'Manual' or 'Automatic'.

  • 'Automatic' means the add-on will launch each time you start SAP Business One.
  • 'Manual' means you have to launch the add-on manually after each time you start SAP Business One. It is advised to use this option during the configuration phase.

Click on the 'Update' button to save the changes.

3.1.1.2. In SAP Cloud

3.1.1.2.1. Install the add-on on the Could Control Center

Download the lightweight installer. The zip file is named: ProdumexScanAddOnSetup_<version number>_<SBO version number>_<environment>_lightweight.zip

Create a Produmex sub folder within the folder you defined as the Extension Repository Path. Upload the zip folder of the lightweight installer to this Produmex folder. Do not unzip the file.

On the Could Control Center, navigate to Landscape Management > Extensions.

Check whether the installation file is listed on the Extensions grid then press the ‘Synchronize All’ button to install the Produmex Scan add-on. Confirm that you would like to synchronize all extensions.

If the installation is successful, on the opening Synchronization Report the status on the line of Produmex Scan is 'Successful'. The installation zip is automatically moved to the Produmex Shared Repository folder.

3.1.1.2.2. Deploy the add-on to the Service Unit

When upgrading the add-on to a new version, make sure that the add-on is not running on any presentation server. If there is a running add-on, the upgrade will fail.

Next deploy the add-on on every service unit where you would like to use it.

Navigate to Landscape Management > Service Units. On the Service Units grid select the target service unit.

On the Service Unit Details grid go to the Extensions tab and click on the Deploy button. Follow the steps of the Extension Deployment Wizard. Select the Produmex Scan add-on at the Select Extensions step then finish the deployment.

3.1.1.2.3. Assign the add-on to the tenant(s)

This step is not required in the case of a version upgrade.

Finally assign the Produmex Scan add-on to the tenant(s) where you would like to use it.

Go to Customer Management > Tenants. Select the tenant on the Tenants grid. On the Tenant Details grid navigate to the Extensions tab, then click on the ‘Assign’ button. Follow the steps of the Extension Assignment Wizard. In the Select Extensions step select the Produmex Scan add-on, then finish the assignment.

3.1.2. Database Setup

When you first start the add-on after the installation, it will create its own database tables and user defined fields. The add-on will display a message whether to upgrade the database or not. Click on the ‘Yes’ button to upgrade the database.

To be able to run the DBSetup the SAP user must be superuser.

Please note: On MSSQL, the system will check whether there is a backup created within an hour. If no such backup is detected, a warning will be shown and the add-on exists. Create a backup of the database then restart the add-on.

On the next screen set up the database connection. Enter the database user name and the database password. After the DB Connection is set up, the system will upgrade the database.

DB connection setup

After clicking on the 'OK' button, a progress bar will appear and it will go through the database setup process. After the database structure has been modified, another System Message is displayed. Click on the ‘Yes’ button to add the user-defined fields.

A confirmation is displayed that the database structure have been modified. Acknowledge the message.

A System Message window warns that the add-on stopped:

Here you have to choose Continue working without this Add-on and restart SAP. Now you can start using the add-on in SAP.

implementation/scan/install_addon.txt · Last modified: 2018/06/12 08:35 by csuhaa