Versions Compared

Version Old Version 20 New Version Current
Changes made by

Jan Verlaan (Unlicensed)

Remco Visser

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

DataBridge is also available for SuperOffice CRM On-PremiseOnsite. There are some requirements the environment must meet and also there are additional configuration steps needed for the SuperOffice environment and DataBridge.

Note: DataBridge will still be running in the cloud but will connect to your local SuperOffice CRM environment using via the NetServer Web Services via the internetpublicly exposed SuperOffice Web API.

Requirements

...

  • SuperOffice version 8.4 R08 or newer;
  • SuperOffice System User.
  • SuperOffice Web API needs to be accessible from the internet ;The NetServer Web Services have to use through HTTPS;
  • SuperOffice 7.5 or higher;
  • A SuperOffice CRM system user.

1. Prepare NetServer

If you are using Pocket CRM your NetServer Web Services have already been configured. You can move on to the next step.

If not, follow the steps in ‘Prepare Server’ in the SuperOffice documentation on configuring NetServer for Pocket CRM.

Also make sure to read the documentation on deploying NetServer securely: https://community.superoffice.com/en/technical/documentation/prepare/security/deploy-securely/

1.1. Additional steps for SuperOffice 8.0 or 8.1 or 8.2 R01

If you are using SuperOffice 8.0 or 8.1 or 8.2R01 some additional files need to be deployed on the SuperOffice web server. Extract Services75.zip (attached to the end of this article) to your 'Remote' folder of SuperOffice web or NetServer installation. The same folder should already contain a folder called Services80:

Image Removed

2. Verify NetServer

Verify the Remote NetServer installation by opening a browser and browsing to the web services: 
http://<address>/Remote/Services<xx>/person.svc

Examples: 

When using a SuperOffice version equal to or higher than 7.5 and lower than 8.2 R01: Use Services75
https://servername.yourcompany.com/SuperOffice/Remote/Services75/person.svc

When using a SuperOffice version equal to or higher than 8.2 R01 and lower than 8.4 R06: Use Services84
https://servername.yourcompany.com/SuperOffice/Remote/Services84/person.svc

When using a SuperOffice version equal to or higher than 8.4 R06: Use Services86
https://servername.yourcompany.com/SuperOffice/Remote/Services86/person.svc

If the Web Services are exposed correctly you see the following screen:

Image Removed

...

1. Prepare SuperOffice APIs

DataBridge connects to your locally hosted SuperOffice installation. To do so, your SuperOffice installation needs to expose its Web API. This needs to be done in a secure way.
In the current SuperOffice installations, the Web API is switched on by default and may not need to be configured.


Security based on filtering IP addresses is possible; further down this page, you'll find the IP addresses that DataBridge uses to connect to your SuperOffice instance.

If all is set up correctly you should be able to 'contact' the Web API by visiting this URL, where you replace the obvious part with your (sub)domain.

  • https://<your_SuperOffice_url>/api

Image Added

Details about configuring the Web API can be found here: https://docs.superoffice.com/en/onsite/install/netserver/setup-rest.html
It might be a bit technical. If you are not able to perform the configuration and testing yourself, please contact your SuperOffice consultant.

2. Configure DataBridge

You are now ready to configure DataBridge using the following steps:

  1. Sign up for a new DataBridge account here: 
    https://my-databridge.infobridgeuniverse.com/Account/Registration;
  2. Confirm your email address;
  3. Setup the connection to your SuperOffice environment.
    If you are not automatically redirected to the 'Setup Connection' page click on 'Account' and then on 'Connection'
    or visit the following page directly http://my-databridge.infobridgeuniverse.com/Manage/Connection and fill out the form:
    • Using a version of SuperOffice equal to or higher than 7.5 and lower than 8.2 R01                - NetServer services URL: http://<address>/Remote/Services75/;
    • Using a version of SuperOffice equal to or higher than 8.2 R01 and lower than 8.4 R06        - NetServer services URL: http://<address>/Remote/Services84/;
    • Using a version of SuperOffice equal to or higher than 8.4 R06                                                - NetServer services URL: http://<address>/Remote/Services86/;SuperOffice Web API URL (https://<your_SuperOffice_url>/api)
    • Username of a SuperOffice system userSystem User;
    • Password of the userSystem User;
    • Clicking save will verify Click Save to verify and save the connection ;details.
  4. New profiles will now automatically copy these default connection settings. 

Other details

DataBridge will use the following IP-addresses to connect to your environment:

  • 23.97.188.46
  • 40.118.68.234
  • 40.118.69.16
  • 40.118.69.95
  • 40.118.64.32

Available Download

...


...

Info
If you have set up DataBridge with your SuperOffice Onsite installation before January 6, 2022 then you might have used a URL to Netserver Services (i.e. https://<your_SuperOffice_url>/Remote/Services86).
You don't need to change the URL to point to the Web API instead of Netserver Services. DataBridge will make sure it finds the Web API.
Only if you experience troubles when DataBridge tries to connect to SuperOffice Onsite, please edit the connection details by entering the URL to Web API.

Other details

See this page for more details on requirements, security and checklists.