Opret forbindelse til Microsoft Dataverse

Bemærk

Azure Active Directory er nu Microsoft Entra ID. Få mere at vide

Denne artikel beskriver, hvordan du konfigurerer en forbindelse mellem Business Central og Dataverse. Virksomheder opretter typisk forbindelsen for at integrere og synkronisere data med en anden Dynamics 365-forretningsapp såsom Dynamics 365 Sales.

Før du starter

Der er et par oplysninger, som du skal have klar, før du opretter forbindelsen:

  • URL-adressen til det Dataverse-miljø, som du vil oprette forbindelse til. Hvis du bruger den Konfiguration af Dataverse-forbindelse-assisterende installationsvejledning til at oprette forbindelsen, vil vi finde dine miljøer. Du kan også angive URL-adressen på et andet miljø i din lejer.
  • Brugernavn og adgangskode til en konto, der har administratorrettigheder i Business Central og Dataverse.
  • Hvis du har en lokal Business Central 2020 Release Wave 1, version 16,5, skal du læse Kendte problemer-artikler. Du skal fuldføre den beskrevne løsning, før du kan oprette forbindelsen til Dataverse.
  • De lokale valutaer, som hvert firma bruger. Business Central-firmaer kan oprette forbindelse til et Dataverse-miljø, der har en basisvaluta, der er anderledes end deres lokale valuta.. Du kan få mere at vide om, hvordan du håndterer konfigurationer af flere valutaer, ved at gå til Tillad for forskellige valutaer.

Vigtigt

Det Dataverse-miljø må ikke være i administrationstilstand. Administrationstilstand forårsager, at forbindelsen mislykkes, fordi integrationsbruger kontoen for forbindelsen ikke har administratorrettigheder. Der er flere oplysninger i Administrationstilstand.

Bemærk

I fremgangsmåden nedenfor beskrives proceduren for onlineversionen af Business Central. Hvis du bruger Business Central on-premises og ikke bruger en Microsoft Entra-konto til at oprette forbindelse til Dataverse, skal du også angive brugernavn og adgangskode for en brugerkonto til integrationen. Denne konto kaldes "integrationsbruger"-kontoen. Hvis du bruger en Microsoft Entra-konto, er integrationsbrugerkontoen ikke påkrævet og vises ikke. Integrationsbrugeren konfigureres automatisk og kræver ikke en licens.

Virksomheder ønsker at holde deres data sikre inden for deres privatlivsgrænse, og især når deres forretningsadministrationsapplikation integreres med andre apps. Ved at sammenkæde Business Central- og Dataverse-miljøer opnår du ikke kun disse overvejelser, men giver også dine administratorer en nemmere måde at oprette og vedligeholde dine integrationer med andre Dynamics 365-apps på.

I Business Central Administration kan du knytte dit Business Central miljø til dit Dataverse miljø. Business Central kan bruge oplysningerne fra linket til at gøre det nemmere og mere sikkert at integrere med andre Dynamics 365-apps, f.eks. Sales og Field Service. URL-adressen til det sammenkædede Dataverse miljø er f.eks. tilgængelig som standard på siden Dataverse Opsætning af forbindelse, og når du kører den assisterede opsætningsvejledning til Opsætning af Dataverse-forbindelse.

Tillad for forskellige valutaer

Business Central-firmaer kan oprette forbindelse til et Dataverse-miljø, der har en basisvaluta, der er anderledes end deres lokale valuta..

Bemærk

Synkronisering af flere valutaer kræver, at du bruger en ensrettet synkronisering, fra Business Central til Dataverse.

Du kan få mere at vide om basisvalutaen i Dataverse ved at gå til objektet Transaktionsvaluta (valuta).

Hvis du vil vide mere om valutaer i Business Central, gå til Valutaer i Business Central.

Hvis du vil tillade forskellige valutaer, skal du sørge for, at du har angivet følgende indstillinger, før du opretter forbindelse:

  • Indstillingen for basistransaktionsvaluta i Dataverse har den valutakode, der er angivet på siden Valutaer i Business Central.
  • Der er angivet mindst én valutakurs for valutaen i Business Central på siden Valutakurser.

Når du aktiverer forbindelsen til Dataverse, tilføjes Business Central dens lokale valuta til valuta-objektet i Dataverse. Den lokale valuta bruger valutakursen fra feltet Valutafaktor på siden Valutakurser.

Da synkronisering af valuta er envejs, fra Business Central til Dataverse,konverteres og synkroniseres monetære beløb på følgende måde:

  • Beløbene i Dataverse-basisvalutaen konverteres til den Business Central lokale valuta ud fra den seneste valutakurs, der er synkroniseret fra Business Central.
  • Beløb i den Business Central lokale valuta synkroniseres med den Business Central lokale valuta i en af de andre (ikke-basis) valutaer i Dataverse.

Konfigurer en forbindelse til Dataverse

For alle andre godkendelsestyper end Microsoft 365-godkendelse kan du konfigurere forbindelse til Dataverse på siden Konfiguration af Dataverse-forbindelse. For Microsoft 365-godkendelse anbefaler vi, at du bruger vejledningen Opsætning af Dataverse-forbindelse med assisteret opsætning. Denne vejledning gør det nemmere at oprette forbindelsen og angive avancerede funktioner, f.eks. ejerskabsmodel og indledende synkronisering.

Vigtigt

Under konfigurationen af forbindelsen til Dataverse bliver administratoren bedt om at give følgende tilladelser til det registrerede Azure-program, der hedder Business Central-integration med Dataverse:

  • Få adgang til Dataverse som nødvendig tilladelse, så du Business Central kan, på vegne af administratoren, automatisk oprette en ikke-licenseret, ikke-interaktiv Business Central-integrationsprogrambruger, tildele sikkerhedsroller til denne bruger og installere Business Central-integrationsløsningen til Dataverse. Denne tilladelse bruges kun én gang under oprettelse af forbindelse til Dataverse.
  • Fuld adgang til Dynamics 365 Business Central er en nødvendig tilladelse, så en automatisk oprettet Business Central-integrationsprogrambruger kan få adgang til Business Central-data, der skal synkroniseres.
  • Logge på og læse din profil er en nødvendig tilladelse for at kontrollere, at brugeren, som logger på, faktisk er tildelt Systemadministrator som sikkerhedsrolle i Dataverse.

Ved at give samtykke på vegne af organisationen giver administratoren det registrerede Azure-program, der hedder Business Central-integration til Dataverse, ret til at synkronisere data ved hjælp af den automatisk oprettede Business Central-integrationsprogrambrugers legitimationsoplysninger.

Sådan bruger du vejledningen Dataverse-forbindelsesopsætning med assisteret opsætning

Dataverse-forbindelsesopsætningsvejledning kan gøre det nemmere at oprette forbindelse til programmerne, og det kan også være en hjælp til at starte en første synkronisering. Hvis du vælger at køre første synkronisering, gennemgår Business Central dataene i begge programmer og giver anbefalinger om, hvordan du skal håndtere den første synkronisering. Den følgende tabel beskriver de forskellige anbefalinger.

Anbefaling Beskrivlse
Fuld synkronisering Dataene findes kun i Business Central, eller kun i Dataverse. Det anbefales at synkronisere alle data fra den tjeneste, der har den til den anden tjeneste.
Ingen synkronisering Dataene findes i begge programmer, og hvis du udfører fuld synkronisering, duplikeres dataene. Det anbefales at koble registreringer.
Afhængighed er ikke opfyldt Der findes data i begge programmer, men rækken eller tabellen kan ikke synkroniseres, fordi den afhænger af en række eller en tabel, der ikke har nogen synkroniserings anbefaling. Hvis kunder f.eks. ikke kan synkroniseres, kan data til kontakter, der afhænger af kundedata, ikke synkroniseres.

Vigtigt

Du bruger som regel kun fuld synkronisering, når du integrerer programmerne første gang, og kun ét program indeholder data. Fuld synkronisering kan være nyttig i et demonstrationsmiljø, da det automatisk opretter og forbinder poster i hvert program, hvilket gør det hurtigere at starte med at arbejde med synkroniserede data. Men du bør kun udføre en fuldstændig synkronisering, hvis du ønsker en række i Business Central for hver række i Dataverse for de givne tabeltilknytninger. Ellers kan resultatet være duplikerede poster.

  1. Vælg Lightbulb, der åbner funktionen Fortæl mig. ikon, angiv Assisteret opsætning og vælg derefter det relaterede link.
  2. Vælg Konfigurer en forbindelse til Microsoft Dataverse for at starte den assisterede opsætningsvejledning.
  3. Udfyld felterne efter behov.

Bemærk

Hvis du ikke bliver bedt om at logge på med din administratorkonto, skyldes det sandsynligvis, at pop op-vinduer er blokeret. Du kan logge på ved at tillade pop op-vinduer fra https://login.microsoftonline.com.

Sådan oprettes eller vedligeholdes forbindelsen manuelt

Følgende procedure beskriver, hvordan du kan opsætte forbindelsen manuelt på siden Dataverse-forbindelsesopsætning. Siden Konfiguration af Dataverse-forbindelse er den side, hvor du administrerer indstillingerne.

  1. Vælg Lightbulb, der åbner funktionen Fortæl mig. ikon, skriv Dataverse-forbindelseskonfiguration, og vælg derefter det relaterede link.

  2. Indtast følgende oplysninger vedrørende forbindelsen fra Business Central til Dataverse.

    Felt Beskrivlse
    URL-adresse til miljø Hvis du ejer miljøer i Dataverse, finder vi dem for dig, når du kører installationsvejledningen. Hvis du vil oprette forbindelse til et andet miljø i en anden lejer, kan du angive administrator-legitimationsoplysninger til miljøet, og dem vil vi registrere.
    Aktiveret Begynd at bruge integrationen. Hvis du ikke kan aktivere forbindelse nu, gemmes forbindelsesindstillingerne, men brugerne vil ikke kunne få adgang til Dataverse data fra Business Central. Du kan vende tilbage til denne side og aktivere forbindelsen senere.
  3. I feltet Ejerskabsmodel skal du vælge, om du vil have en teamtabel i Dataverse, der skal eje nye poster, eller om der skal være en eller flere bestemte brugere. Hvis du vælger Person, skal du angive hver enkelt bruger. Hvis du vælger Team, vises standard-koncernvirksomheden i feltet Sammenkædet koncernvirksomhed.

  4. Du kan teste forbindelsesindstillingerne ved at vælge Forbindelse og derefter Test forbindelse.

    Bemærk

    Hvis datakryptering ikke er aktiveret i Business Central, bliver du spurgt, om du vil aktivere den. Du aktiverer datakryptering ved at vælge Ja og angive de nødvendige oplysninger. Ellers skal du vælge Nej. Du kan aktivere datakryptering senere. Du kan finde flere oplysninger i Kryptere data i Dynamics 365 Business Central i hjælp til udvikleren og administrationen.

  5. Hvis Dataverse-synkronisering ikke allerede er konfigureret, bliver du spurgt, om du vil bruge standardkonfigurationen for synkronisering. Afhængigt af om du vil bevare poster justeret i Dataverse og Business Central, skal du vælge Ja eller Nej.

Tilpas den matchbaserede sammenkædning

Fra 2021 udgivelsesbølge 2 kan en administrator angive kriterier for at sammenkæde poster baseret på matches. Du kan starte algoritmen til identiske poster kan startes fra følgende placeringer i Business Central:

  • Vis sider, der viser poster, som er synkroniseret med Dataverse, f. eks. siderne kunder og varer.

    Vælg flere poster, vælg derefter den relaterede handling, Vælg Dataverse, vælg sammenkædning, og vælg derefter matchbaseret sammenkædning.

    Når du starter den match baserede sammenkædningsproces startes fra en Master dataliste, planlægges et sammenkædningsjob, umiddelbart efter at du har valgt sammenkædningskriterierne.

  • Siden Dataverse Fuld synkroniseringsgennemgang.

    Når hele synkroniseringsprocessen registrerer, at du har ikke-sammenkædede poster både i Business Central og i Dataverse, vises der et Vælg sammenkædningskriterie-link for den relevante integrationstabel.

    Du kan starte processen Kør fuld synkronisering fra siderne Konfiguration af Dataverse-forbindelse og Opsætning af Dynamics 365-forbindelse. Du kan også starte den i Konfigurer en forbindelse til Dataverse-assisteret installationsprogram, når du har fuldført installationen.

    Når du starter den matchbaserede sammenkædningsproces startes fra siden Dataverse Fuld synkroniseringsgennemgang, planlægges et sammenkædningsjob, umiddelbart efter at du har fuldført opsætningen.

  • Listen Integrationstabelstilknytning.

    Vælg en tilknytning, Vælg handlingen Sammenkædning, og vælg derefter Match-baseret sammenkædning.

    Når du starter den matchbaserede sammenkædningsproces startes fra en integrationstabeltilknytning, køres der et sammenkædningsjob for alle ikke-tilknyttede poster i tilknytningen. Du kan også vælge ikke-koblede poster på listen for at køre kun opgaven for de pågældende poster.

I alle tre tilfælde åbnes siden Vælg sammenkædningskriterier, så du kan definere de relevante sammenkædningskriterier. På denne side kan du tilpasse sammenkædningen med følgende opgaver:

  • Vælg de felter, der skal bruges til at matche Business Central-poster med Dataverse-enheder. Du kan angive, om der er forskel på store og små bogstaver.

  • Angiv, om du vil synkronisere, når du har koblet posterne. Hvis der bruges tovejs tilknytning af poster, kan du også angive, hvad der sker, hvis konflikter er angivet på siden Løs Opdateringskonflikter.

  • Prioritere den rækkefølge, som poster gennemsøges i, ved at angive en matchprioritet for de relevante tilknytningsfelter. Business Central søger efter et match i stigende rækkefølge på grundlag af værdien i feltet Match prioritet. En tom værdi i feltet Match prioritet er lig med prioriteten 0, som er den højeste prioritet. Felter med prioriteten 0 behandles først.

  • Angiv, om der skal oprettes en ny enhedsforekomst i Dataverse, hvis der ikke er en entydig, ikke-sammenkoblet match, ved hjælp af søgekriterierne. Hvis du vil aktivere denne funktion, skal du markere afkrydsningsfeltet Opret ny, hvis der ikke findes en match-handling.

Vis resultaterne af sammenkædningssagen

Hvis du vil have vist resultaterne af sammenkædningssagen, skal du åbne siden integrationstabeltilknytninger, vælge den relevante tilknytning, vælge sammenkædningshandlingen og derefter vælge handlingen foretag tilknytning af integrationssammenkædningsjob.

Hvis der ikke er flere poster, kan du vælge værdien i kolonnen Mislykkede for at åbne en liste over fejl, der beskriver, hvorfor det skete.

Koblingen mislykkes typisk af følgende årsager:

  • Der blev ikke defineret overensstemmende kriterier

    Kør den match-baserede sammenkædning igen, men husk at definere sammenkædningskriterierne.

  • Der blev ikke fundet noget resultat for de felter, der er angivet i matchkriterier

    Gentag tilkoblingen med forskellige felter.

  • Der er fundet flere matches for flere poster, baseret på de felter, der er angivet i matchende kriterier

    Gentag tilkoblingen med forskellige felter.

  • Der blev fundet et match, men posten er allerede kombineret med en post i Business Central

    Gentag sammenkædningen med andre felter eller undersøg, hvorfor enheden Dataverse er sammenkædet til den pågældende post i Business Central.

Tip

For at hjælpe dig med at få et overblik over fremdriften i koblingen viser feltet sammenkoblet til Dataverse, om en bestemt post er koblet til en Dataverse-enhed. Du kan bruge feltet Sammenkoblet med Dataverse til at filtrere listen over poster, som du synkroniserer.

Opgradere forbindelser fra Business Central Online for at bruge certifikatbaseret godkendelse

Bemærk

Dette afsnit er kun relevant for Business Central online-lejere, der er hosted af Microsoft. Online-arkitekturer, der er hosted af ISV'er og lokale installationer, påvirkes ikke.

I april 2022 udfases Dataverse Office365-godkendelsestypen (username/password). Du kan finde flere oplysninger i Frarådelse af Office365-godkendelsestype. I marts 2022 Business Central udfases desuden brug af klient hemmelig baseret service-to-service-godkendelse til online lejeres. Du skal bruge certifikatbaseret service-til-tjeneste-godkendelse til forbindelser med Dataverse. Business Central online-lejere, der er hosted af ISV'er og lokale installationer, kan fortsætte med at bruge klientens hemmeligheder til godkendelse.

Hvis du vil undgå at afbryde integration, skal du opgradere forbindelsen til at bruge certifikatbaseret godkendelse. Selvom der er planlagt ændringer for marts 2022, anbefaler vi på det kraftigste, at du opgraderer så hurtigt som muligt. Følgende fremgangsmåde beskriver, hvordan du opgraderer til certifikatbaseret godkendelse.

Opgradere forbindelser fra Business Central Online til brug certifikatbaseret godkendelse

  1. Afhængigt af om du integrerer med Dynamics 365 Sales, skal du benytte en af følgende fremgangsmåder:
    • Hvis du gør det, skal du åbne siden Microsoft Dynamics 365-forbindelseskonfiguration.
    • Hvis du ikke gør det, skal du åbne siden Dataverse-forbindelseskonfiguration.
  2. Vælg Forbind, og derefter Brug certifikatgodkendelse til at opgradere forbindelsen til at bruge certifikatbaseret godkendelse.
  3. Log ind med administratorrettigheder til Dataverse. Det bør tage mindre end et minut at logge på.

Bemærk

Du skal gentage disse trin i hvert Business Central-miljø, herunder både produktions-og sandkasse miljøer, og i hvert regnskab, du har forbindelse til Dataverse.

Tilslutning af lokale versioner

Hvis du vil forbinde Business Central i det lokale miljø med Dataverse, skal du angive nogle oplysninger på siden Konfiguration af Dataverse-forbindelse.

Hvis du vil oprette forbindelse ved hjælp af en Microsoft Entra-konto, skal du registrere et program i Microsoft Entra ID. Du kan også angive program-id, key vault-hemmeligheden og omdirigere den URL-adresse, der skal bruges. URL-adressen til omdirigering er forudindstillet og bør fungere for de fleste installationer. Du skal konfigurere installationen til at bruge HTTPS. Du kan finde flere oplysninger i Konfigurere SSL for at sikre forbindelsen til Business Central-webklienten. Hvis du konfigurerer serveren, så den har en anden startside, kan du altid ændre URL-adressen. Klientens hemmelighed gemmes som en krypteret streng i din database.

Sådan registrerer du et program i Microsoft Entra ID for at oprette forbindelse fra Business Central til Dataverse

I følgende trin antages det, at du bruger Microsoft Entra ID til at administrere identiteter og adgangsrettigheder. Du kan finde flere oplysninger om registrering af et program i Microsoft Entra ID under Hurtig start: registrere et program på Microsoft-identitetsplatformen.

  1. Vælg Godkendelse under Administrer i navigationsruden på Azure-portalen.

  2. Tilføj under URL-adresse til omdirigering den URL-adresse til omdirigering, der foreslås på siden til Konfiguration af Dataverse-forbindelse i Business Central.

  3. Vælg API-tilladelser under Administrer.

  4. Vælg Tilføj en tilladelse under Konfigurerede tilladelser, og tilføj derefter delegerede tilladelser under fanen Microsoft API'er på følgende måde:

    • For Business Central skal du tilføje tilladelserne Financials.ReadWrite.All.
    • For Dynamics CRM skal du tilføje tilladelserne user_impersonation.

    Bemærk

    Navnet på Dynamics CRM-API'en ændres muligvis.

  5. Vælg Certifikater og hemmeligheder under Administrer, og opret derefter en ny hemmelighed til din app. Du skal enten bruge hemmeligheden i Business Central, i feltet Klienthemmelighed på siden til Konfiguration af Dataverse-forbindelse eller gemme den i et sikkert lager og angive den i en hændelsesabonnent som beskrevet tidligere i dette emne.

  6. Vælg Oversigt, og find derefter Program-id (klient)-værdien . Dette id er klient-id til programmet. Du skal enten angive det på siden Konfiguration af Dataverse-forbindelse i feltet Klient-id eller gemme det i et sikkert lager og angive det i en hændelsesabonnent.

  7. I Business Central skal du på siden Konfiguration af Dataverse-forbindelse i feltet URL-adresse for miljø angive URL-adressen til dit Dataverse-miljø.

  8. Du skal aktivere forbindelsen til Dataverse ved at slå Aktiveret til.

  9. Log på med din administratorkonto til Microsoft Entra ID (kontoen skal have en gyldig licens til Dataverse og være administrator i dit Dataverse-miljø). Når du er logget på, bliver du bedt om at tillade, at dit registrerede program logger på Dataverse på vegne af organisationen. Du skal give samtykke for at fuldføre installationen.

    Bemærk

    Hvis du ikke bliver bedt om at logge på med din administratorkonto, skyldes det sandsynligvis, at pop op-vinduer er blokeret. Du kan logge på ved at tillade pop op-vinduer fra https://login.microsoftonline.com.

Sådan afbrydes forbindelsen fra Dataverse

  1. Vælg Lightbulb, der åbner funktionen Fortæl mig. ikon, skriv Dataverse-forbindelseskonfiguration, og vælg derefter det relaterede link.
  2. På siden Dataverse-forbindelsesopsætning skal du slå Aktiveret fra.

Se også

Se status på en synkronisering

Find gratis e-learning-moduler til Business Central her