Anslut till Microsoft Dataverse

Anteckning

Azure Active Directory har bytt namn till Microsoft Entra ID. Läs mer

I den här artikeln beskrivs hur du upprättar en anslutning mellan Business Central och Dataverse. Vanligtvis skapar företag anslutningen för att integrera och synkronisera data med en annan Dynamics 365-affärsapp, till exempel Dynamics 365 Sales.

Innan du börjar

Det finns lite information du bör ha tillhanda innan du skapar anslutningen:

• Webbadressen (URL) till den Dataverse-miljö du vill ansluta till. Om du använder den assisterade konfigurationen för Installation av Dataverse-anslutning för att skapa anslutningen hittar vi dina miljöer. Du kan också ange URL:en till en annan miljö i klientorganisationen.
• Användarnamn och lösenord för ett konto som har administratörsbehörigheter i Business Central och Dataverse.
• Om du har en lokal Business Central, 2020 års utgivningscykel 1, version 16.5, läs då artikeln Vissa kända problem. Du måste slutföra den beskrivna lösningen innan du kan skapa anslutningen till Dataverse.
• De lokala valutor som respektive företag använder. Business Central-företag kan ansluta till en Dataverse-miljö som har en basvaluta som är en annan än dess lokala valuta. Mer information om hur du hanterar inställningar med flera valutor finns i Tillåt för olika valutor.

Viktigt

Din Dataverse-miljö får inte vara i administrationsläge. Administrationsläget gör att anslutningen misslyckas eftersom integreringsanvändarkontot för anslutningen inte har administratörsbehörighet. Mer information finns i Administrationsläge.

Anteckning

Här beskrivs proceduren för onlineversionen av Business Central. Om du använder Business Central lokalt och inte använder ett Microsoft Entra-konto för att ansluta till Dataverse måste du också ange användarnamn och lösenord för ett användarkonto för integreringen. Detta kontot kallas "integreringsanvändar"-kontot. Om du använder ett Microsoft Entra-konto krävs eller visas inte integrationens användarkonto. Integrationsanvändaren ställs in automatiskt och kräver ingen licens.

Länka din Business Central och dina Dataverse-miljöer

Företag vill hålla sin data säker och säker inom sin integritetsgräns och särskilt när deras affärshanteringsprogram integreras med andra appar. Genom att länka Business Central and Dataverse miljöer uppnår du inte bara dessa överväganden, utan ger också dina administratörer ett enklare sätt att skapa och underhålla dina integreringar med andra Dynamics 365-appar.

I Business Central administrationscentret kan du länka din Business Central-miljö till din Dataverse-miljö. Business Central kan använda informationen från länken för att göra det enklare och säkrare att integrera med andra Dynamics 365-appar, till exempel Sales och Field Service. Den länkade Dataverse-miljöns URL är till exempel tillgänglig som standard på sidan Dataverse anslutningsinställningar och när du kör den assisterade konfigurationsguiden för Dataverse-anslutningsinställningar.

Tillåt olika valutor

Business Central-företag kan ansluta till en Dataverse-miljö som har en basvaluta som är en annan än dess lokala valuta.

Anteckning

Om du vill synkronisera flera valutor måste du använda en enkelriktad synkronisering, från Business Central till Dataverse.

Mer information om basvalutan i Dataverse finns i entiteten Transaktionsvaluta (valuta).

Om du vill veta mer om valutor i Business Central går du till Valutor i Business Central.

För att möjliggöra olika valutor måste du kontrollera att du har angett följande inställningar innan du ansluter:

• Basinställningen för transaktionsvaluta i Dataverse har den valutakod som anges på sidan Valutor i Business Central.
• Det finns minst en valutakurs angiven för valutan i Business Central på sidan Valutakurser.

När du aktiverar anslutningen till Dataverse lägger Business Central till sin lokala valuta i entiteten Valuta i Dataverse. Den lokala valutan använder växelkursen från fältet Valutafaktor på sidan Valutakurser.

Eftersom valutasynkronisering är enkelriktad, från Business Central till Dataverse, konverteras och synkroniseras monetära belopp på följande sätt:

• Om i Dataverse-basvalutan konverteras belopp till den lokala Business Central-valutan baserat på den senaste valutakursen som synkroniseras från Business Central.
• Om i lokal Business Central-valuta synkroniseras belopp med lokal Business Central-valuta i någon av övriga icke-basvalutor i Dataverse.

Konfigurera en anslutning till Dataverse

För alla autentiseringstyper förutom Microsoft 365-autentisering kan du ställa in anslutningen till Dataverse på sidan Dataverse-anslutningsinställningar. För Microsoft 365-autentisering rekommenderar vi att du använder guiden för assisterad konfiguration Dataverse-anslutningsinställningar. Guiden gör det enklare att konfigurera anslutningen och specificera avancerade funktioner, till exempel ägarskapsmodell och initial synkronisering.

Viktigt

Under installationen av anslutningen till Dataverse ombeds administratören att ge följande behörigheter till en registrerad Azure-tillämpning kallad Business Central-integration för Dataverse:

• Behörigheten Öppna Dataverse som dig själv krävs, varför Business Central för administratörens räkning automatiskt kan skapa icke-interaktiva, icke-licensierade Business Central-integrationsprogramanvändare, tilldela användaren säkerhetsroller samt distribuera Business Central-integreringslösningen till Dataverse. Den här behörigheten används endast en gång vid upprättandet av anslutning till Dataverse.
• Ha fullständig åtkomst till Dynamics 365 Business Central behörighet krävs så att automatiskt skapade Business Central integrationsprogramanvändare kan komma åt Business Central data som ska synkroniseras.
• Logga in och läsa din profil behörighet krävs för att verifiera användarloggning i själva verket har säkerhetsrollen systemadministratör tilldelad i Dataverse.

Genom att ge tillstånd till organisationen, är det administratören som omnämns det registrerade Azure-programmet som kallas Business Central integration för Dataverse att synkronisera data med hjälp av automatiskt skapade Business Central användarensreferenser för integrationsprogram.

Så här använder du den assisterade guiden Konfiguration av anslutning till Dataverse

Guiden Konfiguration av anslutning till Dataverse kan göra det enklare att ansluta programmen, och kan till och med hjälpa dig att köra en första synkronisering. Om du väljer att köra inledande synkronisering kommer Business Central att granska data i båda program rekommendationer för hur man tar sig an en inledande synkronisering. Rekommendationerna beskrivs i tabellen nedan.

Rekommendation	Beskrivning
Fullständig synkronisering	Data finns bara i Business Central, eller bara i Dataverse. Rekommendationen är att synkronisera alla data från tjänsten som har den till den andra tjänsten.
Ingen synkronisering	Data finns i båda programmen, och att köra en fullständig synkronisering skulle duplicera datan. Rekommendationen är att koppla poster.
Beroendet inte uppfyllt	Data finns i båda programmen, men det går inte att synkronisera raden eller tabellen eftersom dessa är beroende av en rad eller en tabell som har rekommendationen Ingen synkronisering. Om kunder exempelvis inte kan synkroniseras kan data för kontakter som är beroende av kunddatan heller inte synkroniseras.

Viktigt

Vanligtvis använder du bara fullständig synkronisering när du integrerar programmen för första gången, och endast ett program innehåller data. Fullständig synkronisering kan vara användbar i en demonstrationsmiljö eftersom den automatiskt skapar och kopplar poster i respektive program, vilket gör det möjligt att snabbare börja arbeta med synkroniserade data. Du bör dock bara köra fullständig synkronisering om du vill ha en rad i Business Central för respektive rad i Dataverse för registermappningarna. Annars kan resultatet bli dubblettposter.

1. Välj den anger du Assisterad konfiguration och väljer sedan relaterad länk.
2. Välj Skapa en anslutning till Microsoft Dataverse för att starta den assisterade konfigurationsguiden.
3. Fyll i fälten om det behövs.

Anteckning

Om du inte uppmanas att logga in med ditt administratörskonto beror detta förmodligen på att popup-fönster blockeras. Du kan logga in med popup-fönster från https://login.microsoftonline.com.

Om du vill skapa eller hantera anslutningen manuellt

I följande procedur beskrivs hur du konfigurerar anslutningen manuellt på sidan Konfiguration av anslutning till Dataverse. Sidan Konfiguration för Dataverse-anslutning är platsen där du hanterar integreringsinställningar.

1. Välj den anger du Konfiguration av inställningen av Dataverse och väljer sedan relaterad länk.

2. Ange följande information om anslutningen från Business Central till Dataverse.

   Fält	Beskrivning
   Miljö-URL	Om du äger miljöerna i Dataverse kommer vi att hitta dem åt dig när du kör installationsguiden. Om du vill ansluta till en annan miljö i en annan klientorganisation kan du ange administratörsbehörighet för miljön, så hittar vi den.
   Aktiv	Starta använda integreringen Om du inte aktiverar anslutningen nu sparas anslutningsinställningarna, men användarna kan inte få åtkomst till data i Dataverse från Business Central. Du kan gå tillbaka till sidan och aktivera anslutningen senare.

3. I fältet Ägarskapsmodlel väljer du om du vill att en grupptabell i Dataverse ska äga nya transaktioner, eller om en eller flera specifika användare ska göra det. Om du väljer Person måste du ange varje enskild användare. Om du väljer Team visas den förvalda affärsenheten i fältet Kopplad affärsenhet.

4. Kontrollera anslutningsinställningarna genom att välja Anslutning och sedan Testa anslutning.

   Anteckning

   Om datakrypteringen inte har aktiverats i Business Central kommer du att tillfrågas om du vill aktivera den. Välj Ja och ange den obligatoriska informationen om du vill aktivera datakryptering. Annars väljer du Nej. Du kan aktivera datakryptering senare. Mer information finns i kryptering av data i Dynamics 365 Business Central i Hjälp för utvecklare och administration.

5. Om Dataverse-synkroniseringen inte redan har ställts in får en fråga om du vill använda standardsynkroniseringskonfigurationen. Beroende på om du vill bokföra poster justerade i Dataverse och Business Central, välj Ja eller Nej.

Anpassa matchningsbaserad koppling

Från och med 2021 års utgivningscykel 2 kan en administratör ange kriterier i syfte att koppla poster baserade på matchningar. Du kan köra algoritmen för matchande poster från följande platser i Business Central:

• Lista sidor som visar poster som är synkroniserade med Dataverse, till exempel sidorna kunder och artiklar.

  Markera flera poster och välj sedan åtgärden relaterad, välj Dataverse, välj koppling och sedan Matchbaserad koppling.

  När du inleder den matchande kopplingsmetoden från en huvuddatalista schemaläggs ett kopplingsprojekt direkt efter att du har anget kopplingskriteriet.

• Sidan Dataverse Fullständig synk.granskning.

  När hela synkroniseringsprocessen upptäcker att du har frikopplade poster i Business Central och i Dataverse, visas en Välj kopplingskriterier-länk för integrationstabellen.

  Du kan starta processen Kör fullständig synkronisering från sidorna Konfiguration av Dataverse-anslutning och Anslutningsinställningar för Dynamics 365. Du kan också starta processen i den assisterade konfigurationen Konfigurera en anslutning till Dataverse när du är klar med inställningarna.

  När du startar den matchningsbaserade kopplingsprocessen från sidan Full Dataverse-sykronisering schemaläggs ett kopplingsprojekt efter att du har slutfört konfigurationen.

• Listan integreringstabellens mappningslista list.

  Välj en mappning, välj åtgärden koppling och välj sedan Matchningsbaserad koppling.

  När du startar den matcningsbaserade kopplingsprocessen från en mappning för integrationstabellen kommer ett kopplingsprojekt att köras för alla icke-kopplade poster i mappningen. Du kan också välja att icke-kopplade poster i listan så att projektet bara körs för de posterna.

I alla tre fallen öppnas sidan Välj kopplingsvillkor så att du kan definiera relevanta kopplingskriterier. Anpassa kopplingarna med följande uppgifter på den här sidan:

• Välj de fält som ska användas för att matcha Business Central-poster med Dataverse-entiteter. Du kan ange huruvida matchningen är skiftlägeskänslig.

• Ange om du vill synkronisera efter att du kopplat poster. Om posterna använder dubbelriktad mappning kan du också ange vad som ska hända om konflikter visas på sidan Lös uppdateringskonflikter.

• Prioritera ordningen som posterna genomsöks i genom att ange en matchningsprioritet för relevanta mappningsfält. Business Central söker efter en matchning i stigande ordning baserat på värdet i fältet Matcha prioritet. Ett tomt värde i fältet Matchningsprioritet är lika med prioritet 0, som är högsta prioritet. Fält med prioritet 0 beaktas först.

• Ange om du vill skapa en ny entitetsinstansen i Dataverse om det inte går att hitta någon icke unik ej kopplad matchning med hjälp av matchningsvillkoret. Om du vill aktivera funktionen väljer du åtgärden Skapa ny om det inte går att hitta någon matchning.

Visa resultatet av kopplingsprojektet

Om du vill visa resultatet av kopplings projektet öppnar du sidan Registermappningar för integrering, väljer lämplig mappning, väljer kopplingsåtgärd och väljer sedan åtgärden Logg över integrationskopplingsprojekt.

Om det inte går att koppla poster kan du välja värdet i kolumnen Misslyckade om du vill öppna en lista över fel som beskriver orsaken.

Kopplingen misslyckas vanligen av följande orsaker:

• Inga matchningsvillkor har definierats

  Kör den matchningsbaserade kopplingen igen, men tänk på att definiera kopplingskriterier.

• Det gick inte att hitta någon matchning för de fält som har angetts i matchningsvillkoret

  Upprepa kopplingen med hjälp av olika fält.

• Flera matchningar hittades för ett flertal poster, baserat på de fält som angets i matchande villkor

  Upprepa kopplingen med hjälp av olika fält.

• En enskild matchning hittades, men motsvarande post är redan kopplad till en post i Business Central

  Upprepa kopplingarna med olika fält, eller undersök varför Dataverse-entiteten är kopplad till posten i Business Central.

Dricks

För att hjälpa dig att få en överblick över kopplingens framsteg visar föltet Kopplad till Dataverse om en specifik post är kopplad till en Dataverse-entitet eller inte. Du kan använda fältet Kopplad till Dataverse om du vill filtrera postlistan som du synkroniserar.

Uppgradera anslutningar från Business Central Online till använda certifikatbaserad autentisering

Anteckning

Det här avsnittet är endast relevant för innehavaradministration i Business Central online som Microsoft har. Online innehavaradministratörer som körs av ISV och lokala installationer påverkas inte.

I april 2022 förklarar Dataverse autentiseringstypen Office365 som inaktuell (användarnamn/lösenord). Mer information finns i avsnittet Avskrivning autentiseringstyp av Office 365. I mars 2022 förklarar dessutom Business Central användningen av klienthemlighetsbaserad autentisering tjänst-till-tjänst som inaktuell för online-klientorganisationer. Du måste använda certifikatbaserad tjänst-till-tjänst-autentisering för anslutningar till Dataverse. Business Central-onlineklientorganisationer som är värdbaserade hos oberoende mjukvaruleverantörer (ISV) kan fortsätta att använda klienthemligheter för autentisering.

För att undvika störningar i integrationen måste du uppgradera anslutningen så att den använder certifikatbaserad autentisering. Ãven om ändringen är planerad till mars 2022 rekommenderar vi starkt att du uppgraderar så snart som möjligt. Följande steg beskriver hur du uppgraderar till certifikatbaserad autentisering.

För att uppgradera din Business Central online-anslutning för att använda certifikatbaserad autentisering

1. Gör något av följande beroende på om du har integrerat med Dynamics 365 Sales:
   • Om du vill kan du öppna sidan Microsoft Dynamics 365 anslutningsinställning.
   • Om du vill kan du öppna sidan Dataverse anslutningsinställning.
2. Välj anslutning och sedan Använd certifikatautentisering för att uppgradera anslutningen till att använda certifikatbaserad autentisering.
3. Logga in med administratörsautentiseringsuppgifter för Dataverse. Inloggningen tar mindre än en minut.

Anteckning

Du måste upprepa dessa steg i varje Business Central-miljö, inklusive både produktions- och miljöer i begränsat läge och i varje företag där du är ansluten till Dataverse.

Ansluta lokala versioner

Om du vill ansluta Business Central lokalt till Dataverse måste du ange viss information på Dataverse anslutningsinställningar.

För att ansluta med ett Microsoft Entra-konto måste du registrera ett program i Microsoft Entra ID. Du måste tillhandahålla det program-ID, den nyckelvalvshemlighet och den omdirigerings-URL som ska användas. URL-adressen för omdirigering fylls i förväg och bör användas för de flesta installationer. Du måste ställa in installationen för att använda HTTPS. Mer information finns i Konfigurera SSL för att skydda anslutningen till Business Central webbklienten. Om du konfigurerar servern så att den får en annan startsida kan du alltid ändra URL-adressen. Klientens hemlighet kommer att sparas som en krypterad sträng i databasen.

Så här registrerar du ett program i Microsoft Entra ID för att ansluta från Business Central till Dataverse

Följande åtgärder förutsätter att du använder Microsoft Entra ID för att hantera identiteter och åtkomst. Mer information om hur du registrerar ett program i Microsoft Entra ID finns i Snabbstart: Registrera ett program med Microsoft Identity Platform.

1. I Azure Portal, under Hantera i navigeringsrutan välj autentisering.

2. Under omdirigerings-URL, lägger du till den omdirigerings-URL som föreslås på sidan Inställningar för Dataverse-anslutning i Business Central.

3. Under Hantera, välj API-behörigheter.

4. Under konfigurerade behörigheter väljer du Lägg till en behörighet och lägger sedan till delegerade behörigheter på fliken Microsoft API:er på följande sätt:

   • För Business Central lägger du till Financials.ReadWrite.All behörighet.
   • För Dynamics CRM lägg till behörigheter user_impersonation.

   Anteckning

   Namnet på Dynamics CRM API kan ändras.

5. Under Hantera, välj Certifikat och hemligheter och skapa sedan en ny hemlighet för ditt program. Du kommer att använda hemligheten i Business Central i fältet klienthemlighet på sidan inställningar för Dataverse-anslutning, eller lagra i en skyddad lagringsenhet och tillhandahålla den i en händelseprenumerant enligt beskrivningen ovan.

6. Välj Översikt och leta sedan reda på App (klient-ID)-värdet. Detta ID är klient-ID:t för ditt program. Du måste ange den på sidan inställningar för Dataverse-anslutning i fältet klient-ID eller lagra den på ett säkert lagringsutrymme och tillhandahålla den i en händelseprenumeration.

7. I Business Central, på sidan inställningar av Dataverse-anslutning i fältet Miljö-URL anger du URL för din Dataverse miljö.

8. För att aktivera anslutningen till Dataverse, aktivera växlingen Aktiverad.

9. Logga in med ditt administratörskonto för Microsoft Entra ID (det här kontot måste ha en giltig licens för Dataverse och vara administratör i din Dataverse-miljö). När du har loggat in kommer du att uppmanas att tillåta att ditt registrerade program loggar in på Dataverse å ditt företags vägnar. Du måste ange ett medgivande för att slutföra installationen.

   Anteckning

   Om du inte uppmanas att logga in med ditt administratörskonto beror det förmodligen på att popup-fönster blockeras. Du kan logga in med popup-fönster från https://login.microsoftonline.com.

Koppla bort från Dataverse

1. Välj den anger du Konfiguration av inställningen av Dataverse och väljer sedan relaterad länk.
2. På sidan Konfiguration av anslutning till Dataverse stänger du av reglaget Aktiverad.

Se även

Visa status för en synkronisering

Sök efter gratis e-inlärningsmoduler för Business Central här