Verbinding maken met Microsoft Dataverse

Notitie

Azure Active Directory heet nu Microsoft Entra ID. Meer informatie

In dit artikel wordt beschreven hoe u een verbinding tot stand brengt tussen Business Central en Dataverse. Bedrijven maken doorgaans de verbinding om gegevens te integreren en te synchroniseren met een andere Dynamics 365-bedrijfsapp, zoals Dynamics 365 Sales.

Voordat u begint

Voordat u de verbinding maakt, moet u een aantal gegevens gereed hebben:

• De URL van de Dataverse-omgeving waarmee u verbinding wilt maken. Als u de begeleide instelling Dataverse-verbinding instellen gebruikt om de verbinding tot stand te brengen, kunnen we uw omgevingen vinden. U kunt ook de URL van een andere omgeving in uw tenant invoeren.
• De gebruikersnaam en het wachtwoord van een account dat beheerdersmachtigingen heeft in Business Central en Dataverse.
• Als u een on-premises Business Central 2020 releasewave 1, versie 16.5, hebt, leest u het artikel Enkele bekende problemen. U moet de beschreven tijdelijke oplossing voltooien voordat u verbinding kunt maken met Dataverse.
• De lokale valuta's die elk bedrijf gebruikt. Business Central-bedrijven kunnen verbinding maken met een Dataverse-omgeving die een andere basisvaluta heeft dan hun lokale valuta. Voor meer informatie over het omgaan met instellingen voor meerdere valuta's gaat u naar Verschillende valuta's toestaan.

Belangrijk

Uw Dataverse-omgeving mag niet in de beheermodus zijn. De beheermodus zorgt ervoor dat de verbinding mislukt omdat het integratiegebruikersaccount voor de verbinding geen beheerdersmachtigingen heeft. Zie Beheermodus voor meer informatie.

Notitie

Deze stappen beschrijven de procedure voor Business Central online. Als u Business Central on-premises gebruikt en geen Microsoft Entra-account gebruikt om verbinding te maken met Dataverse, moet u ook een gebruikersnaam en wachtwoord van een gebruikersaccount opgeven voor de integratie. Dit account wordt de 'integratiegebruiker' genoemd. Als u een Microsoft Entra-account gebruikt, is het gebruikersaccount voor integratie niet vereist en wordt dit ook niet weergegeven. De integratiegebruiker wordt automatisch ingesteld en heeft geen licentie nodig.

Uw Business Central- en Dataverse-omgevingen koppelen

Bedrijven willen hun gegevens veilig houden binnen hun privacygrenzen, en vooral wanneer hun bedrijfsbeheertoepassing kan worden geïntegreerd met andere apps. Door Business Central- en Dataverse-omgevingen te koppelen, houdt u niet alleen rekening hiermee, maar biedt u uw beheerders ook een eenvoudigere manier om uw integraties met andere Dynamics 365-apps te maken en te onderhouden.

In het Business Central-beheercentrum kunt u uw Business Central-omgeving aan uw Dataverse-omgeving koppelen. Business Central kan de informatie uit de koppeling gebruiken om de integratie met andere Dynamics 365-apps, zoals Sales en Field Service, eenvoudiger en veiliger te maken. De gekoppelde Dataverse-omgevings-URL is bijvoorbeeld standaard beschikbaar op de pagina Dataverse-verbinding instellen en wanneer u de begeleide instelling Dataverse-verbinding instellen uitvoert.

Verschillende valuta's toestaan

Business Central-bedrijven kunnen verbinding maken met een Dataverse-omgeving die een andere basisvaluta heeft dan hun lokale valuta.

Notitie

Voor het synchroniseren van meerdere valuta's is het nodig dat u een unidirectionele synchronisatie gebruikt, van Business Central naar Dataverse.

Voor meer informatie over de basisvaluta in Dataverse gaat u naar De entiteit Transactievaluta (valuta).

Voor meer informatie over valuta's in Business Central gaat u naar Valuta's in Business Central.

Om verschillende valuta's mogelijk te maken moet u ervoor zorgen dat u de volgende instellingen heeft opgegeven voordat u verbinding maakt:

• De basistransactievaluta-instelling in Dataverse heeft de valutacode die is opgegeven op de pagina Valuta's in Business Central.
• Er is ten minste één wisselkoers gespecificeerd voor de valuta in Business Central op de pagina Valutawisselkoersen.

Wanneer u de verbinding met Dataverse inschakelt, Business Central wordt de lokale valuta ervan toegevoegd aan de entiteit Valuta in Dataverse. De lokale valuta gebruikt de wisselkoers uit het veld Valutafactor op de pagina Valutawisselkoersen .

Aangezien valutasynchronisatie unidirectioneel is, van Business Central naar Dataverse, worden geldbedragen als volgt omgerekend en gesynchroniseerd:

• Bedragen in de Dataverse-basisvaluta worden omgerekend naar de lokale Business Central-valuta op basis van de laatste wisselkoers die is gesynchroniseerd vanuit Business Central.
• Bedragen in de lokale Business Central-valuta worden gesynchroniseerd met de lokale Business Central-valuta in een van de andere (niet-basis) valuta's in Dataverse.

Een verbinding met Dataverse instellen

Voor alle verificatiesoorten anders dan Microsoft 365-verificatie stelt u de verbinding met Dataverse in op de pagina Dataverse-verbinding instellen. Het is raadzaam de begeleide instelling Dataverse-verbinding instellen te gebruiken voor Microsoft 365-verificatie. De begeleide instelling maakt het gemakkelijker om de verbinding in te stellen en geavanceerde functies op te geven, zoals het eigendomsmodel en initiële synchronisatie.

Belangrijk

Tijdens het instellen van de verbinding met Dataverse wordt de beheerder gevraagd om de volgende machtigingen te geven aan een geregistreerde Azure-toepassing met de naam Business Central-integratie met Dataverse:

• De machtiging Toegang tot Dataverse krijgen als uzelf is nodig, zodat Business Central namens de beheerder automatisch een niet-gelicentieerde, niet-interactieve gebruiker van de Business Central-integratietoepassing kan maken, beveiligingsrollen kan toewijzen aan deze gebruiker en de Business Central-integratieoplossing kan implementeren naar Dataverse. Deze toestemming wordt slechts één keer gebruikt tijdens het instellen van de verbinding met Dataverse.
• De machtiging Volledige toegang tot Dynamics 365 Business Central hebben is nodig zodat de automatisch gemaakte gebruiker van de Business Central-integratietoepassing toegang tot Business Central-gegevens kan krijgen die worden gesynchroniseerd.
• De machtiging Aanmelden en uw profiel lezen is nodig om te verifiëren dat de gebruiker die zich aanmeldt de beveiligingsrol Systeembeheerder toegewezen heeft gekregen in Dataverse.

Door namens de organisatie toestemming te geven geeft de beheerder de geregistreerde Azure-toepassing genaamd Business Central-integratie met Dataverse het recht gegevens te synchroniseren met de referenties van de automatisch gemaakte gebruiker van de Business Central-integratietoepassing.

De begeleide instelling Dataverse-verbinding instellen gebruiken

De begeleide instelling Dataverse-verbinding instellen kan het gemakkelijker maken om de toepassingen te verbinden en kan u zelfs helpen bij het uitvoeren van een eerste synchronisatie. Als u ervoor kiest om de eerste synchronisatie uit te voeren, zal Business Central de gegevens in beide applicaties bekijken en aanbevelingen doen voor het benaderen van de initiële synchronisatie. De volgende tabel beschrijft de verschillende aanbevelingen.

Aanbeveling	Omschrijving
Volledige synchronisatie	Gegevens bestaan alleen in Business Central of alleen in Dataverse. De aanbeveling is om alle gegevens van de service die ze heeft te synchroniseren met de andere service.
Geen synchronisatie	Er zijn gegevens in beide toepassingen en bij volledige synchronisatie worden de gegevens gedupliceerd. De aanbeveling is om records te koppelen.
Niet voldaan aan afhankelijkheid	Er zijn gegevens in beide toepassingen, maar de rij of tabel kan niet worden gesynchroniseerd omdat deze afhankelijk is van een rij of tabel waarvoor de aanbeveling Geen synchronisatie geldt. Als klanten bijvoorbeeld niet kunnen worden gesynchroniseerd, kunnen gegevens voor contacten die afhankelijk zijn van de klantgegevens ook niet worden gesynchroniseerd.

Belangrijk

Normaal gesproken gebruikt u alleen volledige synchronisatie wanneer u de applicaties voor de eerste keer integreert en bevat slechts één applicatie gegevens. Volledige synchronisatie kan handig zijn in een demonstratieomgeving omdat het automatisch records maakt en koppelt in elke applicatie, waardoor het sneller wordt om met gesynchroniseerde gegevens te werken. U moet echter alleen volledige synchronisatie uitvoeren als u één rij wilt in Business Central voor elke rij in Dataverse voor de tabeltoewijzingen. Anders kan het resultaat dubbele records zijn.

1. Kies het voer Begeleide instelling in en kies vervolgens de gerelateerde koppeling.
2. Kies Een verbinding instellen met Microsoft Dataverse om de begeleide instelling te starten.
3. Vul de vereiste velden in.

Notitie

Als u niet wordt gevraagd om u aan te melden met uw beheerdersaccount, komt dit waarschijnlijk omdat pop-ups worden geblokkeerd. Sta pop-ups vanaf https://login.microsoftonline.com toe om u aan te melden.

De verbinding handmatig maken of onderhouden

In de volgende procedure wordt beschreven hoe u de verbinding op de pagina Dataverse-verbinding instellen handmatig instelt. De pagina Dataverse-verbinding instellen is de locatie waar u de integratie-instellingen beheert.

1. Kies het voer Dataverse-verbinding instellen in en kies vervolgens de gerelateerde koppeling.

2. Voer de volgende gegevens in voor de verbinding van Business Central met Dataverse.

   Veld	Omschrijving
   Omgevings-URL	Als u eigenaar bent van omgevingen in Dataverse, vinden we die voor u wanneer u de instelling uitvoert. Als u verbinding wilt maken met een andere omgeving in een andere tenant, kunt u de beheerdersreferenties voor de omgeving invoeren zodat wij deze kunnen vinden.
   Ingeschakeld	Begin de integratie te gebruiken. Als u de verbinding niet nu inschakelt, worden de verbindingsinstellingen opgeslagen, maar hebben gebruikers geen toegang tot Dataverse-gegevens uit Business Central. U kunt naar deze pagina terugkeren en de verbinding later inschakelen.

3. Kies in het veld Eigendomsmodel of u wilt dat een teamtabel in Dataverse eigenaar is van nieuwe records of een of meer specifieke gebruikers. Als u Persoon kiest, moet u elke gebruiker opgeven. Als u Team kiest, wordt de standaardbedrijfsunit weergegeven in het veld Gekoppelde bedrijfsunit.

4. Als u de verbindingsinstellingen wilt testen, kiest u Verbinding en vervolgens Verbinding testen.

   Notitie

   Als gegevensversleuteling niet is ingeschakeld in Business Central, wordt u gevraagd of u het wilt inschakelen. Als u gegevensversleuteling wilt inschakelen, kiest u Ja en geeft u de vereiste informatie op. Anders kiest u Nee. U kunt gegevenscodering later inschakelen. Zie voor meer informatie Gegevens versleutelen in Dynamics 365 Business Central in de Help voor ontwikkelaars en beheerders.

5. Als Dataverse-synchronisatie niet al is ingesteld, wordt u gevraagd of u de standaardinstellingen voor synchronisatie wilt gebruiken. Afhankelijk van of u records uitgelijnd wilt houden in Dataverse en Business Central, kiest u Ja of Nee.

De koppeling op basis van overeenkomsten aanpassen

Vanaf releasewave 2 van 2021 kan een beheerder criteria invoeren om records te koppelen op basis van overeenkomsten. U kunt het algoritme voor het matchen van records starten vanaf de volgende locaties in Business Central:

• Lijstpagina's die records tonen die zijn gesynchroniseerd met Dataverse, zoals de pagina's Klanten en Artikelen.

  Selecteer meerdere records en kies vervolgens de actie Gerelateerd, kies Dataverse, kies Koppeling en kies vervolgens Koppeling op basis van overeenkomsten.

  Wanneer u het op overeenkomsten gebaseerde koppelingsproces start vanuit een hoofdgegevenslijst, wordt er direct een koppelingstaak gepland nadat u de koppelingscriteria hebt opgegeven.

• De pagina Controle van volledige Dataverse-synchronisatie.

  Wanneer het volledige synchronisatieproces ontkoppelde records detecteert in zowel Business Central als Dataverse, wordt een koppeling Koppelingscriteria selecteren weergegeven voor de integratietabel.

  U kunt beginnen met het proces Volledige synchronisatie uitvoeren van de pagina's Dataverse-verbinding instellen en Dynamics 365-verbinding instellen. U kunt het ook starten in de begeleide instelling Een verbinding met Dataverse instellen wanneer u uw installatie voltooit.

  Wanneer u het op overeenkomsten gebaseerde koppelingsproces start vanaf de pagina Controle van volledige Dataverse-synchronisatie, wordt er direct een koppelingstaak gepland nadat u de instelling hebt voltooid.

• De lijst Toewijzingen van integratietabellen.

  Selecteer een toewijzing, kies de actie Koppeling en kies vervolgens Op overeenkomsten gebaseerde koppeling.

  Wanneer u het op overeenkomsten gebaseerde koppelingsproces start vanuit een integratietabeltoewijzing, wordt een koppelingstaak uitgevoerd voor alle ontkoppelde records in de toewijzing. U kunt ook ontkoppelde records in de lijst selecteren om de taak alleen voor die records uit te voeren.

In alle drie de gevallen wordt de pagina Koppelingscriteria selecteren geopend, zodat u de relevante koppelingscriteria kunt definiëren. Pas op deze pagina de koppeling aan met de volgende taken:

• Kies de velden die u wilt gebruiken om Business Central-records te matchen met Dataverse-entiteiten. U kunt aangeven of de overeenkomst hoofdlettergevoelig is.

• Geef op of u wilt synchroniseren nadat u records hebt gekoppeld. Als records bidirectionele toewijzing gebruiken, kunt u ook specificeren wat er gebeurt als conflicten worden vermeld op de pagina Updateconflicten oplossen.

• Geef prioriteit aan de volgorde waarin records worden doorzocht door een overeenkomstprioriteit op te geven voor de relevante toewijzingsvelden. Business Central zal zoeken naar een overeenkomst in oplopende volgorde op basis van de waarde in het veld Prioriteit overeenkomst. Een blanco waarde in het veld Prioriteit overeenkomst staat gelijk aan prioriteit 0, wat de hoogste prioriteit is. Velden met prioriteit 0 worden als eerste in overweging genomen.

• Geef op of u een nieuw entiteitsexemplaar wilt maken in Dataverse in het geval dat er geen unieke ontkoppelde overeenkomst kan worden gevonden met behulp van de matchcriteria. Om deze mogelijkheid te activeren kiest u de actie Nieuw maken als geen overeenkomst is gevonden.

De resultaten van de koppelingstaak bekijken

Om de resultaten van de koppelingstaak te bekijken opent u de pagina Integratietabeltoewijzingen, selecteert u de relevante toewijzing, kiest u de actie Koppeling actie en kiest u vervolgens de actie Taaklogbestand voor integratiekoppeling.

Als records niet kunnen worden gekoppeld, kunt u de waarde kiezen in de kolom Mislukt om een lijst met fouten te openen die beschrijven waarom dat is gebeurd.

Doorgaans mislukt de koppeling om de volgende redenen:

• Er zijn geen overeenkomstcriteria gedefinieerd

  Voer de op overeenkomsten gebaseerde koppeling opnieuw uit, maar vergeet niet om koppelingscriteria te definiëren.

• Er is geen overeenkomst gevonden voor de velden die zijn opgegeven in de overeenkomstcriteria

  Herhaal de koppeling met verschillende velden.

• Er zijn meerdere overeenkomsten gevonden voor verschillende records op basis van de velden die zijn opgegeven in de overeenkomstcriteria

  Herhaal de koppeling met verschillende velden.

• Er is een overeenkomst gevonden, maar de record is al gekoppeld aan een record in Business Central

  Herhaal de koppeling met andere velden of onderzoek waarom die Dataverse-entiteit is gekoppeld aan de record in Business Central.

Tip

Om u te helpen een overzicht te krijgen van de voortgang van de koppeling, geeft het veld Gekoppeld aan Dataverse aan of een record is gekoppeld aan een Dataverse-entiteit. U kunt het veld Gekoppeld aan Dataverse gebruiken om de lijst met records die u synchroniseert te filteren.

Verbindingen vanuit Business Central Online upgraden om op certificaten gebaseerde verificatie te gebruiken

Notitie

Deze sectie is alleen relevant voor Business Central online-tenants die worden gehost door Microsoft. Online tenants die worden gehost door ISV's en installaties op locatie worden niet beïnvloed.

In april 2022 beëindigt Dataverse het Office365-verificatietype (gebruikersnaam/wachtwoord). Voor meer informatie zie Afschaffing van het Office365-verificatietype. Bovendien beëindigt Business Central in maart 2022 het gebruik van op clientgeheimen gebaseerde service-naar-service-verificatie voor online tenants. U moet op certificaten gebaseerde service-naar-service-verificatie gebruiken voor verbindingen met Dataverse. Business Central online-tenants die worden gehost door ISV's en on-premises installaties, kunnen clientgeheimen blijven gebruiken voor verificatie.

Om te voorkomen dat integraties worden verstoord moet u upgraden om op certificaten gebaseerde verificatie te gebruiken. Hoewel de wijziging is gepland voor maart 2022, raden we u ten zeerste aan zo snel mogelijk te upgraden. In de volgende stappen wordt beschreven hoe u kunt upgraden naar verificatie op basis van certificaten.

Uw Business Central online-verbinding upgraden om op certificaten gebaseerde verificatie te gebruiken

1. Afhankelijk van of u integreert met Dynamics 365 Sales, voert u een van de volgende handelingen uit:
   • Als u dat doet, opent u de pagina Microsoft Dynamics 365-verbinding instellen.
   • Als u dat niet doet, opent u de pagina Dataverse 365-verbinding instellen.
2. Kiezen Verbinding en dan Certificaatverificatie gebruiken om de verbinding te upgraden om verificatie op basis van certificaten te gebruiken.
3. Meld u aan met beheerdersreferenties voor Dataverse. Aanmelding zou minder dan een minuut moeten duren.

Notitie

U moet deze stappen herhalen in elke Business Central-omgeving, inclusief zowel productie- als sandbox-omgevingen, en in elk bedrijf waar u een verbinding mee hebt Dataverse.

Verbinding maken met on-premises versies

Als u Business Central on-premises wilt verbinden met Dataverse, moet u wat informatie opgeven op de pagina Dataverse-verbinding instellen.

Als u verbinding wilt maken met een Microsoft Entra-account, moet u een aanvraag registreren in Microsoft Entra ID. U moet de toepassings-id, het sleutelkluisgeheim en de omleidings-URL opgeven die moet worden gebruikt. De omleidings-URL wordt vooraf ingevuld en zou voor de meeste installaties moeten werken. U moet uw installatie instellen om HTTPS te gebruiken. Zie voor meer informatie SSL configureren om de Business Central Web Client-verbinding te beveiligen. Als u uw server instelt om een andere startpagina te hebben, kunt u de URL wijzigen. Het clientgeheim wordt opgeslagen als een versleutelde tekenreeks in uw database.

Een toepassing registreren in Microsoft Entra ID voor verbinding van Business Central met Dataverse

Bij de volgende stappen wordt ervan uitgegaan dat u Microsoft Entra ID gebruikt om identiteiten en toegang te beheren. Voor meer informatie over het registreren van een toepassing in Microsoft Entra ID raadpleegt u Quickstart: een toepassing registreren bij het Microsoft-identiteitsplatform.

1. Kies in de Azure Portal onder Beheren in het navigatiedeelvenster Verificatie.

2. Voeg onder URL's omleiden de omleidings-URL toe die wordt voorgesteld op de pagina Dataverse-verbinding instellen in Business Central.

3. Kies Beheren API-machtigingen.

4. Kies onder Geconfigureerde machtigingen Een machtiging toevoegen en voeg daarna als volgt gedelegeerde machtigingen toe aan het tabblad Microsoft-API's:

   • Voeg voor Business Central de machtiging Financials.ReadWrite.All toe.
   • Voeg voor Dynamics CRM de user-impersonation-machtigingen toe.

   Notitie

   De naam van de Dynamics CRM-API kan veranderen.

5. Kies onder Beheren Certificaten en geheimen en maak vervolgens een nieuw geheim voor uw app. U gebruikt het geheim in Business Central, in het veld Clientgeheim op de pagina Dataverse-verbinding instellen of slaat het op een veilige locatie op en verschaft het in een gebeurtenisabonnee zoals eerder in dit onderwerp beschreven.

6. Kies Overzicht en zoek de waarde Toepassing (client)-id. Deze id is de client-id van uw toepassing. U moet het invoeren op de pagina Dataverse-verbinding instellen in het veld Client-id of bewaren op een veilige locatie en verschaffen in een gebeurtenisabonnee.

7. Voer in Business Central op de pagina Dataverse-verbinding instellen in het veld Omgeving-URL de URL voor uw Dataverse-omgeving in.

8. Als u de verbinding met Dataverse wilt inschakelen, zet u de schakelaar Ingeschakeld aan.

9. Meld u aan met uw beheerdersaccount voor Microsoft Entra ID (dit account moet een geldige licentie hebben voor Dataverse en een beheerder zijn in uw Dataverse-omgeving). Nadat u zich hebt aangemeld, wordt u gevraagd toe te staan dat uw geregistreerde toepassing zich aanmeldt bij Dataverse namens de organisatie. U moet toestemming geven om de instelling te voltooien.

   Notitie

   Als u niet wordt gevraagd om u aan te melden met uw beheerdersaccount, komt dit waarschijnlijk omdat pop-ups worden geblokkeerd. Sta pop-ups vanaf https://login.microsoftonline.com toe om u aan te melden.

Verbinding met Dataverse verbreken

1. Kies het , voer Dataverse-verbinding instellen in en kies vervolgens de gerelateerde koppeling.
2. Schakel op de pagina Dataverse-verbinding instellen de schakelaar Geactiveerd uit.

Zie ook

De status van een synchronisatie weergeven

U vindt hier gratis e-learningmodules voor Business Central