Connect to Business Central

Connect Wisefish Stream App to Business Central

This Page includes all the different ways to connect Wisefish Stream App to Business Central.
The application supports both Cloud and On-Premises Business Central Installations.

Connect to Cloud

Follow the following steps to connect with the Cloud.

1. Open the application that you have downloaded.

2. Click or tab on “Connect to Cloud.”

Open

3. Pick the Microsoft Account you want to use.

Open

4. If your user is connected to more than one tenant, pick the environment you want to connect to.

5. Pick the company you want to have your default company.  You can easily switch companies.

6. You will be presented with the main menu of the application or friendly message notifying you that Wisefish is not installed.

Advanced Options to Connect

The following options as in below screenshot are displayed for user to connect through the “Advanced” option.

Open

• On Premises

  • Connects you to a in prem Business Central instance. You need the API URL for the connection.

  • Supports both basic authentication and on windows devices. integrated windows authentication.

• Cloud Sandbox

  • Allows you to pick which sandbox environment your tenant(s) have, and you want to connect to.

• Guest Tenant

  • Allows you to use a specific tenant.

  • You might have to grant the application access to the tenant:

    • For tenant with ID XYZ use the following URL (replace XYZ with the correct tenant ID):

    • https://login.microsoftonline.com/XYZ/oauth2/authorize?client_id=c646aafa-03f8-4c85-9d30-f6159567d398&response_type=code&redirect_uri=msalc646aafa-03f8-4c85-9d30-f6159567d398://auth&prompt=admin_consent

Connect as On Premises

Click the “On Premises” option and perform the following actions.

If you are connecting to an “On Prem” instance you need to fill in some details about the environment.

Open

As we can see on the previous image those details are: Server, Port number and Instance (Path).

If you don't know these details, don't worry, the next part is all about where you can see this information.

First you need to log in to the BC environment in browser and search for “Web Services”.

The field we are going to be looking at is the “OData V4 URL”, most of the links there are very similar and the following image displays what we are looking for.

• Yellow = Server

• Green = Port number

• Pink = Instance (Path)

Open

With this info we can fill in the data to connect to the environment.

Open

Then you click on Next and use your credentials to log in. When that is done you can see the list of companies and all that is left to do is select the correct company and you are in.

Connect as Cloud Sandbox

1. Click on “Cloud Sandbox” option.

2. After Authentication select the sandbox environment you want to use.

Open

3. Pick a Company from the list.

4. The main menu will appear after the successful connection.

Connect as Guest Tenant

1. Click on the “Guest Tenant” option.

2. Enter the tenant id:

Open

3. Select the environment you want to connect to.

4. Select the Company you want to use.

5. Main menu will appear after successful connection.