Business Central Addon für RapidStart CRM Einrichtung
Schritte zur Installation, Konfiguration und Validierung des Business Central Addons für RapidStart CRM. Dieses Addon verwendet sowohl RapidStart-Cloud-Flows als auch die native Business Central-Dataverse-Synchronisierung von Microsoft, daher sollten Administratoren beide Seiten validieren, bevor sie Kunden- oder Angebotsszenarien testen.
⚠️ Partner empfohlen
Aufgrund der Komplexität empfehlen wir, einen unserer RapidStart Certified Partner dafür zu nutzen. Wenn Ihr Business Central-Partner auch in der Power Platform versiert ist, kann er diese Schritte für Sie durchführen. Wir empfehlen nicht, dass ein Endbenutzer diesen Prozess versucht.
Schritte auf hoher Ebene
- Erstellen oder verwenden Sie eine vorhandene Dataverse-fähige Umgebung.
- Installieren Sie RapidStart CRM aus AppSource in der Dataverse-fähigen Umgebung.
- Erhalten Sie die Business Central Company System ID.
- Konfigurieren Sie die Integration innerhalb von Business Central.
- Überprüfen Sie die Benutzerrolle der Business Central-Integrationsanwendung
- Einrichten der Datensatzzuordnung
- Umgebungen verknüpfen (optional)
- Installieren Sie das Business Central Addon für RapidStart CRM aus AppSource in der Dataverse-fähigen Umgebung.
- Abschließen in der RapidStart Settings App
Wir haben bereits ein Dokument erstellt, das die Schritte 1 & 2 hier abdeckt. Sobald diese Schritte abgeschlossen sind, kehren Sie hierher zurück, um mit Schritt 3 fortzufahren.
Stellen Sie sicher, dass die Dataverse- und BC-Umgebungstypen übereinstimmen: Produktion zu Produktion oder Sandbox zu Sandbox.
Bevor Sie beginnen
Bestätigen Sie diese Anforderungen, bevor Sie mit der Einrichtung des Business Central Addons beginnen:
- Business Central und Dataverse müssen sich im selben Microsoft Entra-Mandanten für Business Central-Virtuelle Tabellen befinden.
- Verwenden Sie während der Einrichtung einen menschlichen Setup-Administrator mit den erforderlichen Business Central-Berechtigungen und Dataverse-Systemadministratorzugriff.
- Bestätigen Sie, dass RapidStart CRM in der Dataverse-Umgebung installiert ist, die Sie verbinden möchten.
Schritt 3: Unternehmens-ID erhalten
Um Ihre Unternehmens-ID zu erhalten, suchen Sie in Business Central nach Unternehmen. Wählen Sie das Zielunternehmen aus und drücken Sie Strg+Alt+F1, um die Seiteninspektion zu öffnen. Kopieren Sie die angezeigte ID und speichern Sie sie für später.
Verwenden Sie die Company System ID GUID
Die Unternehmens-ID, die Sie für die RapidStart-Umgebungsvariable benötigen, ist die Business Central Company System ID GUID. Verwenden Sie nicht den bearbeitbaren Unternehmensanzeigennamen aus der Adressleiste. Wenn Sie die Seiteninspektion nicht öffnen können, bitten Sie Ihren Business Central-Administrator oder -Partner, Ihnen die Unternehmens-ID bereitzustellen.
Schritt 4: Konfigurieren Sie die Integration innerhalb von Business Central
Melden Sie sich bei der Business Central-Umgebung an, die Sie verbinden möchten.
Notieren Sie sich den Business Central-Umgebungsnamen in der Adressleiste. Die URL kann auch den Unternehmensanzeigennamen anzeigen, aber Sie haben bereits die Company System ID GUID im vorherigen Schritt erfasst.
Kopieren Sie den Business Central-Umgebungsnamen in die gleichen Notizen, in denen Sie die Company System ID GUID gespeichert haben.
Unternehmens-ID bereits erfasst
Verwenden Sie die Company System ID GUID aus Schritt 3, wenn die Einrichtung nach der BC-Unternehmens-ID fragt. Der Unternehmensanzeigennamen in der URL ist nur ein rückwärtskompatibler Fallback für ältere Bereitstellungen.
1. Klicken Sie auf das Zahnrad
2. Wählen Sie “Unterstützte Einrichtung”
Scrollen Sie nach unten zum Abschnitt “Verbindung mit anderen Systemen” und klicken Sie auf “Verbindung zu Dataverse einrichten”.
1. Wählen Sie, um die Datensynchronisation zu aktivieren
2. Wählen Sie, um virtuelle Tabellen und Ereignisse zu aktivieren
3. Klicken Sie auf “Weiter”
Akzeptieren Sie die Bedingungen und klicken Sie auf “Weiter”
Akzeptieren Sie die Verbindung zu Dataverse “Immer erlauben”, und klicken Sie auf OK
Wählen Sie die Ziel-Dataverse-fähige Umgebung aus und klicken Sie auf “Ok”
Bestätigen Sie, dass die Umgebung korrekt ist, und klicken Sie dann auf den Link, um sich bei der Dataverse-Umgebung anzumelden. Nach der Anmeldung klicken Sie auf “Weiter”
Wählen Sie das empfohlene Teameigentum, schalten Sie auf Abschließen ohne Synchronisation um (wir werden dies später tun) und klicken Sie auf “Weiter”
1. Klicken Sie auf den Link, um die Business Central Virtual Table App zu installieren
2. Klicken Sie auf “Weiter” (Ein neuer Tab wird zu AppSource geöffnet)
Klicken Sie auf den “Jetzt holen” Button (Dieses Addon ist kostenlos), und die folgende Seite wird geöffnet:
1. Wählen Sie die Zielumgebung aus (wo Sie RapidStart CRM installiert haben).
2. Stimmen Sie den Bedingungen zu.
3. Klicken Sie auf “Installieren”.
Sie werden sehen, dass die Lösung “Installiert wird”. Dies kann mehrere Minuten dauern. Klicken Sie gelegentlich auf “Aktualisieren”, bis Sie sehen, dass sie “Installiert” ist, und kehren Sie dann zum Business Central-Browser-Tab zurück, um fortzufahren.
Klicken Sie auf “Aktualisieren”
Sie werden sehen, dass die Virtual Tables App erfolgreich installiert wurde. Klicken Sie auf “Fertigstellen”
Nach einigen Minuten wird diese Seite angezeigt. Wählen Sie den Virtual Tables Tab und dann “Verfügbare Virtual Tables”
1. Beginnen Sie mit der Auswahl der “Artikel”-Zeile
2. Klicken Sie auf “Aktivieren” (Dies wird die virtuelle Tabelle in Dataverse für Artikel erstellen)
3. Warten Sie, bis Sie sehen, dass das “Sichtbar”-Feld angekreuzt ist. Möglicherweise müssen Sie einige Male aktualisieren.
Wiederholen Sie diese Schritte für: salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment und salesShipmentLine. Dies wird mehrere Minuten dauern, um jeden zu aktivieren.
Ändern Sie die Sortierung nach Sichtbar/absteigend und bestätigen Sie, dass Sie alle diese Tabellen sehen. Fügen Sie zu diesem Zeitpunkt keine weiteren virtuellen Tabellen hinzu. Sie können den Bildschirm so lassen, wie er ist (wir werden darauf zurückkommen) und einen neuen Tab öffnen.
Schritt 5: Überprüfen Sie den Business Central Integration Application User
Weisen Sie dem Anwendungsbenutzer nicht den Systemadministrator zu
Der menschliche Setup-Administrator benötigt während der Einrichtung Dataverse-Systemadministratorberechtigungen. Der automatisch erstellte Business Central-Integrationsanwendungsbenutzer sollte Microsofts Business Central Dataverse Integration-Rolle verwenden, nicht den Systemadministrator.
Wenn die Business Central-Dataverse-Synchronisationsberechtigungen beschädigt erscheinen, öffnen Sie Dataverse Connection Setup in Business Central und verwenden Sie Redeploy Integration Solution. Dies stellt Microsofts Integrationslösung wieder her und implementiert die Business Central-Integrationssicherheitsrolle.
Fahren Sie erst fort, nachdem der Verbindungstest erfolgreich war und der Business Central-Integrationsanwendungsbenutzer Microsofts Business Central Dataverse Integration-Rolle hat.
Schritt 6: Einrichten der Datensatzzuordnung und Kopplung
RapidStart-Flows und Microsoft-Synchronisation sind getrennt
RapidStart-Cloud-Flows unterstützen Addon-Aktionen wie Angebotsanfragen und ausgewählte Kunden-/Kontaktaktualisierungen. Microsofts native Business Central-Integrations-Tabellenzuordnungen behandeln Business Central-Dataverse-Synchronisation, Kopplung, Referenzdaten und geplante Synchronisation. Konfigurieren Sie beide gegen dieselbe Dataverse-Umgebung und dasselbe Business Central-Unternehmen.
Konfigurieren Sie Referenzzuordnungen vor der Kundensynchronisation
Führen Sie Referenzzuordnungen aus und validieren Sie sie, bevor Sie den KUNDEN testen. Die Kundensynchronisation schlägt oft fehl, wenn Währungs-, Zahlungsbedingungen-, Versandmethode- oder Versandagentenwerte nicht existieren oder keine übereinstimmenden Options-IDs auf der Dataverse-Seite haben.
Referenzzuordnungen, die vor KUNDEN zu konfigurieren sind
- WÄHRUNG: Business Central-Währung → Dataverse-Transaktionswährung. Die Richtung muss Business Central zu Dataverse sein. Bestätigen Sie diese aktivierten Feldzuordnungen: Code → Währungscode, Symbol → Währungssymbol und Beschreibung → Währungsname.
- Bestätigen Sie, dass die KUNDEN-Zuordnung Währungscode → Währung enthält. Synchronisieren Sie Währungen vor Kunden. Die Dataverse-Basiswährung und die lokale Business Central-Währung müssen übereinstimmen, und erforderliche Wechselkurse müssen existieren.
- Zahlungsbedingungen: Synchronisieren Sie zu Kontozahlungsbedingungen, bevor Sie den Kunden testen.
- Versandmethode: Synchronisieren Sie zu Konto-Frachtbedingungen, bevor Sie den Kunden testen.
- Versandagent: Synchronisieren Sie zu Konto-Versandmethode, bevor Sie den Kunden testen.
Kundenerstellungspolitik
Setzen Sie KUNDEN auf Bidirektional, wenn Konten/Unternehmen auf beiden Seiten erstellt werden können. Wählen Sie dann die Nur gekoppelte Datensätze synchronisieren-Politik als Kundenbereitstellungsentscheidung:
| Einstellung | Verhalten |
|---|---|
| Nur gekoppelte Datensätze synchronisieren = Ein | Synchronisiert nur Datensätze, die ein Administrator bereits gekoppelt hat. Dies vermeidet die breite Erstellung neuer nicht gekoppelter Datensätze. |
| Nur gekoppelte Datensätze synchronisieren = Aus | Die anfängliche und geplante Synchronisation kann nicht gekoppelte Kunden/Konten auf der anderen Seite erstellen. Verwenden Sie dies nur, wenn dieses Erstellungsverhalten beabsichtigt ist. |
Kopplung erforderlich, wenn Nur gekoppelte Datensätze synchronisieren aktiviert ist
Wenn Nur gekoppelte Datensätze synchronisieren aktiviert ist, aktualisiert die Microsoft-Synchronisation nur bereits gekoppelte Datensätze. Ein RapidStart-Flow kann einen Business Central-Kunden erstellen und seine Kundennummer im Dataverse-Konto speichern, aber das stellt keine native Kopplung von Microsoft her. Nach der Verwendung des Flows koppeln Sie den Kunden und das Konto manuell in Business Central, wenn eine fortlaufende native Synchronisation erforderlich ist. Eine Business Central-Kundennummer allein ist kein Beweis für eine Kopplung.
Option-Wert-Validierung
Die in Business Central verwendeten Enum-Wert-IDs für Zahlungsbedingungen, Versandmethode und Versandagent müssen den entsprechenden Dataverse-Options-IDs entsprechen. Der Anzeigetext oder Code-Label allein reicht nicht aus. Eine vollständige Synchronisation repariert keine ID-Übereinstimmung, wenn Business Central benutzerdefinierte Enum-Werte enthält, die in Dataverse nicht existieren.
- Führen Sie Synchronisieren geänderter Datensätze für ZAHLUNGSBEDINGUNGEN, VERSANDMETHODE und VERSANDAGENT aus.
- Überprüfen Sie Dataverse-Optionszuordnung und das Synchronisationsfehlerprotokoll, bevor Sie den KUNDEN testen.
- Wenn IDs nicht übereinstimmen, verwenden Sie den sicheren Standard bei den KUNDEN-Feldzuordnungen: Zahlungsbedingungen-Code → Zahlungsbedingungen = FromIntegrationTable; Versandmethode-Code → Adresse 1: Frachtbedingungen = FromIntegrationTable; Versandagent-Code → Adresse 1: Versandmethode = FromIntegrationTable.
- Ändern Sie diese drei Felder nur dann auf Bidirektional, nachdem ein Entwickler übereinstimmende Options-IDs auf beiden Seiten hinzugefügt hat.
- Erfinden oder ändern Sie keine Options-IDs während der Einrichtung. Benutzerdefinierte Dataverse-Werte und Business Central-Enum-Erweiterungen müssen genau dieselben IDs verwenden.
Gehen Sie zurück zum Business Central-Tab in Ihrem Browser, den wir offen gelassen haben.
1. Klicken Sie auf den “Integration”-Tab
2. dann “Integration Table Mappings”
Kundenentscheidung: Behalten Sie VERKÄUFER, wenn der Kunde Microsofts Standard-Dataverse-Benutzer-zu-Business-Central-Verkäufer-Synchronisation möchte. Löschen oder deaktivieren Sie diese Zuordnung nur, wenn diese Standardsynchronisation absichtlich nicht verwendet wird.
1. Wählen Sie KONTAKT
2. Wählen Sie Kopplung
3. Dann klicken Sie auf “Match-Based Coupling”.
4. Stimmen Sie dem oben genannten zu und klicken Sie auf OK
1. Wählen Sie WÄHRUNG
2. Wählen Sie Kopplung
3. Dann klicken Sie auf “Match-Based Coupling”.
4. Stimmen Sie dem oben genannten zu und klicken Sie auf OK
Für KUNDEN wählen Sie Mapping/Felder
1. Wählen Sie “Liste bearbeiten”
2. und “aktivieren” Sie die Kontonummer.
Immer noch für KUNDEN, wählen Sie Kopplung/Match-Based Coupling. Stimmen Sie mit den im Screenshot gezeigten Kunden-/Konten-Identifikatorfeldern überein und bestätigen Sie, dass die übereinstimmenden Felder denselben Kunden auf beiden Seiten eindeutig identifizieren.
Für ZAHLUNGSBEDINGUNGEN wählen Sie Kopplung/Match-Based Coupling. Stimmen Sie Business Central-Zahlungsbedingungsdatensätze mit den entsprechenden Dataverse-Zahlungsbedingungsoptionswerten anhand der konfigurierten IDs ab.
Für VERSANDMETHODE wählen Sie Kopplung/Match-Based Coupling. Stimmen Sie Business Central-Versandmethoden mit den entsprechenden Dataverse-Frachtbedingungsoptionswerten anhand der konfigurierten IDs ab.
Für VERSANDAGENT wählen Sie Kopplung/Match-Based Coupling. Stimmen Sie Business Central-Versandagenten mit den entsprechenden Dataverse-Versandmethodenoptionswerten anhand der konfigurierten IDs ab.
Für LIEFERANT wählen Sie Mapping/Felder
1. Wählen Sie “Liste bearbeiten”
2. und “aktivieren” Sie die Kontonummer.
Immer noch für LIEFERANT, wählen Sie Kopplung/Match-Based Coupling. Stimmen Sie mit den im Screenshot gezeigten Lieferanten-/Konten-Identifikatorfeldern überein und bestätigen Sie, dass die übereinstimmenden Felder denselben Lieferanten auf beiden Seiten eindeutig identifizieren.
Schritt 7: Umgebungen verknüpfen (optional)
Optionale Anforderung zur Verknüpfung von Umgebungen
Verknüpfen Sie Umgebungen nur, wenn die Business Central-Umgebung und die Power Platform-Umgebung denselben Umgebungstyp haben, wie z.B. Produktion-zu-Produktion oder Sandbox-zu-Sandbox, und sich in derselben Azure-Geografie befinden.
Um zu verhindern, dass jemand versehentlich Umgebungen löscht, können Sie sie verknüpfen. Beginnen Sie zurück in Business Central.
1. Wählen Sie das Zahnradsymbol
2. Dann wählen Sie Admin Center
Wählen Sie den Zielumgebungslink aus
Klicken Sie auf “Verknüpfen” und wählen Sie Ihre Dataverse-Umgebung
Schritt 8: Installieren Sie das Business Central Addon für RapidStart CRM aus AppSource
Bestätigen Sie die erforderliche Grundlage, bevor Sie das Addon installieren
RapidStart CRM und Microsoft Business Central Virtual Table-Unterstützung müssen zuerst installiert werden. Überprüfen Sie die erforderlichen Business Central-Virtuellen Tabellen und Verbindungswerte, bevor Sie fortfahren. Die optionale Verknüpfung von Umgebungen muss für diese AppSource-Installation nicht abgeschlossen sein.
Klicken Sie auf diesen Link, um Microsofts AppSource zu öffnen und bestätigen Sie, dass Sie mit Ihrem Geschäftskonto angemeldet sind.
Wählen Sie “Jetzt holen”, um die Installation zu starten.
1. Wählen Sie die Umgebung aus, in der Sie die Virtual Tables-Lösung installiert haben.
2. Stimmen Sie den Bedingungen zu.
3. Klicken Sie auf Installieren. Beachten Sie, dass die Installation mehrere Minuten dauern kann.
Sie werden sehen, dass die Lösung “Installiert wird”. Dies kann mehrere Minuten dauern. Klicken Sie gelegentlich auf “Aktualisieren”, bis Sie sehen, dass sie “Installiert” ist.
Schritt 9: Abschließen in der RapidStart Settings App
Gehen Sie zu RapidStart CRM und wählen Sie die RapidStart Settings App.
Sie können die RapidStart Settings App aus dem App-Auswahlmenü in RapidStart CRM oder aus dem Maker-Portal öffnen:
1. Wählen Sie Apps in der Seitenleiste.
2. Klicken Sie auf das Ausführen-Symbol für die RapidStart Settings App.
1. Bestätigen Sie, dass Sie sich in der RapidStart Settings App befinden.
2. Wählen Sie “Apps und Addons” in der Seitenleiste.
3. Klicken Sie auf “Konfigurieren” für das Business Central Addon.
Verwenden Sie diesen Assistenten, um fehlende Elemente zu vervollständigen und den Connector zu verwalten.
Fehlerbehebung
Fehlende Verbindungs-IDs
Wenn ein Flow eine fehlende Verbindungs-ID meldet, reparieren Sie die Dataverse- und Business Central-Verbindungsreferenzen in der RapidStart Settings App oder Power Automate und schalten Sie den Flow dann wieder ein. Das alleinige Erstellen einer neuen Verbindung reicht nicht aus, wenn die Verbindungsreferenz noch an die alte Verbindung gebunden ist.
Währungszuordnungsfehler
Wenn die KUNDEN-Synchronisation bei der Währung fehlschlägt, stellen Sie die WÄHRUNG-Zuordnung wieder her oder überprüfen Sie sie, bestätigen Sie, dass Code → Währungscode aktiviert ist, synchronisieren Sie Währungen und bestätigen Sie, dass die Kundenwährung in Dataverse existiert, bevor Sie KUNDEN erneut versuchen.
Optionsabweichungen
Wenn die Synchronisation fehlschlägt, weil ein Zahlungsbedingungen-, Versandmethode- oder Versandagentenwert außerhalb des gültigen Dataverse-Bereichs liegt, stimmt die Business Central-Enum-Wert-ID nicht mit einer Dataverse-Options-ID überein. Verwenden Sie FromIntegrationTable für die betroffene KUNDEN-Feldzuordnung, bis übereinstimmende IDs bereitgestellt sind.
Kopplungen, die auf gelöschte Datensätze verweisen
Wenn ein Datensatz gekoppelt erscheint, aber die Synchronisation auf einen gelöschten oder fehlenden Datensatz verweist, entfernen Sie die veraltete Kopplung in Business Central und erstellen Sie eine neue Kopplung zum richtigen Dataverse-Konto oder -Kontakt, bevor Sie die Synchronisation erneut ausführen.
Bereitstellung abgeschlossen
Wenn es Probleme mit dieser Dokumentation gibt, lassen Sie es uns bitte wissen.