Verbinding maken met Microsoft Dataverse
Notitie
Azure Active Directory is 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 Verbinden omzetten naar a Dataverse omgeving met een basisvaluta die verschilt van hun lokale valuta. Ga naar Meerdere valuta's toestaan voor meer informatie over het omgaan met instellingen voor meerdere valuta's.
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.
Opmerking
Deze stappen beschrijven de procedure voor de online versie van Business Central Online. Als u Business Central on-premises gebruikt en geen Microsoft Entra account gebruikt voor Verbinden naar 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, voldoet u niet alleen aan deze vereisten, maar biedt u uw beheerders ook een eenvoudigere manier om integraties met andere Dynamics 365-apps te maken en te onderhouden.
In de Business Central Beheercentrum kunt u uw Business Central omgeving koppelen koppelen aan uw Dataverse omgeving. Business Central kan de informatie uit koppelen gebruiken om de integratie met andere Dynamics 365-apps, zoals Sales en Field Service, eenvoudiger en veiliger te maken. De gekoppelde URL Dataverse omgeving is bijvoorbeeld standaard beschikbaar op de pagina Dataverse Verbindingsinstellingen en wanneer u de door Dataverse Verbindingsinstellingen ondersteunde installatie uitvoert, guide.
Verschillende valuta's toestaan
Business Central-bedrijven kunnen Verbinden omzetten naar a Dataverse omgeving met een basisvaluta die verschilt van hun lokale valuta.
Notitie
Voor het synchroniseren van meerdere valuta's is een unidirectionele synchronisatie vereist, van Business Central naar Dataverse.
Ga naar de entiteit Dataversetransactievaluta (valuta) voor meer informatie over de basisvaluta in.
Ga naar Valuta's in Business Central voor meer informatie over 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 basisvaluta-instelling voor de transactie in Dataverse heeft de valutacode die is opgegeven op de pagina Valuta's in Business Central.
- Er is minimaal één wisselkoers opgegeven voor de valuta in Business Central op de pagina Wisselkoersen .
Wanneer u de verbinding met Dataverse inschakelt, voegt Business Central de code lokale valuta toe aan de entiteit Valuta in Dataverse. De lokale valuta gebruikt de wisselkoers uit het veld Valutafactor op de pagina Wisselkoersen .
Omdat de synchronisatie van valuta's unidirectioneel is, worden geldbedragen van Business Central naar Dataverse als volgt geconverteerd en gesynchroniseerd:
- Als de bedragen in de basisvaluta staan, worden ze geconverteerd naar de Business Central-code lokale valuta op basis van de laatste wisselkoers die is gesynchroniseerd vanuit Business Central. Dataverse
- Als in de Business Central lokale valuta bedragen worden gesynchroniseerd met de Business Central lokale valuta in een van de extra, niet-basisvaluta's in Dataverse.
Maak een verbinding met Dataverse
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:
- toegang Dataverse als u machtigingen nodig hebt, zodat Business Central namens de beheerder automatisch een niet-gelicentieerde, niet-interactieve Business Central Integration-toepassingsgebruiker kan aanmaken, beveiligingsrollen aan deze gebruiker kan toewijzen en Business Central Integration Solution kan implementeren op Dataverse. Deze toestemming wordt slechts één keer gebruikt tijdens het instellen van de verbinding met Dataverse.
- Volledige toegang is vereist zodat de gebruiker van de automatisch aangemaakte Business Central Integration-applicatie toegang heeft tot Business Central-gegevens die worden gesynchroniseerd. Dynamics 365 Business Central
- Meld u aan en lees uw profiel er is toestemming nodig om te verifiëren of de gebruiker die zich aanmeldt daadwerkelijk de beveiligingsrol Systeembeheerder heeft toegewezen 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. |
| Afhankelijkheid niet voldaan | 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.
- Kies het pictogram
, voer Assisted Setup in en kies vervolgens de gerelateerde koppelen. - Kies Een verbinding instellen met Microsoft Dataverse om de begeleide instelling te starten.
- Vul de vereiste velden in.
Opmerking
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.
Kies het pictogram
, voer Dataverse Verbindingsinstellingen in en kies vervolgens de gerelateerde koppelen.Voer de volgende gegevens in voor de verbinding van Business Central met Dataverse.
Veld Omschrijving omgeving-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. 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.
Als u de verbindingsinstellingen wilt testen, kiest u Verbinding en vervolgens Verbinding testen.
Opmerking
Als gegevensversleuteling niet is geactiveerd 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.
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 afstemmen 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
- 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.
- Kiezen Verbinding en dan Certificaatverificatie gebruiken om de verbinding te upgraden om verificatie op basis van certificaten te gebruiken.
- Meld u aan met beheerdersreferenties voor Dataverse. Aanmelding zou minder dan een minuut moeten duren.
Opmerking
U moet deze stappen herhalen in elke Business Central-omgeving, inclusief zowel productie- als sandbox-omgevingen, en in elk bedrijf waar u een verbinding hebt met 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. Zie Microsoft Entra Snelstart: Een toepassing registreren bij het Microsoft Identity Platform voor meer informatie over het registreren van een toepassing in ID.
Kies in de Azure Portal onder Beheren in het navigatiedeelvenster Verificatie.
Voeg onder URL's omleiden de omleidings-URL toe die wordt voorgesteld op de pagina Dataverse-verbinding instellen in Business Central.
Kies Beheren API-machtigingen.
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.
Opmerking
De naam van de Dynamics CRM-API kan veranderen.
Kies onder Beheren de optie 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.
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.
Voer in Business Central op de pagina Dataverse-verbinding instellen in het veld Omgeving-URL de URL voor uw Dataverse-omgeving in.
Als u de verbinding met Dataverse wilt inschakelen, zet u de schakelaar Ingeschakeld aan.
Meld u aan met uw beheerdersaccount voor Microsoft Entra ID (dit account moet een geldige licentie hebben voor Dataverse en 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.
Opmerking
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.comtoe om u aan te melden.
Verbinding met Dataverse verbreken
- Kies het pictogram , voer Dataverse Verbindingsinstellingen in en kies vervolgens de gerelateerde koppelen.
- Schakel op de pagina Dataverse-verbinding instellen de schakelaar Geactiveerd uit.