Koble til Microsoft Dataverse

Obs!

Azure Active Directory er nå Microsoft Entra ID. Finn ut mer

Denne artikkelen beskriver hvordan du setter opp en tilkobling mellom Business Central og Dataverse. Vanligvis oppretter selskaper tilkoblingen for å integrere og synkronisere data med en annen Dynamics 365-forretningsapp, 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 dine. 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 lanseringsbølge 1, versjon 16.5, kan du lese artikkelen Noen kjente problemer. Du må fullføre 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 vil føre til at tilkoblingen mislykkes fordi integrasjonsbrukerkontoen for tilkoblingen ikke har administratortilgang. Se også Administrasjonsmodus for mer informasjon.

Obs!

Følgende trinn beskriver fremgangsmåten for Business Central på nett. Hvis du bruker Business Central lokalt og ikke bruker Microsoft Entra-kontoen 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 brukerkontoen for integrasjon nødvendig eller vist. Brukeren for integrasjon konfigureres automatisk og krever ikke en lisens.

Koble sammen Business Central- og Dataverse-miljøene

Virksomheter ønsker å holde dataene sine trygge og sikre innenfor personverngrensen, og spesielt når forretningsstyringsprogrammet integreres med andre apper. Ved å koble sammen Business Central- og Dataverse-miljøer vil du ikke bare oppnå disse hensynene, men også gi administratorene en enklere måte å opprette og vedlikeholde integreringene med andre Dynamics 365-apper på.

I administrasjonssenteret for Business Central kan du koble Business Central-miljøet til Dataverse-miljøet. Business Central kan bruke informasjonen fra koblingen til å 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.

Obs!

Synkronisering av flere valutaer krever at du bruker en ensrettet 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å Valutaer-siden 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 den lokale valutaen til Business Central, legger det til lokal valuta i enheten Valuta i Dataverse. Den lokale valutaen bruker valutakursen fra feltet Valutafaktor på siden Valutakurser.

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

• I Dataverse standardvalutaen konverteres beløp til Business Central lokal valuta basert på den siste valutakursen som er synkronisert fra Business Central.
• I Business Central lokal valuta synkroniseres beløpene med Business Central lokal valuta i en av de andre ikke-standardvalutaene i Dataverse.

Konfigurer en tilkobling til Dataverse

For andre godkjenningstyper enn Microsoft 365-godkjenning definerer du en tilkobling til Dataverse på siden Tilkoblingsoppsett for Dataverse. 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 oppsettet av tilkoblingen til Dataverse blir administrator bedt om å gi følgende tillatelse til å registrere et Azure-program kalt Business Central-integrering til Dataverse:

• Tillatelsen Gå 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, tilordne sikkerhetsroller til denne brukeren og distribuere Business Central Integration-løsningen til Dataverse. Denne tillatelsen brukes bare én gang under oppsett av kobling 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 skal 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 innledende synkronisering, vil Business Central se gjennom dataene i begge programmene og gi anbefalinger for hvordan innledende synkronisering skal utføres. Tabellen nedenfor beskriver anbefalingene.

Anbefaling	Beskrivelse
Full synkronisering	Dataene finnes 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 poster.
Avhengighet ikke tilfredsstilt	Dataene finnes i begge programmene, men raden eller tabellen kan ikke synkroniseres, fordi den avhenger av en rad eller tabell som har anbefaling om ingen synkronisering. Hvis for eksempel kundene ikke kan synkroniseres, 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 må derimot bare utføre en full synkronisering hvis du vil ha én rad i Business Central for hver rad i Dataverse for de gitte tabelltilordningene. Hvis ikke kan resultatet være dupliserte poster.

1. Velg ikonet og angir Assistert oppsett og velger den relaterte koblingen.
2. Velg Konfigurer en tilkobling til Microsoft Dataverse for å starte assistert oppsettsveiledning.
3. Fyll ut feltene etter behov.

Obs!

Hvis du ikke blir bedt om å logge på med administratorkontoen, skyldes det trolig at popup-vinduer er blokkert. Hvis du vil logge 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 ikonet og angir Dataverse-tilkoblingsoppsett og velger 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 kan finne det.
   Aktivert	Begynn å bruke integrasjonen. Hvis du ikke aktiverer tilkoblingen nå, lagres tilkoblingsinnstillingene, men brukerne vil ikke ha 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, vil standard forretningsenhet vises i feltet Koblet konsern.

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

   Obs!

   Hvis datakryptering ikke er aktivert i Business Central, får du bli spurt om du vil aktivere den. 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, vil du bli spurt om du vil bruke standard synkroniseringsoppsett. Avhengig av om du vil beholde postene som er justert i Dataverse og Business Central, velger du Ja eller Nei.

Tilpass samsvarsbasert kobling

Fra og med lanseringsbølge 2 for 2021 kan en administrator 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 lik Samsvartbasert 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 at du har poster som ikke er koblet, i Business Central og Dataverse, vises en Velg koblingskriterier-kobling 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 Tilordninger for integreringstabell.

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

  Når du starter den samsvarende koblingsprosessen fra en tilordning for integreringstabell, kjøres en koblingsjobb for alle ikke-koblede poster i tildelingen. Du kan også merke av for frakoblede 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 toveistildeling, kan du også angi hva som skal skje hvis det er konflikter på listen, på siden Løs oppdateringskonflikter.

• Prioriter rekkefølgen du søker etter poster i, ved å angi en samsvarsprioritet for de relevante tilordningsfeltene. Business Central vil søke 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 det skjedde.

Kobling kan vanligvis mislykkes 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 å bruke andre felter, eller undersøker hvorfor Dataverse-enheten er koblet med 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

Obs!

Denne delen er bare relevant for Business Central online-leiere som kjører på Microsoft. Online-leietakere som kjører på ISV-er, og lokale installasjoner, påvirkes ikke.

I april 2022 avskriver Dataverse Office365-godkjenningstypen (brukernavn/passord). Hvis du vil ha mer informasjon, kan du se Avskriving av Office365-godkjenningstypen. I mars 2022 avskriver Business Central bruken av klienthemmelighetsbasert tjeneste-til-tjeneste-godkjenning for nettbaserte leietakere. Du må bruke sertifikatbasert tjeneste-til-tjeneste-godkjenning for tilkoblinger til Dataverse. Business Central-nettleietakere som driftes av ISV-er og lokale installasjoner, kan fortsette å bruke klienthemmeligheter for godkjenning.

For å unngå å forstyrrende integreringer må du oppgradere tilkoblingen for å kunne bruke sertifikatbasert godkjenning. Selv om endringen er planlagt i mars 2022, anbefaler vi på det sterkeste at du oppgraderer så snart som mulig. 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å.

Obs!

Du må gjenta disse trinnene i hvert Business Central-miljø, for eksempel både produksjons- og sandkassemiljøer, og i hvert selskap der du er koblet til i Dataverse.

Koble til lokale versjoner

Hvis du vil koble Business Central lokalt til Dataverse, må du angi informasjon på siden Tilkoblingsoppsett for Dataverse.

Du må registrere et program i Microsoft Entra-ID for å koble til med en Microsoft Entra-konto. 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. Hvis du vil ha mer informasjon, kan du se Konfigurere SSL for å sikre nettklienttilkoblingen for Business Central. Hvis du konfigurerer serveren slik at den har en annen hjemmeside, kan du endre nettadressen. Klienthemmeligheten vil bli lagret som en kryptert streng i databasen.

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

Fremgangsmåten nedenfor forutsetter at du bruker Microsoft Entra ID til å administrere identiteter og tilgang. Hvis du vil ha mer informasjon om hvordan du registrerer et program i Microsoft Entra ID, kan du se Hurtigstart: Registrere et program i Microsoft Identity Platform.

1. Velg Godkjenning i Azure-portalen under Behandle i navigasjonsruten.

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 Dynamics CRM legger du til tillatelsene user_impersonation.

   Obs!

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

5. Under Behandle velger du Sertifikater og hemmeligheter, og deretter oppretter du en ny hemmelighet for appen. Du bruker hemmeligheten i Business Central, i feltet Klienthemmelighet på siden Tilkoblingsoppsett for Dataverse, eller du lagrer på en sikker lagringsplass og angir det i et hendelsesabonnent, som beskrevet tidligere i dette emnet.

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 på, blir du bedt om å tillate at det registrerte programmet kan logge på Dataverse på vegne av organisasjonen. Du må gi samtykke for å fullføre oppsettet.

   Obs!

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

For å koble fra Dataverse

1. Velg ikonet og angir Dataverse-tilkoblingsoppsett og velger den relaterte koblingen.
2. På siden Konfigurasjon for Dataverse-tilkobling deaktiverer du alternativet Aktivert.

Se også

Vise statusen for en synkronisering

Finn nettlæringsmoduler for Business Central her