Installing the Integration Solutions Add-on for SAP Business One

Installing the Integration Solutions Add-on for SAP Business One

You must install the integration solutions add-on for all branch and consolidation companies.

Caution
If you are using the 32-bit version of the SAP Business One client, you can install and run only the 32-bit version of the integration solutions add-on. If you are using the 64-bit version of the SAP Business One client, you can install and run only the 64-bit version of the integration solutions add-on.

Registering the Integration Solutions Add-On

To begin installation of the intercompany integration solution, you must register the add-on on the SAP Business One server from a client. On completion of the registration, the add-on installation package will be uploaded to the SAP Business One server. You need to register the add-on only once, that is, on each client. To register an add-on, you must have SAP Business One superuser authorization.


To register the integration solutions add-on, follow this procedure:

  1. In SAP Business One, log on to a company with a user that has superuser authorization. 
  2. In the SAP Business One Main Menu, choose Administration → Add-Ons → Add-On Administration. 
  3. The Add-On Administration window appears.
  4. Choose the Register Add-On button (below the list of Available Add-Ons).
                   The Add-On Registration window appears.
  1. Locate and select the add-on registration data file (*.ard) by choosing the (…) (Browse) button next to the Registration Data File field.
                  * stands for the name of the add-on. The file for the integration solutions add-on is named IntegrationSolutionsAddon.ard.
  1. Locate and select the add-on installation package (*.exe) by choosing the (…) (Browse) button. 
                  * stands for the name of the add-on. The file for the integration solution add-on is named IntegrationSolutionsAddon.exe.
  1. To assign the add-on to the current company, select the Assign to Current Company checkbox. This option is selected by default.
                  Choose the OK button. 
                  In the Add-On Administration window, the name of the add-on appears in the list of Company-Assigned Add-Ons.
                  The add-on installation package has been uploaded to the SAP Business One server. The add-on is now available for all company databases on this server.        

  Note:   Use       to move the order of the Intercompany add-on up the list of Company-Assigned Add-Ons.

  1. In the Company-Assigned Add-Ons screen area, in the Intercompany add-on row, click on the arrow in the Default Group column and select Automatic from the dropdown list. Select the Active checkbox.
  2. Choose the Update button.
  3. Choose the OK button.
  4. Close the SAP Business One application.
  5. Open SAP Business One. Log on to a company with a user that has superuser authorization.
                  The Add-on installer wizard launches automatically.
  1. In the Welcome window of the Add-on installer wizard, choose the Next button.
                  The Select Installation Folder window is displayed. The Folder field is populated with the default installation path.
                  To install the add-on to a different path, choose the (…) (Browse) button.
  1. In the Select Installation Folder window, choose the Install button.
                  The add-on installation starts; when finished, the Installation Complete window is displayed.
  1. In the Installation Complete window, choose the Finish button.
  2. A system message is displayed informing you that SAP Business One will close. Choose the OK button.
  3. In SAP Business One, log on to a company with a user that has super user authorization.
                  The integration solutions add-on database script executes automatically, and its progress is displayed in the SAP Business One status bar.
                  On completion, a system message is displayed informing you that SAP Business One will close after add-on installation.

Assigning the Integration Solutions Add-On to Companies

When you register the intercompany add-on, the add-on is assigned by default to the company that was registered. Next, the add-on must be assigned to other companies participating in the Intercompany Landscape. To manually assign the add-on to other companies, use the following steps:

  1. In SAP Business One, log on to a company with a user that has superuser authorization.
  2. In the SAP Business One Main Menu, choose Administration → Add-Ons → Add-On Administration.
  3. Select the Company Preferences tab. 
  4. To assign the integration solutions add-on, in the list of Available Add-Ons, select the Intercompany add-on. Then click   
  1. In the Company-Assigned Add-Ons list, in the Default Group field, select Automatic from the dropdown list. Check the box in the Force Install field and the Active field. 
                   Note
                 Use    to move the order of the Intercompany add-on up the list of Company-Assigned Add-Ons.
  1. To unassign the add-on, in the Company-Assigned Add-Ons list, select the add-on and click left arrow.
  1. The add-on is removed from the Company-Assigned Add-Ons list.
                  Note that the add-on is still available to other company databases on the server. You can reassign the add-on to the current company database at any time.
  1. Choose the Update button.
                  To use the add-on, restart the SAP Business One application.

Assigning the Integration Solutions Add-On to Users

                  After an add-on is assigned to a company, the add-on is by default available to all users that have authorization for that company. 
             Caution
            Ensure that the integration solutions add-on is assigned to all users of the company.                 
 
To assign the add-on to users, follow this procedure:
  1. In SAP Business One, log on with a user that has superuser authorization. Log on to a company that has the integration solutions add-on installed.
  2. In the SAP Business One Main Menu, choose Administration → Add-Ons → Add-On Administration. 
                  The Add-On Administration window appears.
  1. Select the User Preferences tab.
  2. Select a user from the Users list.
  3. Select the Intercompany add-on from the Add-Ons list.
  4. In the Preference field, choose Automatic from the dropdown list.
                  The user preference is displayed next to the add-on.
  1. Choose the Update button.

Add-On Installation on SAP Business One Client

Once the integration solutions add-on has been registered to a server, the add-on can be installed on the SAP Business One client. To initiate installation on the registered client machine, restart SAP Business One. When the client reconnects to the company database with the assigned add-on, the server automatically downloads the installer. The Intercompany add-on installer wizard appears. Follow the steps on the screen.

 Caution
    1. After the add-on installer appears, you must complete the Intercompany add-on installation wizard steps within the available installation time (shown in the SAP Business One status bar). Otherwise, the system will automatically interrupt the procedure. In this case, you must restart the client again to install the add-on.

    2. If the wizard begins the installation and choose the Cancel button to interrupt the procedure, wait for a system timeout before using the SAP Business One application.

During initialization, you may receive the following system message: 

“The database structure has been modified. To resume process all open windows will be closed. Continue?” 
Choose the Yes button to close all windows and proceed with initialization. The message disappears when initialization is complete.

When initialization is complete, you receive the following system message: “The SAP Add-On Initialization completed successfully”. Choose the OK button to restart the application. If you choose the Cancel button, you must restart SAP Business One manually before you can use the add-on.

The SAP Business One application performs the initialization process only once for each company database.

 Caution
    1. Ensure that the integration solutions add-on log folder has read and write permission.

      Log folder location is as follows:

      %PROGRAMDATA%\sap\SAP Business One\Log\SAP Business One\<Username>\Addon\IntegrationSolutions

      Where Username is logged in Username. For example - C:\ProgramData\SAP\SAP Business One\Log\SAP Business One\Administrator\Addon\IntegrationSolutions


    1. After installing the intercompany integration solution, you cannot use the Copy Express add-on in any of the company databases selected in the Landscape section of the Intercompany Administration Console.

Note

    1. If you encounter any issues during the installation of the intercompany add-on, the "Addon Error Log" screen will appear with SQL script version and detailed error description. You need to log the support ticket to Walldorf support along with addon error logs.
    2. The "Delete Error Logs" button removes error logs from the Addon Error log table. After completing the required settings or configurations, the user must restart the intercompany addon to ensure the changes take effect.
    3. If you encounter any issues during the installation of the intercompany add-on, the "Reset Add-On Version" button in the Feature Activation screen is available. This button serves a crucial role by facilitating the clearing of the CTX_CONF table, a pivotal step in resolving issues associated with the add-on installation process.
    4. In existing Intercompany installation with IC PL 34, 35, and 36 Intercompany deployment is 
       required to get the Intercompany menu item visible.
    5. In existing Intercompany installation with IC PL 37 the menu item is always visible. 
    6. In fresh installation with IC PL 37 Intercompany Deployment is required to get the Intercompany menu item visible.

Upgrading from Previous Integration Solutions Add-On Releases

    All requirements described in the intercompany  Prerequisites  are fulfilled!
 Note

Before starting upgrade, you must remove the previously installed add-on with name Intercompany from the Add-on Administration window.

To perform the upgrade procedure, proceed as follows: 
  1. In SAP Business One, log on to a company with a user that has superuser authorization.
  2. In the SAP Business One Main Menu, choose Administration → Add-Ons → Add-On Administration.
The Add-On Administration window appears.
  1. Choose the Register Add-On button (below the list of Available Add-Ons).
  2. Locate and select the add-on registration data file (*.ard) by choosing the (…) (Browse) button next to the Registration Data File field.
  1. * stands for the name of the add-on. The file for the integration solutions add-on is named IntegrationSolutionsAddon.ard. 
  1. If the Installation Package field is not filled automatically, locate and select the add-on installation package (*.exe) by choosing the (…) (Browse) button.
  1. * stands for the name of the add-on. The file for the integration solutions add-on is named IntegrationSolutionsAddon.exe. 
  1. To assign the add-on to the current company, select the Assign to Current Company checkbox (this option is selected by default).
  2. Choose the OK button.
                              In the Add-On Administration window, the name of the add-on appears in the list of Company-Assigned Add-Ons.  The add-on installation package has been uploaded to the SAP Business One server. The add-on is now available for all company databases on this server.
                         Note
                        Use  to move the order of the integration solutions add-on up the list of Company-Assigned Add-Ons.

  1. In the Company-Assigned Add-Ons screen area, in the Intercompany add-on row, click on the arrow in the Default Group column and select Automatic from the dropdown list. Select the Active checkbox.
  2. In the Add-on Administration window, choose the Update button.
  3. In the Add-on Administration window, choose the OK button.
  4. Close the SAP Business One application.
  5. Open SAP Business One. Log on to a company with a user that has superuser authorization.
                  The add-on installation launches automatically.
  1. In the Welcome window of the Intercompany Setup Wizard, choose the Next button.
                  The Select Installation Folder window is displayed. The folder field is populated with the default installation path.
  1. To install the add-on to a different path, choose the (…) (Browse) button.
  2. In the Select Installation Folder window, choose the Install button.
                  When the installation is finished, an Installation Complete window is displayed.
  1. In the Installation Complete window, choose the Finish button.
                  A system message is displayed informing you that SAP Business One will close after installation.
  1. In the system message window, choose the OK button.
  2. Open SAP Business One. Log on to a company with a user that has superuser authorization.
  3. The integration solutions add-on database script executes automatically, and the progress is displayed in the SAP Business One status bar. Upon completion, a system message is displayed informing you that SAP Business One will close after add-on installation.      
             Caution
            After upgrading the intercompany add-on ensure that integration solutions installer is also upgraded. 

Uninstalling the Integration Solutions Add-On

This section explains how to uninstall the integration solutions add-on.


Caution

Do not uninstall the integration solutions add-on if the add-on is in use in your company. Once you remove the software, you will no longer be able to utilize the intercompany integration solution features.
When you remove the add-on, the add-on installation package is removed from the SAP Business One server. When a client with the add-on installed subsequently connects to the server, the add-on is also removed from the client.

To uninstall the add-on, perform the following steps:
  1. Open SAP Business One on a client with the add-on. Log on with a user that has superuser authorization. Log on to a company that has the add-on installed.
  2. In the SAP Business One Main Menu, choose Administration → Add-Ons → Add-On Administration.
                  The Add-On Administration window appears.
  1. Select the Company Preferences tab.
  2. To unassign the add-on, select the add-on in the Company-Assigned Add-Ons list. Choose  .
                  The add-on is removed from the Company-Assigned Add-Ons list.
  1. In the Available Add-Ons list, select Intercompany Add-On. Choose the Remove Add-On button.
                  The add-on is removed from the list of Available Add-Ons.
                  The system will automatically launch the removal procedure the next time you start the SAP Business One application from a client that is connected to the server.
  1. Open SAP Business One. 
                  The Windows Installer window is displayed.
  1. Choose the Yes button.
The add-on uninstallation is completed automatically. 

Note
If you do not want to use the SAP Business One company database for Integration Hub transactions, perform the following:

    1. If you are using a Microsoft SQL database, remove the CTX_IC_SP_TransactionNotification stored procedure calling from SBO_SP_TransactionNotification.

    2. If you are using an SAP HANA database, remove the CTX_IC_SP_TRANSACTIONNOTIFICATION_DOC and CTX_IC_SP_TRANSACTIONNOTIFICATION_MASTER stored procedures from SBO_SP_TRANSACTIONNOTIFICATION.

    • Related Articles

    • Installing the Intercompany Integration Solutions

      The Integration Hub and Intercompany Solution are two different solutions. Both can be installed separately or together using the configuration available in the Integration Solutions installer. To install the intercompany integration solution, you ...

    • Configurations in SAP Business One after installing Intercompany

      This section describes the activities you are required to perform immediately after installing the intercompany integration solution for SAP Business One, including the following: Configurations in SAP Business One Setting up the intercompany ...

    • Upgrading Intercompany from Previous Integration Solutions Add-On

      Note Before starting upgrade, you must remove the previously installed add-on with name Intercompany from the Add-on Administration window. To perform the upgrade procedure, proceed as follows:  In SAP Business One, log on to a company with a user ...

    • Intercompany Integration Solution for SAP Business One

      Growing organizations that control more than one legal business entity are sometimes faced with the challenge of how to share data between partner companies.  The Intercompany Integration Solution for SAP Business One enables businesses running SAP ...

    • Setup Intercompany Solution with Multiple Branches

      With Intercompany Patch level 26, user can now use the intercompany solution with branch enabled companies. With branch solution user can work across branches on one company database and with Intercompany Solution user can work with different SAP ...