Business Central Addon voor RapidStart CRM-installatie
Stappen om de Business Central Addon voor RapidStart CRM te installeren, configureren en valideren. Deze addon maakt gebruik van zowel RapidStart cloudstromen als Microsoft's native Business Central-Dataverse-synchronisatie, dus beheerders moeten beide zijden valideren voordat ze klant- of offertescenario's testen.
⚠️ Partner Aanbevolen
Vanwege de complexiteit raden we aan om een van onze RapidStart Certified Partners hiervoor te gebruiken. Als uw Business Central-partner ook bedreven is in het Power Platform, kunnen zij deze stappen voor u uitvoeren. We raden niet aan dat een eindgebruiker dit proces probeert.
Hoofdstappen
- Maak een nieuwe of gebruik een bestaande Dataverse-geschikte omgeving.
- Installeer RapidStart CRM van AppSource in de Dataverse-geschikte omgeving.
- Verkrijg de Business Central Bedrijfssysteem-ID.
- Configureer de integratie vanuit Business Central.
- Verifieer de Business Central integratie applicatiegebruikersrol
- Stel Record Mapping in
- Koppel Omgevingen (Optioneel)
- Installeer de Business Central Addon voor RapidStart CRM van AppSource in de Dataverse-geschikte omgeving.
- Voltooi in de RapidStart Instellingen-app
We hebben al een document gemaakt dat stap 1 & 2 hier behandelt. Zodra die stappen zijn voltooid, keer hier terug om verder te gaan met Stap 3.
Zorg ervoor dat de Dataverse- en BC-omgevingstypen overeenkomen: Productie naar Productie, of Sandbox naar Sandbox.
Voordat U Begint
Bevestig deze vereisten voordat u begint met de Business Central Addon-installatie:
- Business Central en Dataverse moeten zich in dezelfde Microsoft Entra-tenant bevinden voor Business Central virtuele tabellen.
- Gebruik een menselijke setupbeheerder met de vereiste Business Central-rechten en Dataverse Systeembeheerderstoegang tijdens de installatie.
- Bevestig dat RapidStart CRM is geïnstalleerd in de Dataverse-omgeving die u van plan bent te verbinden.
Stap 3: Verkrijg Bedrijfs-ID
Om uw bedrijfs-ID te verkrijgen, zoekt u Bedrijven in Business Central. Selecteer het doelbedrijf en druk op Ctrl+Alt+F1 om Pagina Inspectie te openen. Kopieer de weergegeven ID en bewaar deze voor later.
Gebruik de Bedrijfssysteem-ID GUID
De bedrijfs-ID die u nodig heeft voor de RapidStart omgevingsvariabele is de Business Central Bedrijfssysteem-ID GUID. Gebruik niet de bewerkbare bedrijfsweergavenaam uit de adresbalk. Als u Pagina Inspectie niet kunt openen, vraag dan uw Business Central-beheerder of partner om de bedrijfs-ID te verstrekken.
Stap 4: Configureer de Integratie vanuit Business Central
Log in op de Business Central-omgeving waarmee u verbinding wilt maken.
Let op de Business Central omgevingsnaam in de adresbalk. De URL kan ook de bedrijfsweergavenaam tonen, maar u heeft de Bedrijfssysteem-ID GUID al vastgelegd in de vorige stap.
Kopieer de Business Central omgevingsnaam naar dezelfde notities waar u de Bedrijfssysteem-ID GUID heeft opgeslagen.
Bedrijfs-ID al vastgelegd
Gebruik de Bedrijfssysteem-ID GUID van Stap 3 wanneer de installatie vraagt om de BC Bedrijfs-ID. De bedrijfsweergavenaam in de URL is alleen een achterwaarts compatibele terugvaloptie voor oudere implementaties.
1. Klik op het tandwiel
2. Selecteer “Geassisteerde Setup”
Scroll naar beneden naar de sectie “Verbinden met andere systemen” en klik op “Een verbinding met Dataverse instellen”.
1. Selecteer om gegevenssynchronisatie in te schakelen
2. Selecteer om virtuele tabellen en gebeurtenissen in te schakelen
3. Klik “Volgende”
Accepteer de Voorwaarden en klik “Volgende”
Accepteer de verbinding met Dataverse “Altijd Toestaan”, en klik OK
Selecteer de doel Dataverse-geschikte omgeving, en klik “Ok”
Bevestig dat de omgeving correct is, klik dan op de link om in te loggen op de Dataverse-omgeving. Na het inloggen klik “Volgende”
Selecteer de aanbevolen Team eigendom, schakel over naar Voltooi zonder synchronisatie (we doen dit later) en klik “Volgende”
1. Klik op Link om Business Central Virtuele Tabel-app te installeren
2. Klik “Volgende” (Er wordt een nieuw tabblad geopend naar AppSource)
Klik op de “Nu verkrijgen” knop (Deze addon is gratis), en de volgende pagina zal openen:
1. Selecteer de doelomgeving (waar u RapidStart CRM heeft geïnstalleerd).
2. Ga akkoord met de voorwaarden.
3. Klik “Installeren”.
U zult zien dat de oplossing “Aan het installeren” is. Dit kan enkele minuten duren om te voltooien. Klik af en toe op “verversen” totdat u ziet dat het “Geïnstalleerd” is, ga dan terug naar het Business Central Browser-tabblad om verder te gaan.
Klik “Verversen”
U zult zien dat de Virtuele Tabellen-app succesvol is geïnstalleerd. Klik “Voltooien”
Na een paar minuten verschijnt deze pagina. Selecteer Virtuele Tabellen Tabblad en dan “Beschikbare Virtuele Tabellen”
1. Begin met het selecteren van de “item” regel
2. Klik “Inschakelen” (Dit zal de virtuele tabel in Dataverse voor items creëren)
3. Wacht tot u ziet dat het “Zichtbaar” vakje is aangevinkt. U moet mogelijk een paar keer verversen.
Herhaal deze stappen voor: salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment, en salesShipmentLine. Dit zal enkele minuten duren voor elk om in te schakelen.
Wijzig om te sorteren op Zichtbaar/aflopend, en bevestig dat u al deze tabellen ziet. Voeg op dit moment geen extra Virtuele Tabellen toe. U kunt het scherm laten zoals het is (we komen hierop terug) en een nieuw tabblad openen.
Stap 5: Verifieer de Business Central Integratie Applicatiegebruiker
Ken geen Systeembeheerder toe aan de applicatiegebruiker
De menselijke setupbeheerder heeft Dataverse Systeembeheerder-rechten nodig tijdens de installatie. De automatisch aangemaakte Business Central integratie applicatiegebruiker moet gebruik maken van Microsoft's Business Central Dataverse Integratie rol, niet Systeembeheerder.
Als Business Central-Dataverse synchronisatierechten beschadigd lijken, open dan Dataverse Verbinding Setup in Business Central en gebruik Herimplementatie Integratie Oplossing. Dit herstelt Microsoft's integratieoplossing en implementeert de Business Central integratie beveiligingsrol.
Ga alleen verder nadat de verbindingstest is geslaagd en de Business Central integratie applicatiegebruiker de Business Central Dataverse Integratie rol van Microsoft heeft.
Stap 6: Stel Record Mapping en Koppeling in
RapidStart flows en Microsoft synchronisatie zijn gescheiden
RapidStart cloud flows ondersteunen addon-acties zoals offerteaanvragen en geselecteerde klant/contact updates. Microsoft's native Business Central integratie-tabel mappings behandelen Business Central-Dataverse synchronisatie, koppeling, referentiegegevens en geplande synchronisatie. Configureer beide tegen dezelfde Dataverse-omgeving en Business Central-bedrijf.
Configureer referentiemappings voordat u klantensynchronisatie uitvoert
Voer referentiemappings uit en valideer deze voordat u KLANT test. Klantensynchronisatie mislukt vaak wanneer valuta, betalingsvoorwaarden, verzendmethode of verzendagentwaarden niet bestaan of geen overeenkomende optie-ID's hebben aan de Dataverse-kant.
Referentiemappings om te configureren voordat KLANT
- VALUTA: Business Central Valuta → Dataverse Transactie Valuta. Richting moet zijn Business Central naar Dataverse. Bevestig deze ingeschakelde veldmappings: Code → Valutacode, Symbool → Valutasymbool, en Beschrijving → Valutanaam.
- Bevestig dat de KLANT mapping Valutacode → Valuta bevat. Synchroniseer valuta's voordat klanten. De Dataverse basisvaluta en Business Central lokale valuta moeten overeenkomen, en vereiste wisselkoersen moeten bestaan.
- Betalingsvoorwaarden: synchroniseer naar Account Betalingsvoorwaarden voordat u klanten test.
- Verzendmethode: synchroniseer naar Account Vrachtvoorwaarden voordat u klanten test.
- Verzendagent: synchroniseer naar Account Verzendmethode voordat u klanten test.
Klantencreatiebeleid
Stel KLANT in op Bidirectioneel als accounts/bedrijven aan beide zijden kunnen worden aangemaakt. Kies dan het Synchroniseer Alleen Gekoppelde Records beleid als een klantimplementatiebeslissing:
| Instelling | Gedrag |
|---|---|
| Synchroniseer Alleen Gekoppelde Records = Aan | Synchroniseert alleen records die een beheerder al heeft gekoppeld. Dit voorkomt brede creatie van nieuwe ongekoppelde records. |
| Synchroniseer Alleen Gekoppelde Records = Uit | Initiële en geplande synchronisatie kan ongekoppelde klanten/accounts aan de andere kant creëren. Gebruik dit alleen wanneer dat creatiegedrag is bedoeld. |
Koppeling vereist wanneer Synchroniseer Alleen Gekoppelde Records Aan is
Wanneer Synchroniseer Alleen Gekoppelde Records Aan is, werkt Microsoft synchronisatie alleen records bij die al gekoppeld zijn. Een RapidStart flow kan een Business Central klant creëren en zijn klantnummer opslaan op het Dataverse-account, maar dat stelt Microsoft's native koppeling niet vast. Na het gebruik van de flow, koppel de klant en het account handmatig in Business Central als voortdurende native synchronisatie vereist is. Een Business Central klantnummer op zichzelf is geen bewijs van koppeling.
Optiewaardevalidatie
Business Central enum waarde-ID's gebruikt voor Betalingsvoorwaarden, Verzendmethode en Verzendagent moeten overeenkomen met de corresponderende Dataverse optie-ID's. Alleen de weergavetekst of codelabel is niet voldoende. Een volledige synchronisatie herstelt geen ID-mismatch wanneer Business Central aangepaste enumwaarden bevat die niet bestaan in Dataverse.
- Voer Synchroniseer Gewijzigde Records uit voor BETALINGSVOORWAARDEN, VERZENDMETHODE en VERZENDAGENT.
- Inspecteer Dataverse Optie Mapping en de synchronisatiefoutlog voordat u KLANT test.
- Als ID's niet zijn uitgelijnd, gebruik dan de veilige standaard op de KLANT veldmappings: Betalingsvoorwaarden Code → Betalingsvoorwaarden = FromIntegrationTable; Verzendmethode Code → Adres 1: Vrachtvoorwaarden = FromIntegrationTable; Verzendagent Code → Adres 1: Verzendmethode = FromIntegrationTable.
- Wijzig die drie velden naar Bidirectioneel alleen nadat een ontwikkelaar overeenkomende optie-ID's aan beide zijden heeft toegevoegd.
- Verzin of hernummer geen optie-ID's tijdens de installatie. Aangepaste Dataverse waarden en Business Central enum extensies moeten exact dezelfde ID's gebruiken.
Ga terug naar het Business Central tabblad in uw browser dat we open hebben gelaten.
1. Klik op het “Integratie” tabblad
2. dan “Integratie Tabel Mappings”
Klantbeslissing: behoud VERKOPERS als de klant Microsoft's standaard Dataverse-gebruiker-naar-Business-Central-verkoper synchronisatie wil. Verwijder of schakel deze mapping alleen uit wanneer die standaard synchronisatie opzettelijk niet wordt gebruikt.
1. Selecteer CONTACT
2. Selecteer Koppeling
3. Klik dan “Match-Based Koppeling”.
4. Match de bovenstaande en klik OK
1. Selecteer VALUTA
2. Selecteer Koppeling
3. Klik dan “Match-Based Koppeling”.
4. Match de bovenstaande en klik OK
Voor KLANT Selecteer Mapping/Velden
1. Selecteer “Lijst Bewerken”
2. en “schakel in” Rekeningnummer.
Nog steeds voor KLANT, selecteer Koppeling/Match-Based Koppeling. Match met behulp van de klant/account identificatievelden getoond in de screenshot, en bevestig dat de overeenkomende velden dezelfde klant aan beide zijden uniek identificeren.
Voor BETALINGSVOORWAARDEN, selecteer Koppeling/Match-Based Koppeling. Match Business Central betalingsvoorwaarde records met de corresponderende Dataverse betalingsvoorwaarde optie waarden door de geconfigureerde ID's.
Voor VERZENDMETHODE, selecteer Koppeling/Match-Based Koppeling. Match Business Central verzendmethoden met de corresponderende Dataverse vrachtvoorwaarde optie waarden door de geconfigureerde ID's.
Voor VERZENDAGENT, selecteer Koppeling/Match-Based Koppeling. Match Business Central verzendagenten met de corresponderende Dataverse verzendmethode optie waarden door de geconfigureerde ID's.
Voor LEVERANCIER Selecteer Mapping/Velden
1. Selecteer “Lijst Bewerken”
2. en “schakel in” Rekeningnummer.
Nog steeds voor LEVERANCIER, selecteer Koppeling/Match-Based Koppeling. Match met behulp van de leverancier/account identificatievelden getoond in de screenshot, en bevestig dat de overeenkomende velden dezelfde leverancier aan beide zijden uniek identificeren.
Stap 7: Koppel Omgevingen (Optioneel)
Optionele omgevingskoppeling vereiste
Koppel omgevingen alleen wanneer de Business Central-omgeving en Power Platform-omgeving hetzelfde omgevingstype zijn, zoals productie-naar-productie of sandbox-naar-sandbox, en zich in dezelfde Azure-geografie bevinden.
Om te voorkomen dat iemand per ongeluk omgevingen verwijdert, kunt u ze koppelen. Begin terug in Business Central.
1. Selecteer het Tandwielpictogram
2. Selecteer dan Admin Center
Selecteer de doelomgeving link
Klik op “Koppelen” en selecteer uw Dataverse-omgeving
Stap 8: Installeer de Business Central Addon voor RapidStart CRM van AppSource
Bevestig de vereiste basis voordat u de addon installeert
RapidStart CRM en Microsoft Business Central Virtuele Tabel ondersteuning moeten eerst geïnstalleerd zijn. Verifieer de vereiste Business Central virtuele tabellen en verbindingswaarden voordat u doorgaat. Optionele omgevingskoppeling hoeft niet voltooid te zijn voor deze AppSource-installatie.
Klik deze link om Microsoft's AppSource te openen en bevestig dat u bent ingelogd met uw zakelijke account.
Selecteer “Nu verkrijgen” om de installatie te starten.
1. Selecteer de omgeving waar u de Virtuele Tabellen-oplossing heeft geïnstalleerd.
2. Ga akkoord met de voorwaarden.
3. Klik Installeren. Let op dat de installatie enkele minuten kan duren.
U zult zien dat de oplossing “Aan het installeren” is. Dit kan enkele minuten duren om te voltooien. Klik af en toe op “verversen” totdat u ziet dat het “Geïnstalleerd” is.
Stap 9: Voltooi in RapidStart Instellingen-app
Ga naar RapidStart CRM en selecteer de RapidStart Instellingen App.
U kunt de RapidStart Instellingen-app openen vanuit de App Selector in RapidStart CRM, of vanuit het makerportaal:
1. Selecteer Apps in de zijbalk.
2. Klik op het Uitvoeren-pictogram voor de RapidStart Instellingen-app.
1. Bevestig dat u in de RapidStart Instellingen App bent.
2. Selecteer “Apps en Addons” in de zijbalk.
3. Klik “Configureer” voor Business Central Addon.
Gebruik deze wizard om ontbrekende items te voltooien en de connector te beheren.
Probleemoplossing
Ontbrekende verbindings-ID's
Als een flow een ontbrekende verbindings-ID meldt, repareer de Dataverse en Business Central verbindingsreferenties in de RapidStart Instellingen-app of Power Automate, en zet de flow dan weer aan. Alleen een verbinding opnieuw maken is niet voldoende als de verbindingsreferentie nog steeds gebonden is aan de oude verbinding.
Valutamapping fouten
Als KLANT synchronisatie mislukt op valuta, herstel of verifieer de VALUTA mapping, bevestig dat Code → Valutacode is ingeschakeld, synchroniseer valuta's, en bevestig dat de klantvaluta bestaat in Dataverse voordat u KLANT opnieuw probeert.
Optie mismatches
Als synchronisatie mislukt omdat een Betalingsvoorwaarden, Verzendmethode of Verzendagent waarde buiten het geldige Dataverse-bereik ligt, komt de Business Central enum waarde-ID niet overeen met een Dataverse optie-ID. Gebruik FromIntegrationTable voor de getroffen KLANT veldmapping totdat overeenkomende ID's zijn geïmplementeerd.
Koppelingen die naar verwijderde records wijzen
Als een record gekoppeld lijkt maar synchronisatie wijst naar een verwijderd of ontbrekend record, verwijder de verouderde koppeling in Business Central en maak een nieuwe koppeling naar het juiste Dataverse-account of contact voordat u synchronisatie opnieuw uitvoert.
Implementatie Voltooid
Als er problemen zijn met deze documentatie, laat het ons dan weten.