Koble deg til Microsoft Dataverse

Denne artikkelen beskriver hvordan du konfigurerer en tilkobling mellom Business Central og Dataverse. Vanligvis oppretter selskaper tilkoblingen for å integrere og synkronisere data med en annen Dynamics 365-app, for eksempel Dynamics 365 Sales.

Før du begynner

Før du oppretter tilkoblingen, er det noen få opplysninger du må ha klar:

  • URL-adressen til Dataverse-miljøet du vil koble til. Hvis du bruker veiledningen for assistert oppsett Tilkoblingsoppsett for Dataverse til å opprette tilkoblingen, finner vi miljøene for deg. Du kan også skrive inn nettadressen til et annet miljø i leietakeren din.
  • Brukernavnet og passordet for en konto som har administratorrettigheter i Business Central og Dataverse.
  • Hvis du har en lokal Business Central 2020-utgivelsesbølge 1, versjon 16.5, kan du lese artikkelen Noen kjente problemer. Fullfør den beskrevne løsningen før du kan opprette tilkoblingen til Dataverse.
  • De lokale valutaene som hvert selskap bruker. Business Central-selskaper kan koble til et Dataverse-miljø som har en standardvaluta som skiller seg fra den lokale valutaen. Hvis du vil vite mer om hvordan du håndterer oppsett med flere valutaer, kan du gå til Tillat for ulike valutaer.

Viktig!

Dataverse-miljøet ditt må ikke være i administrasjonsmodus. Administrasjonsmodus fører til at tilkoblingen mislykkes fordi integreringsbrukerkontoen for tilkoblingen ikke har administratortilgang. Finn ut mer under Administrasjonsmodus.

Note

Disse trinnene beskriver fremgangsmåten for Business Central på nettet. Hvis du bruker Business Central lokalt og ikke bruker en Microsoft Entra-konto til å koble til Dataverse, må du også angi brukernavn og passord for en brukerkonto for integrasjonen. Denne kontoen kalles kontoen for "integrasjonsbruker". Hvis du bruker en Microsoft Entra-konto, er ikke integreringsbrukerkontoen nødvendig eller vist. Integreringsbrukeren konfigureres automatisk og krever ikke en lisens.

Virksomheter ønsker å holde dataene trygge innenfor personverngrensen, og spesielt når forretningsadministrasjonsprogrammet integreres med andre apper. Koblingen mellom Business Central og Dataverse-miljøer bidrar til å nå disse målene. I tillegg gir du administratorene dine en enklere måte å opprette og vedlikeholde integrasjonene dine med andre Dynamics 365-apper.

I administrasjonssenteret for Business Central kan du koble Business Central-miljøet til Dataverse-miljøet. Business Central kan bruke informasjonen fra koblingen for å gjøre det enklere og sikrere å integrere med andre Dynamics 365-apper, for eksempel Sales og Field Service. Nettadressen for det koblede Dataverse-miljøet er for eksempel tilgjengelig som standard på siden Dataverse-tilkoblingsoppsett og når du kjører den assisterte oppsettsveiledningen Dataverse-tilkoblingsoppsett.

Tillate ulike valutaer

Business Central-selskaper kan koble til et Dataverse-miljø som har en standardvaluta som skiller seg fra den lokale valutaen.

Note

Synkronisering av flere valutaer krever at du bruker en enveis synkronisering, fra Business Central til Dataverse.

Hvis du vil ha mer informasjon om standardvalutaen Dataverse, kan du gå til Transaksjonsvaluta-enhet.

Hvis du vil finne ut mer om valutaer i Business Central, kan du gå til Valutaer i Business Central.

Hvis du vil tillate forskjellige valutaer, må du kontrollere at du har angitt følgende innstillinger før du kobler til:

  • Innstillingen for basistransaksjonsvaluta i Dataverse har valutakoden som er angitt på siden Valutaer i Business Central.
  • Det er minst én valutakurs angitt for valutaen i Business Central på siden Valutakurser.

Når du aktiverer tilkoblingen til Dataverse, legger Business Central til den lokale valutaen i Currency-enheten i Dataverse. Den lokale valutaen bruker valutakursen fra feltet Valutafaktor på siden Valutakurser.

Siden valutasynkronisering er enveis, fra Business Central til Dataverse, konverteres og synkroniseres pengebeløp på følgende måte:

  • Hvis det er i den dataverse basisvalutaen, konverteres beløpene til den Business Central lokale valutaen basert på den nyeste valutakursen som er synkronisert fra Business Central.
  • Hvis i den Business Central lokale valutaen, synkroniseres beløpene med den Business Central lokale valutaen i én av de ekstra, ikke-baserte valutaene i Dataverse.

Konfigurer en tilkobling til Dataverse

For alle andre godkjenningstyper enn Microsoft 365 godkjenning konfigurerer du tilkoblingen til Dataverse på siden Dataverse Connection Setup. For Microsoft 365-godkjenning anbefales det å bruke den assisterte oppsettsveiledningen for Konfigurasjon for Dataverse-tilkobling. Veiledningen gjør det enklere å opprette tilkoblingen og angi avanserte funksjoner, for eksempel eierskapsmodell og første synkronisering.

Viktig!

Under konfigurasjonen av tilkoblingen til Datavers blir administratorer bedt om å gi følgende tillatelser til et registrert Azure program kalt Business Central Integration to Dataverse:

  • Tillatelsen Få tilgang til Dataverse som deg kreves slik at Business Central kan, på vegne av administratoren, automatisk opprette en ikke-lisensiert, ikke-interaktiv Business Central Integration-appbruker, tildele sikkerhetsroller til denne brukeren og rulle ut Business Central Integration-løsningen til Dataverse. Denne tillatelsen brukes bare én gang til å konfigurere tilkoblingen til Dataverse.
  • Tillatelse for å ha full tilgang til Dynamics 365 Business Central kreves, slik at den automatisk opprettede programbrukeren for Business Central-integrering har tilgang til Business Central-data som synkroniseres.
  • Tillatelse for å logge på og lese profilen din kreves for å bekrefte at brukeren som logger på, faktisk har sikkerhetsrollen for systemansvarlig tilordnet i Dataverse.

Ved å gi samtykke på vegne av organisasjonen, gir administrator det registrerte Azure-programmet som kalles Business Central-integrering med Dataverse, rett til å synkronisere data ved hjelp av automatisk opprettet legitimasjon for programbruker for Business Central-integrering.

Slik bruker du den assisterte oppsettsveiledningen for Konfigurasjon for Dataverse-tilkobling

Oppsettveiviseren for konfigurasjon av Dataverse-tilkobling kan gjøre det enklere å koble til programmene, og kan til og med hjelpe deg med å kjøre en innledende synkronisering. Hvis du velger å kjøre første synkronisering, går Business Central gjennom dataene i begge programmene og gir anbefalinger for hvordan du nærmer deg første synkronisering. Tabellen nedenfor beskriver anbefalingene.

Anbefaling Beskrivelse
Full synkronisering Data eksisterer bare i Business Central eller bare i Dataverse. Anbefalingen er å synkronisere alle data fra tjenesten som har de, til den andre tjenesten.
Ingen synkronisering Dataene finnes i begge programmene, og det vil duplisere dataene ved å kjøre full synkronisering. Anbefalingen er å koble registre.
Avhengighet ikke tilfredsstilt Dataene finnes i begge programmene, men raden eller tabellen synkroniseres ikke fordi den avhenger av en rad eller tabell som har anbefaling om ingen synkronisering. Hvis for eksempel kundene ikke kan synkronisere, kan heller ikke data for kontakter som er avhengige av kundedata, synkroniseres.

Viktig!

Vanligvis bruker du bare full synkronisering når du integrerer programmene for første gang, og bare ett program inneholder data. Full synkronisering kan være nyttig i et demonstrasjonsmiljø fordi det automatisk oppretter og kobler poster i hvert program, noe som gjør det raskere å begynne å arbeide med synkroniserte data. Du bør imidlertid bare kjøre full synkronisering hvis du vil ha én rad i Business Central for hver rad i Dataverse for tabelltilordningene. Hvis ikke kan resultatet være dupliserte poster.

  1. Velg Søk (Alt+Q) øverst til høyre, skriv inn Assistert oppsett, og velg deretter den relaterte koblingen.
  2. Velg Sett opp en tilkobling til Microsoft Dataverse for å starte den assisterte konfigurasjonsveiledningen.
  3. Fyll ut feltene etter behov.

Note

Hvis du ikke blir bedt om å logge på med administratorkontoen, skyldes det trolig at popup-vinduer er blokkert. Hvis du vil logge deg på, må du tillate popup-vinduer fra https://login.microsoftonline.com.

Opprette eller vedlikeholde tilkoblingen manuelt

Følgende fremgangsmåte beskriver hvordan du konfigurerer tilkoblingen manuelt på siden Konfigurasjon for Dataverse-tilkobling. Du håndterer integrasjonsinnstillinger på siden Tilkoblingsoppsett for Dataverse.

  1. Velg Søk (Alt+Q) øverst til høyre, skriv inn Konfigurasjon av datavers tilkobling, og velg deretter den relaterte koblingen.

  2. Skriv inn følgende informasjon for tilkoblingen fra Business Central til Dataverse.

    Felt Beskrivelse
    URL-adresse for miljø Hvis du eier miljøer i Dataverse, finner vi dem for deg når du kjører installasjonsveiledningen. Hvis du vil koble til et annet miljø i en annen leier, kan du angi administratorlegitimasjon for miljøet slik at vi finner det også.
    Aktivert Begynn å bruke integrasjonen. Hvis du ikke aktiverer tilkoblingen nå, lagres tilkoblingsinnstillingene, men brukerne har ikke tilgang til Dataverse-data fra Business Central. Du kan gå tilbake til denne siden og aktivere tilkoblingen senere.

  3. I feltet Eierskapsmodell velger du om du vil ha en teamtabell i Dataverse til egne nye poster, eller én eller flere bestemte brukere. Hvis du velger Person, må du angi hver bruker. Hvis du velger Team, vises standard forretningsenhet i feltet Koblet konsern.

  4. Hvis du vil teste tilkoblingsinnstillingene, velger du Tilkobling og deretter Test tilkobling.

    Note

    Hvis datakryptering ikke er aktivert i Business Central, blir du spurt om du vil aktivere det. Hvis du vil aktivere datakryptering, velger du Ja og angir nødvendig informasjon. Ellers velger du Nei. Du kan aktivere datakryptering senere. Hvis du vil ha mer informasjon, kan du se Kryptere data i Dynamics 365 Business Central i hjelpen for utviklere og administrasjon.

  5. Hvis Dataverse-synkronisering ikke allerede er satt opp, blir du spurt om du vil bruke standard synkroniseringsoppsett. Avhengig av om du vil ha postene synkroniserte i Dataverse og Business Central, velger du Ja eller Nei.

Tilpass samsvarsbasert kobling

Administratorer kan angi vilkår for å koble poster basert på samsvar. Du kan starte algoritmen for samsvarende poster fra følgende steder i Business Central:

  • Vis sider som viser poster som er synkronisert med Dataverse, for eksempel sidene Kunder og Varer.

    Velg flere poster, og velg deretter Relatert-handling, velg Dataverse, velg Kobling, og velg deretter Samsvarbasert kobling.

    Når du starter den samsvarsbaserte koblingsprosessen fra en hoveddatakilde, blir en koblingsjobb planlagt etter at du har angitt koblingskriteriene.

  • Siden Gjennomgang av full synkronisering for Dataverse.

    Når den fullstendige synkroniseringsprosessen oppdager poster som ikke er koblet sammen i Business Central og Dataverse, vises koblingen Velg koblingskriterier for integreringstabellen.

    Du kan starte prosessen Kjør full synkronisering fra sidene Tilkoblingsoppsett for Dataverse og Tilkoblingsoppsett for Dynamics 365. Du kan også starte veiledningen for assistert oppsett Konfigurer en tilkobling til Dataverse når du full fører installasjonen.

    Når du starter den samsvarsbaserte koblingsprosessen fra siden Gjennomgang av full synkronisering for Dataverse, blir en koblingsjobb planlagt etter at du har fullført oppsettet.

  • Listen Integreringstabelltilknytninger.

    Velg en tilordning, velg Kobling-handlingen, og velg deretter Samsvarsbasert kobling.

    Når du starter prosessen for samsvarbasert kobling fra en integrasjonstabelltilordning, kjøres en koblingsjobb for alle ukoblede oppføringer i tilordningen. Du kan også velge ubundne poster i listen for å kjøre jobben bare for disse postene.

I alle tre tilfeller åpnes siden Velg koblingskriterier, slik at du kan definere relevante koblingskriterier. På denne siden tilpasser du koblingen med følgende oppgaver:

  • Velg feltene som skal brukes til å samsvare Business Central-poster med Dataverse-enheter. Du kan angi om samsvaret skiller mellom store og små bokstaver.

  • Angi om du vil synkronisere etter at du har koblet poster. Hvis poster bruker toveis kartlegging, kan du også angi hva som skjer hvis konflikter er oppført på siden Løs oppdateringskonflikter.

  • Prioriter rekkefølgen du søker etter poster i, ved å angi en samsvarsprioritet for de relevante tilordningsfeltene. Business Central søker etter samsvar i stigende rekkefølge basert på verdien i feltet Samsvarsprioritet. En tom verdi i feltet Samsvarsprioritet er lik prioritet 0, som er den høyeste prioriteten. Felter som har prioriteten 0, vurderes først.

  • Angi om det skal opprettes en ny enhetsforekomst i Dataverse i tilfelle det ikke finnes unikt, ikke-koblet samsvar ved å bruke samsvarskriteriene. Hvis du vil aktivere denne funksjonen, velger du Opprett ny hvis det ikke finnes et samsvar-handling.

Vis resultatene av koblingsjobben

Hvis du vil vise resultatene av koblingsjobben, åpner du siden Tilordninger for integreringstabell, velger den relevante tilordningen, velger handlingen Kobling og velger handlingen Logg for koblingsjobb for integrering.

Hvis poster ikke ble koblet, kan du velge verdien i kolonnen Mislyktes for å åpne en liste over feil som beskriver hvorfor.

Hvis kobling mislykkes, er det vanligvis på grunn av en av følgende årsaker:

  • Ingen samsvarende kriterier ble definert

    Kjør den samsvarsbaserte koblingen på nytt, men husk å definere koblingskriterier.

  • Fant ingen treff for feltene som er angitt i samsvarskriteriene

    Gjenta koblingen ved å bruke andre felter.

  • Fant flere treff for flere poster, basert på feltene angitt i samsvarkriteriene

    Gjenta koblingen ved å bruke andre felter.

  • Fant et treff, men den samsvarende posten er allerede koblet med en post i Business Central

    Gjenta koblingen ved hjelp av ulike felt, eller undersøk hvorfor dataversenheten er koblet til posten i Business Central.

Tips

Hvis du vil ha hjelp til å få en oversikt over fremdriften til koblingen, viser feltet Koblet til Dataverseom en post er koblet til en Dataverse-enhet. Du kan bruke feltet Koblet til Dataverse til å filtrere listen over poster du synkroniserer.

Oppgrader tilkoblinger fra Business Central Online for å bruke sertifikatbasert godkjenning

Note

Denne delen er bare relevant for Business Central nettbaserte leiere som Microsoft er vert for. Online-leietakere som kjøres av uavhengige programvareleverandører, og lokale installasjoner, påvirkes ikke.

I april 2022 avskrev Dataverse Office365-godkjenningstypen (brukernavn/passord). Finn ut mer på Avskriving av Office365-godkjenningstypen. I mars 2022 avskrev Business Central i tillegg bruken av klienthemmelighetsbasert tjeneste-til-tjeneste-godkjenning for nettbaserte leiere. Du må bruke sertifikatbasert tjeneste-til-tjeneste-godkjenning for tilkoblinger til Dataverse. Business Central-nettleietakere som driftes av uavhengige programvareleverandører og lokale installasjoner, kan fortsette å bruke klienthemmeligheter for godkjenning.

For å unngå å forstyrrende integreringer må du oppgradere tilkoblingen for å kunne bruke sertifikatbasert godkjenning. Følgende trinn beskriver hvordan du oppgraderer til sertifikatbasert godkjenning.

Slik oppgraderer du tilkoblinger for Business Central online til å bruke sertifikatbasert godkjenning

  1. Avhengig av om du integrerer med Dynamics 365 Sales, gjør du et av følgende:
    • Hvis du gjør det, åpner du siden Tilkoblingsoppsett for Microsoft Dynamics 365.
    • Hvis du ikke gjør det, åpner du siden Tilkoblingsoppsett for Dataverse.
  2. Velg Tilkobling og deretter Bruk sertifikatgodkjenning for å oppgradere tilkoblingen til å bruke sertifikatbasert godkjenning.
  3. Logg på med administratorlegitimasjon for Dataverse. Det skal ta under ett minutt å logge seg på.

Note

Du må gjenta disse trinnene i hvert Business Central miljø, inkludert både produksjons- og sandkassemiljøer, og i hvert selskap der du har en tilkobling til Dataverse.

Koble til lokale versjoner

Hvis du vil koble Business Central lokalt til Dataverse, må du angi noe informasjon på siden Dataverse Connection Setup.

Hvis du vil koble til ved hjelp av en Microsoft Entra-konto, må du registrere et program i Microsoft Entra ID. Du må oppgi program-ID-en, hemmeligheten for nøkkelhvelv og nettadressen som skal brukes. Nettadressen for omdirigering er forhåndsutfylt og skal fungere for de fleste installasjoner. Du må konfigurere installasjonen til å bruke HTTPS. Finn ut mer på Konfigurer SSL for å sikre nettklienttilkoblingen for Business Central. Hvis du konfigurerer serveren slik at den har en annen hjemmeside, kan du endre nettadressen. Klienthemmeligheten lagres som en kryptert streng i databasen.

Slik registrerer du et program i Microsoft Entra ID for å koble fra Business Central til Dataverse

Fremgangsmåten nedenfor forutsetter at du bruker Microsoft Entra ID til å administrere identiteter og tilgang. Hvis du vil vite mer om hvordan du registrerer et program i Microsoft Entra ID, kan du gå til Quickstart: Registrer et program med Microsofts identitetsplattform.

  1. I Azure-portalen, under Administrering på navigasjonspanelet, velg Autentisering.

  2. Under nettadresser for omdirigering legger du til nettadressen for omdirigering som foreslås på siden Tilkoblingsoppsett for Dataverse i Business Central.

  3. Velg API-tillatelser under Behandle.

  4. Under Konfigurerte tillatelser velger du Legg til tillatelse, og deretter legger du til delegerte tillatelser i kategorien Microsoft API-er på følgende måte:

    • For Business Central legger du til tillatelsene Financials.ReadWrite.All.
    • For Dataverse legger du til tillatelsene user_impersonation.

    Note

    Navnet på Dynamics CRM-API-en kan endres.

  5. Under Behandle velger du Sertifikater og hemmeligheter, og deretter oppretter du en ny hemmelighet for appen. Du bruker hemmeligheten enten i Business Central, i Client Secret-feltet på Dataverse Connection Setup-siden, eller lagre i en sikker lagringsplass og levere den i en hendelsesabonnent som beskrevet tidligere i denne artikkelen.

  6. Velg Oversikt, og finn deretter verdien ID (klient) for programmet. Denne ID-en er klient-ID-en for programmet. Du må angi den på siden Tilkoblingsoppsett for Dataverse i feltet Klient-ID, eller lagre den på en sikker lagringsplass og angi den i et hendelsesabonnent.

  7. I Business Central, på siden Tilkoblingsoppsett for Dataverse i feltet Nettadresse for miljø, angir du nettadressen for Dataverse-miljøet.

  8. Hvis du vil aktivere tilkoblingen til Dataverse, aktiverer du alternativet Aktivert.

  9. Logg på med administratorkontoen din for Microsoft Entra ID (denne kontoen må ha en gyldig lisens for Dataverse og være administrator i ditt Dataverse-miljø). Når du har logget deg på, blir du bedt om å tillate at det registrerte programmet kan logge seg på Dataverse på vegne av organisasjonen. Du må gi samtykke for å fullføre oppsettet.

    Note

    Hvis du ikke blir bedt om å logge deg på med administratorkontoen, skyldes det trolig at popup-vinduer er blokkert. Hvis du vil logge deg på, må du tillate popup-vinduer fra https://login.microsoftonline.com.

For å koble fra Dataverse

  1. Velg Søk (Alt+Q) øverst til høyre, skriv inn Konfigurasjon av datavers tilkobling, og velg deretter den relaterte koblingen.
  2. På siden Konfigurasjon for Dataverse-tilkobling deaktiverer du alternativet Aktivert.

Vis statusen for en synkronisering

Finn gratis e-læringsmoduler for Business Central her

  • Last updated on