Skip to main content

Notifications

Set up Common Data Service connection for Business Central

Hello Team!

Today we set up Common Data Service connection for our Business Central environment.

I really appreciate Renato Fajdiga for his blog about this topic but I think I could add more details to that. Also I'm planning additional articles about CDS integration and you'll need initial setup to start with.

So let's begin:

1. First of all - we need CDS environment. Go to https://admin.powerplatform.microsoft.com/environments and check your environments. I want to use new trial environment for test, so I click on +New action:

3630.JPG

2. Input Name, select Trial type (remember - you can have only 1 trial environment), choose region and select "Create a database for this environment"

 4073.JPG

3. Here is very important point - Currency. It must be the same as you have in Business Central as local currency. So if you have US localization for example - choose USD instead of EUR. Other values I left as default.

3513.JPG

4. Click Save and you'll get your environment on the list after some time.

5. Now we need 2 users on Power platform to build our connection - Admin user and non-admin CDS user.

Click on your environment -> Choose Settings -> User + Permissions -> Users.

If you already have 2 users which you can use - nothing to do here. Otherwise create new one on Active directory, assign power platform license to it and add it here with +New action:

2134.JPG

6. Now we need to manage user's roles. Click on "Manage users in Dynamics 365" action:

6403.JPG

Environment management will open, select needed user and press "Manage Roles":

5488.JPG

Both users should have next roles:

14-_1420_-_3A043E043F0438044F04_.JPG

Admin user also should have:

16-_1420_-_3A043E043F0438044F04_.JPG

And non-admin user should have:

15-_1420_-_3A043E043F0438044F04_.JPG

now you have all that you need and we can open Business Central to setup the connection.

7. Click on Assisted Setup -> Set up Common Data Service Connection:

71382.JPG

8. Click on next:

5460.JPG

9. If you have several CDS environments - you'll get window with environment selection Choose needed:

88353.JPG

10. On next window click on Sign in with admin credentials:

7701.JPG

11. Input Admin user login and password.

5050.JPG

12. After you'll see that admin is signed in - click next and input non-admin CDS user credentials:

1565.JPG

13. On next window we need to choose Ownership model - for this test leave it as Team:

5468.JPG

14. Press Finish on final window and our quest is over:

5008.JPG

15. Finally you'll see the sync window. It could contain record or could be blank - depends on is it the first setup to environment or not.

So congratulations - setup complete. In next article I'll show you how to replicate custom data from Business Central to CDS.

Comments

*This post is locked for comments

  • Ndarazi Profile Picture Ndarazi 5
    Posted at
    Hello, I'm trying to achieve the following for 5 months been contacting Microsoft support with no luck and I reached a dead end for my customer, please if anyone can assist me on it through teams or zoom session i would really appreciate it. Thank you dears.
  • Community Member Profile Picture Community Member Microsoft Employee
    Posted at
    Andrey, issue fixed. I had -Business Central Dataverse Integration -System Administrator -System Customizer roles for Admin, but for another Dataverse user with full name "Business Central Integration BusinessCentralIntegrationtoCommonDataService" i had only -Business Central Dataverse Integration role. I added -System Customizer to it and now it works. Thank you for quick response.
  • Andrey Baludin Profile Picture Andrey Baludin 3,941
    Posted at
    Hi! It requires only admin user since BC v17 (at least from 2020 wave 2). Check that your admin user has next roles: -Business Central CDS Integration -System Administrator -System Customizer
  • Community Member Profile Picture Community Member Microsoft Employee
    Posted at
    Hi Andrey, thank you for so detailed instruction. Maybe you could help with next question: i'm trying to connect Business Central 18 with Dataverse. During Dataverse Connection Setup it demanded only Admin User. Probably now it creates non-admin CDS/Dataverse integration user automatically. But during synchronization saying that Principal User with certain GUID lacks privileges to create records in Dataverse. I couldn't find User with such GUID among BC Users, Dataverse Users or Users in Azure Active Directory. Maybe you know how now this non-admin CDS/Dataverse integration user is created and where it could be found so i could add privileges to it?
  • Andrey Baludin Profile Picture Andrey Baludin 3,941
    Posted at
    Chapter 2: community.dynamics.com/.../replication-of-own-business-central-table-to-cds
  • Haritza10 Profile Picture Haritza10 10
    Posted at
    So excited waiting how to replicate custom data from Business Central to CDS!! Thank you!