1. Home
  2. Bluefort SMB
  3. BC Dataverse Integrator
  4. How to Install the Dataverse Solutions for the BC Dataverse Integrator
Searching...

How to Install the Dataverse Solutions for the BC Dataverse Integrator

Contents

Contents

  1. Pre-requisites
  2. Overview
  3. Step 1: Download the Solutions
  4. Step 2: Install the Bluefort Integration Foundation (BIF)
  5. Step 3: Install the Virtual Entity Infrastructure (Optional)
  6. Step 4: Install the Virtual Entities Solution (Optional)
  7. ✅ Summary

The BC Dataverse Integrator requires a set of managed solutions to be installed in your Dynamics 365 CRM (Dataverse) environment.

This guide walks you through the correct installation order and explains what each solution does.

Pre-requisites

  1. System Administrator role
    • You must have the System Administrator security role in the target Dataverse environment. Solution import requires privileges to register plugin assemblies and create SDK message processing steps.
  2. Azure Function deployed
  3. Solution files

Overview

The CE side of the BC Dataverse Integrator is split across up to three managed solutions. They must be imported in a specific order because each solution depends on the one before it.

OrderSolution FileRequired
1BluefortIntegrationFoundation_June2026.zipAlways
2BluefortIntegrationVEInfrastructure_June2026.zipOnly if using Virtual Entities
3IntFoundationVirtualEntities_June2026..zipOnly if using Virtual Entities

Important: Solutions 2 and 3 are only required if you intend to use the Virtual Entities functionality of the connector. If you are using the connector purely for data synchronisation between BC and CRM, you only need Solution 1.

Step 1: Download the Solutions

  1. Navigate to the BC-Dataverse-Integrator GitHub repository.
  2. Download the zip files you need:
    • BluefortIntegrationFoundation_June2026.zip — always required.
    • BluefortIntegrationVEInfrastructure_June2026.zip and IntFoundationVirtualEntities_June2026..zip — only if using Virtual Entities.
  3. Do not unzip the files. Dataverse imports them as zip archives directly.

Step 2: Install the Bluefort Integration Foundation (BIF)

This is the core solution and must always be imported first.

  1. Log in to Power Apps and select your target environment.
  2. In the left-hand menu, select Solutions.
  3. Click Import solution at the top.
  4. Click Browse and select BluefortIntegrationFoundation_June2026.zip.
  5. Click Next, review the solution details, and click Import.
  6. Wait for the import to complete. This solution registers the main plugin assembly (BluefortCRMIntegrationFoundation), all SDK message processing steps, entity forms, ribbons, web resources, and the Bluefort Integration Foundation Admin security role.

Upgrading an existing environment: If BIF is already installed, import the new version over the top. The import engine will upgrade the managed layer in place.

Step 3: Install the Virtual Entity Infrastructure (Optional)

This step is only required if you will be using the Virtual Entities functionality of the BC Dataverse Integrator. Skip to the Summary if you do not need Virtual Entities.

This solution registers the virtual entity data provider and data source that the virtual entity definitions depend on. It must be installed before the virtual entities solution because Dataverse needs the data provider to exist before it can create any virtual entities that reference it.

  1. In Solutions, click Import solution.
  2. Click Browse and select BluefortIntegrationVEInfrastructure_June2026.zip.
  3. Click Next and then Import.
  4. Wait for the import to complete. This solution installs the DataverseVirtualEntities plugin assembly and registers the IntFoundationVirtualEntitiesDataSource data source record.

Upgrading an existing environment where the data source already exists: If the IntFoundationVirtualEntitiesDataSource is already present from a previous installation, you can safely skip this step during upgrades. The data source record does not change between versions and only needs to be installed once per environment.

Step 4: Install the Virtual Entities Solution (Optional)

This step is only required if you completed Step 3.

This solution contains the actual virtual entity definitions — the Dataverse tables that surface Business Central data directly inside CRM without replication.

  1. In Solutions, click Import solution.
  2. Click Browse and select IntFoundationVirtualEntities_June2026..zip.
  3. Click Next and then Import.
  4. Wait for the import to complete. This solution creates the virtual entity tables (including Customer Ledger Entries and related BC tables), their forms, views, and ribbons.

Note: This import will fail if the Virtual Entity Infrastructure solution from Step 3 has not been successfully installed first. The virtual entity definitions reference the data provider registered in Step 3 — if that record is not present, the import will error immediately.

✅ Summary

Installing the CE solutions for the BC Dataverse Integrator involves:

  1. Downloading the required solution zips from the BC-Dataverse-Integrator GitHub repository.
  2. Importing BluefortIntegrationFoundation first — always required.
  3. Importing BluefortIntegrationVEInfrastructure second — only if using Virtual Entities.
  4. Importing IntFoundationVirtualEntities third — only if using Virtual Entities.

The order of import is fixed and must not be changed. Each solution depends on the one before it, and importing out of sequence will result in import failures.

By following these steps, your Dataverse environment will have all the required CE-side components installed and ready for configuration in the BC Dataverse Integrator setup wizard.

Updated on June 22, 2026

Was this article helpful?

Yes No

Updated on June 23, 2026

Was this article helpful?

Yes No

Related Articles