Business Central-tillegg for RapidStart CRM-oppsett

Høynivåtrinn

1. Opprett eller bruk et eksisterende Dataverse-aktivert miljø.
2. Installer RapidStart CRM fra AppSource på det Dataverse-aktiverte miljøet.
3. Skaff Business Central Company System ID.
4. Konfigurer integrasjonen fra Business Central.
5. Bekreft Business Central-integrasjonsapplikasjonsbrukerrollen
6. Sett opp postmapping
7. Koble miljøer (valgfritt)
8. Installer Business Central-tillegget for RapidStart CRM fra AppSource på det Dataverse-aktiverte miljøet.
9. Fullfør i RapidStart Settings-appen

Før du begynner

Bekreft disse kravene før du starter oppsettet av Business Central-tillegget:

• Business Central og Dataverse må være i samme Microsoft Entra-leietaker for Business Central virtuelle tabeller.
• Bruk en menneskelig oppsettadministrator med de nødvendige Business Central-tillatelsene og Dataverse System Administrator-tilgang under oppsettet.
• Bekreft at RapidStart CRM er installert i Dataverse-miljøet du planlegger å koble til.

Trinn 3: Skaff selskaps-ID

For å skaffe din selskaps-ID, søk etter Selskaper i Business Central. Velg målselskapet og trykk Ctrl+Alt+F1 for å åpne Sideinspeksjon. Kopier ID som vises og lagre den for senere.

Trinn 4: Konfigurer integrasjonen fra Business Central

Logg inn på Business Central-miljøet du vil koble til.

Merk deg Business Central-miljønavnet i adressefeltet. URL-en kan også vise selskapsvisningsnavnet, men du har allerede fanget Company System ID GUID i forrige trinn.

Kopier Business Central-miljønavnet til de samme notatene der du lagret Company System ID GUID.

1. Klikk på tannhjulet
2. Velg “Assistert oppsett”

Rull ned til “Koble til andre systemer”-seksjonen og klikk på “Sett opp en tilkobling til Dataverse”.

1. Velg å aktivere datasynkronisering
2. Velg å aktivere virtuelle tabeller og hendelser
3. Klikk “Neste”

Godta vilkårene og klikk “Neste”

Godta tilkoblingen til Dataverse “Tillat alltid”, og klikk OK

Velg mål Dataverse-aktivert miljø, og klikk “Ok”

Bekreft at miljøet er korrekt, klikk deretter på lenken for å logge inn på Dataverse-miljøet. Etter innlogging klikker du “Neste”

Velg det anbefalte Team-eierskapet, veksle til Fullfør uten synkronisering (vi gjør dette senere) og klikk “Neste”

1. Klikk lenke for å installere Business Central Virtual Table app
2. Klikk “Neste” (En ny fane vil åpne seg til AppSource)

Klikk på “Få det nå”-knappen (Dette tillegget er gratis), og følgende side vil åpne seg:

1. Velg målmijøet (der du har installert RapidStart CRM).
2. Godta vilkårene.
3. Klikk “Installer”.

Du vil se at løsningen er “Installerer”. Dette kan ta flere minutter å fullføre. Klikk av og til “oppdater” til du ser at den er “Installert”, gå deretter tilbake til Business Central-nettleserfanen for å fortsette.

Klikk “Oppdater”

Du vil se at Virtuelle Tabeller-appen er installert. Klikk “Fullfør”

Etter noen minutter vil denne siden vises. Velg Virtuelle Tabeller-fanen og deretter “Tilgjengelige Virtuelle Tabeller”

1. Start med å velge “vare”-linjen
2. Klikk “Aktiver” (Dette vil opprette den virtuelle tabellen i Dataverse for varer)
3. Vent til du ser “Synlig”-boksen er avkrysset. Du kan trenge å oppdatere noen ganger.

Gjenta disse trinnene for: salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment, og salesShipmentLine. Dette vil ta flere minutter for hver å aktivere.

Endre til sortering etter Synlig/synkende, og bekreft at du ser alle disse tabellene. Ikke legg til flere Virtuelle Tabeller på dette tidspunktet. Du kan la skjermen stå som den er (vi kommer tilbake til den) og åpne en ny fane.

Trinn 5: Bekreft Business Central Integrasjonsapplikasjonsbruker

Hvis Business Central-Dataverse-synkroniseringstillatelser virker skadet, åpne Dataverse Connection Setup i Business Central og bruk Redeploy Integration Solution. Dette gjenoppretter Microsofts integrasjonsløsning og distribuerer Business Central-integrasjonssikkerhetsrollen.

Fortsett kun etter at tilkoblingstesten lykkes og Business Central-integrasjonsapplikasjonsbrukeren har Microsofts Business Central Dataverse Integration-rolle.

Trinn 6: Sett opp postmapping og kobling

Referansemappinger å konfigurere før KUNDE

• VALUTA: Business Central Valuta → Dataverse Transaksjonsvaluta. Retningen må være Business Central til Dataverse. Bekreft disse aktiverte feltmappingene: Kode → Valutakode, Symbol → Valutasymbol, og Beskrivelse → Valutanavn.
• Bekreft at KUNDE-mappingen inneholder Valutakode → Valuta. Synkroniser valutaer før kunder. Dataverse basisvaluta og Business Central lokal valuta må være enige, og nødvendige valutakurser må eksistere.
• Betalingsbetingelser: synkroniser til Konto Betalingsbetingelser før kundetesting.
• Fraktmetode: synkroniser til Konto Fraktbetingelser før kundetesting.
• Fraktagent: synkroniser til Konto Fraktmetode før kundetesting.

Kundeskaperpolitikk

Sett KUNDE til Toveis hvis kontoer/selskaper kan opprettes på begge sider. Velg deretter Synk. Kun koblede poster-politikken som en kundedistribusjonsbeslutning:

Automatisk oppretting og kobling av kunder

1. Hvis kunden velger native automatisk opprettelse, sett CUSTOMER til Bidirectional og Sync. Only Coupled Records til Av. Hold Sync New Account to BC av.
2. La Disable Event-driven Synch. Job Rescheduling være uavkrysset.
3. Bekreft at CUSTOMER integrasjonstabellfilteret inneholder den valgte Company System ID. Inkluder 00000000-0000-0000-0000-000000000000 kun når eldre eller ikke-tilordnede Dataverse rader med hensikt støttes.
4. Bekreft at CUSTOMER integrasjonssynkroniseringsjobben eksisterer og at intervallet dekker kundens behov. On Hold with Inactivity Timeout er en forventet status mellom kjøringer; et 30-minutters intervall er ikke sanntid.
5. Før bred synkronisering, manuelt koble sammen poster som allerede finnes på begge sider, eller vurder match-basert koblingskriterier og resultater nøye. Automatisk opprettelse identifiserer ikke sikkert hvert eksisterende par.

Kobling bruker integrasjonen GUID, ikke Business Central kundenummer. Nummeret er nyttig for visning og søk; for å vise det i Dataverse, verifiser CUSTOMER-feltkartleggingen fra Business Central Nei. til Dataverse Konto Nei..

Validering av alternativverdi

Business Central enum-verdi-IDer brukt for Betalingsbetingelser, Fraktmetode og Fraktagent må samsvare med de tilsvarende Dataverse-alternativ-IDene. Visningsteksten eller kodelabelen alene er ikke nok. En full synkronisering reparerer ikke en ID-mismatch når Business Central inneholder tilpassede enum-verdier som ikke eksisterer i Dataverse.

1. Kjør Synkroniser endrede poster for BETALINGSBETINGELSER, FRAKT METODE, og FRAKT AGENT.
2. Inspiser Dataverse Alternativ Mapping og synkroniseringsfeilloggen før testing av KUNDE.
3. Hvis IDer ikke er justert, bruk den sikre standarden på KUNDE-feltmappingene: Betalingsbetingelseskode → Betalingsbetingelser = FromIntegrationTable; Fraktmetodekode → Adresse 1: Fraktbetingelser = FromIntegrationTable; Fraktagentkode → Adresse 1: Fraktmetode = FromIntegrationTable.
4. Endre de tre feltene til Toveis først etter at en utvikler har lagt til samsvarende alternativ-IDer på begge sider.
5. Ikke oppfinn eller omnummerer alternativ-IDer under oppsett. Tilpassede Dataverse-verdier og Business Central enum-utvidelser må bruke nøyaktig de samme IDene.

For disse CUSTOMER feltkartleggingene, FromIntegrationTable betyr Dataverse → Business Central kun. Dette holder konto/kunde-oppdatering toveis samtidig som det forhindrer umatchede Business Central opsjons-IDer fra å blokkere Business Central → Dataverse opprettelse.

Gå tilbake til Business Central-fanen i nettleseren din som vi lot stå åpen.

1. Klikk på “Integrasjon”-fanen
2. deretter “Integrasjonstabellmappinger”

Kundebeslutning: behold SELGER hvis kunden ønsker Microsofts standard Dataverse-bruker-til-Business-Central-selger-synkronisering. Slett eller deaktiver denne mappingen kun når den standard synkroniseringen bevisst ikke brukes.

1. Velg KONTAKT
2. Velg Kobling
3. Klikk deretter “Match-basert kobling”.
4. Match det ovennevnte og klikk OK

1. Velg VALUTA
2. Velg Kobling
3. Klikk deretter “Match-basert kobling”.
4. Match det ovennevnte og klikk OK

For CUSTOMER, velg Kartlegging/Felter, deretter Rediger Liste. Aktiver kartleggingen fra Business Central Nei. til Dataverse Konto Nei. hvis kundenummeret skal vises på Dataverse kontoen. Dette erstatter ikke integrasjon-GUID kobling.

Fortsatt for KUNDE, velg Kobling/Match-basert kobling. Match ved å bruke kunde-/kontoidentifikatorfeltene vist i skjermbildet, og bekreft at de samsvarende feltene unikt identifiserer den samme kunden på begge sider.

For BETALINGSBETINGELSER, velg Kobling/Match-basert kobling. Match Business Central betalingsbetingelsesposter til de tilsvarende Dataverse betalingsbetingelsesalternativverdiene etter de konfigurerte IDene.

For FRAKT METODE, velg Kobling/Match-basert kobling. Match Business Central fraktmetoder til de tilsvarende Dataverse fraktbetingelsesalternativverdiene etter de konfigurerte IDene.

For FRAKT AGENT, velg Kobling/Match-basert kobling. Match Business Central fraktagenter til de tilsvarende Dataverse fraktmetodealternativverdiene etter de konfigurerte IDene.

For LEVERANDØR Velg Mapping/Felter
1. Velg “Rediger liste”
2. og “aktiver” Kontonummer.

Fortsatt for LEVERANDØR, velg Kobling/Match-basert kobling. Match ved å bruke leverandør-/kontoidentifikatorfeltene vist i skjermbildet, og bekreft at de samsvarende feltene unikt identifiserer den samme leverandøren på begge sider.

Trinn 7: Koble miljøer (valgfritt)

For å forhindre at noen ved et uhell sletter miljøer, kan du koble dem. Start tilbake i Business Central.

1. Velg tannhjulikonet
2. Velg deretter Admin Center

Velg målmiljølenken

Klikk på “Koble” og velg ditt Dataverse-miljø

Trinn 8: Installer Business Central-tillegget for RapidStart CRM fra AppSource

Klikk denne lenken for å åpne Microsofts AppSource og bekreft at du er logget inn med din forretningskonto.

Velg “Få det nå” for å starte installasjonen.

1. Velg miljøet der du installerte Virtual Tables-løsningen.
2. Godta vilkårene.
3. Klikk Installer. Merk at installasjonen kan ta flere minutter.

Du vil se at løsningen er “Installerer”. Dette kan ta flere minutter å fullføre. Klikk av og til “oppdater” til du ser at den er “Installert”.

Trinn 9: Fullfør i RapidStart Settings-appen

Gå til RapidStart CRM og velg RapidStart Settings App.

Du kan åpne RapidStart Settings-appen fra App Selector i RapidStart CRM, eller fra maker-portalen:
1. Velg Apper i sidepanelet.
2. Klikk på Kjør-ikonet for RapidStart Settings-appen.

1. Bekreft at du er i RapidStart Settings App.
2. Velg “Apper og Tillegg” i sidepanelet.
3. Klikk “Konfigurer” for Business Central-tillegg.

Åpne Connections først. AppSource viser ikke tilkoblingskartlegging-spørsmålet som brukes under en manuell løsning-import. Veiviseren rapporterer tilkoblingsstatus, men oppretter ikke tilkoblinger eller binder tilkoblingsreferanser.

1. I Connections, velg Configure for Microsoft Dataverse tilkoblingsreferanse. Dette åpner Power Apps.
2. Velg samme Dataverse miljø, åpne deretter Solutions → RapidStart BC Addon → Connection references. Tilordne en gyldig tilkobling til Microsoft Dataverse referansen og lagre.
3. Gjenta Configure for Dynamics 365 Business Central tilkoblingsreferanse. I Power Apps, tilordne en gyldig Business Central tilkobling til den referansen og lagre.
4. Gå tilbake til RapidStart Settings veiviseren og velg Refresh. Bekreft at begge referanser er bundet til aktive tilkoblinger.
5. Fremdeles i Connections, lagre BC Environment som Business Central miljønavn og BC Company System ID som Company System ID GUID registrert i trinn 3, ikke det redigerbare firmanavnet.
6. Når de nødvendige tilkoblingene og innstillingene viser seg klare, åpne Automations og aktiver de anbefalte flytene. La Sync New Account to BC og Sync New Contact to BC av med mindre kunden har valgt de opprettelsesveiene. Hvis native CUSTOMER-synkronisering eier kundeopprettelse, hold Sync New Account to BC av.

Valider før utrulling

Bruk en liten, kontrollert test før bred synkronisering. Opprettelsestestene nedenfor gjelder når native automatisk opprettelse er valgt. Hvis Sync. Only Coupled Records er På, koble testpostene først og verifiser oppdateringer i stedet for å forvente automatisk opprettelse.

1. Bekreft målet Dataverse miljø, Business Central miljø, og Company System ID; test Dataverse-tilkoblingen fra Business Central.
2. Bekreft opprettelseseieren. For native automatisk opprettelse, slå av Sync New Account to BC før testing.
3. Konfigurer og synkroniser CURRENCY, PAYMENT TERMS, SHIPMENT METHOD, og SHIPPING AGENT. Sjekk Dataverse Option Mapping og synkroniseringsfeil. Hvis opsjons-ID-er ikke er på linje, bruk FromIntegrationTable for de tre CUSTOMER opsjons-feltkartleggingene beskrevet i trinn 6.
4. Verifiser CUSTOMER er Bidirectional og bekreft den valgte Sync. Only Coupled Records policyen. For automatisk opprettelse, sett den til Av og la Disable Event-driven Synch. Job Rescheduling være uavkrysset.
5. Gå gjennom CUSTOMER selskapsfiltre, bekreft at dens jobbkøoppføring eksisterer, og merk synkroniseringsintervallet. Manuelt koble kjente eksisterende par; gå gjennom match-basert koblingsresultater før du godtar dem.
6. Kjør Synchronize Modified Records, ikke en full synkronisering, for den første kontrollerte testen. Gå gjennom Integration Synchronization Jobs og løse feil før du utvider utrullingen.
7. Opprett en unikt navngitt Dataverse-konto som oppfyller CUSTOMER-filtrene, uten Business Central kundenummer. Kjør eller vent på synkronisering. Bekreft at en Business Central-kunde er opprettet med et tildelt kundenummer og Coupled to Dataverse = Yes.
8. Endre ett kartlagt felt på Dataverse-kontoen; kjør eller vent på neste synkronisering og bekreft at den koblede Business Central-kunden oppdateres.
9. Opprett en unikt navngitt Business Central-kunde som oppfyller filtrene. Bekreft at den koblede Dataverse-kontoen opprettes; endre ett kartlagt felt i Business Central og bekreft Dataverse-oppdateringen.
10. Test en kunde med en ikke-base valuta. Bekreft valutakartlegging og vekslingskurser er gyldige.
11. Test tilbudsopprettelse bare etter at kontoen er koblet til en gyldig Business Central-kunde.
12. Kjør en full synkronisering bare etter å ha gjennomgått filtre, referansedata, opsjonskartlegginger, eksisterende par og feilloggene.

Feilsøking

Manglende tilkoblings-IDer

Reparer tilkoblingsreferansene i Power Apps: velg samme Dataverse-miljø, deretter Solutions → RapidStart BC Addon → Connection references. Tilordne og lagre gyldige Microsoft Dataverse og Dynamics 365 Business Central forbindelser. Gå tilbake til RapidStart Settings veiviseren og velg Refresh, deretter aktiver den nødvendige flyten igjen under Automations. Veiviseren reparerer ikke tilkoblingene. Å gjenskape en tilkobling alene er ikke tilstrekkelig hvis referansen fremdeles peker til den gamle tilkoblingen.

Valutamappingfeil

Feil: Table CRM Transactioncurrency must be mapped to table Currency to transfer value between fields TransactionCurrencyId and Currency Code.

Den CUSTOMER kartleggingen refererer til Dataverse Valuta, men CURRENCY kartleggingen eller felttilordningen fra Kode → Valutakode mangler, er deaktivert eller har ikke synkronisert den refererte valutaen.

1. Gjenopprett eller opprett CURRENCY-kartleggingen og sett retningen til Business Central til Dataverse.
2. Aktiver Kode → Valutakode og synkroniser valutaer.
3. Bekreft at kundens valuta eksisterer i Dataverse, prøv deretter CUSTOMER-synkronisering på nytt.

Alternativmismatcher

Eksempel: The value 100000003 of 'paymenttermscode' on record of type 'account' is outside the valid range. Accepted Values: 1,2,3,4.

Business Central sendte en tilpasset betalingsbetingelser enum-ID som ikke finnes i Dataverse Konto-iBetingelser-valg.

1. Sammenlign Dataverse Option Mapping med de gyldige Dataverse valg-IDene.
2. Hvis alternativet må synkronisere begge veier, be en utvikler legge til Dataverse valgverdier og Business Central enum-utvidelsesverdier med identiske numeriske IDer. Ikke oppfinn eller omnummerer IDer under oppsett.
3. Ellers, sett CUSTOMER Betalingsbetingelseskode-feltkartleggingen til FromIntegrationTable. Anvend den samme kontrollen på forsendelsesmetode og Forsendelsesagent.
4. Prøv en kunde på nytt og bekreft at Business Central Konto handlingen åpner den koblede Dataverse-kontoen.

Koblinger som peker til slettede poster

Hvis en post ser ut til å være koblet, men synkronisering peker til en slettet eller manglende post, fjern den utdaterte koblingen i Business Central og opprett en ny kobling til riktig Dataverse-konto eller kontakt før du kjører synkronisering på nytt.

Microsoft-referanser

• Synkroniser Business Central og Dataverse
• Planlegg synkroniseringsjobber
• Sett opp en Dataverse tilkobling
• Håndter manglende Dataverse valgverdier