Business-Logik on dsyr.SalesCentral

Freigabe nach Business Central

Mon, 01 Jan 0001 00:00:00 +0000

Das Feld „Sync zu BC"

Nicht jede Firma und nicht jeder Kontakt gehört nach Business Central. Ein Interessent, der nie zum Kunden wird, hat dort nichts verloren. Deshalb ist die Übertragung kein Automatismus, sondern eine bewusste Entscheidung: Das Feld Sync zu BC (wysa_sync2bc) gibt einen Datensatz frei. Erst dann liest die dsyr.DataBridge ihn und überträgt ihn.

Das Feld steht auf Firma, Kontakt, Verkaufschance und Verkaufschancenprodukt.

Die Grundregel: erst der Vater, dann das Kind

Business Central kann einen Kontakt nur anlegen, wenn dessen Firma dort bereits existiert. Genauso wenig kann eine Verkaufschance ohne ihren Kontakt übertragen werden. Daraus folgt die zentrale Regel der Integration:

Anrede und Sprache

Mon, 01 Jan 0001 00:00:00 +0000

Anredetexte entstehen automatisch

Sobald Vorname, Nachname, Geschlecht, Titel oder Sprache eines Kontakts oder Leads gesetzt oder geändert werden, erzeugt die Lösung die Anredetexte neu:

Formelle Anrede — für offizielle Korrespondenz
Informelle Anrede — für den vertrauten Schriftverkehr
Persönliche Anrede — für die direkte Ansprache

Welche dieser Formen tatsächlich verwendet wird, bestimmt das Feld Bevorzugte Anredeform (wysa_PreferredSalutationType). Der gewählte Text wird in das Feld Bevorzugte Anrede übernommen — dieses eine Feld ist es, das in Vorlagen und Serienbriefen verwendet wird.

Beträge und Margen

Mon, 01 Jan 0001 00:00:00 +0000

Angebotssumme und Marge

Die Beträge eines Angebots werden nicht erfasst, sondern aus den Positionen berechnet. Sobald eine Angebotsposition angelegt, geändert oder gelöscht wird, aktualisiert die Lösung am Angebot:

Feld	Berechnung
BC Gesamtbetrag (`wysa_bcTotalAmount`)	Summe der Positionsbeträge
Marge (`wysa_Margin`)	Summe der Deckungsbeiträge der Positionen

Weil die Berechnung serverseitig läuft, stimmen die Summen auch dann, wenn Positionen über die Übertragung aus Business Central entstehen — nicht nur bei manueller Erfassung.

Voraussichtlicher Umsatz und voraussichtliche Marge

An der Verkaufschance gibt es zwei berechenbare Kennzahlen, die getrennt voneinander konfiguriert werden:

Abschluss von Angebot und Verkaufschance

Mon, 01 Jan 0001 00:00:00 +0000

Gewinnen: Business Central gibt das Signal

Ein Angebot gilt als gewonnen, wenn es in Business Central in einen Auftrag überführt wurde. Diese Rückmeldung kommt über das Feld BC Status (wysa_BCStatus). Meldet Business Central den Wert TRANSFERRED, setzt die Lösung das Angebot in Customer Engagement automatisch auf Gewonnen.

Der Vertrieb muss den Abschluss also nicht doppelt pflegen — das führende System für den Auftrag ist Business Central, und Customer Engagement folgt.

Stammdaten und Anzeige

Mon, 01 Jan 0001 00:00:00 +0000

Firmenname aus Name 1 und Name 2

Business Central führt Firmennamen zweizeilig, in den Feldern Name und Name 2. Genau diese beiden Felder beschreibt die Schnittstelle in beide Richtungen — sie sind in Customer Engagement als Name 1 (BC) (wysa_bcName1) und Name 2 (BC) (wysa_bcName2) abgebildet. Der einzeilige Firmenname des CRM-Standards ist an der Übertragung nicht beteiligt.

Damit er trotzdem stimmt, setzt ihn die Serverlogik zusammen: Name 1, ein Leerzeichen, Name 2 — führende und nachfolgende Leerzeichen werden entfernt, ist nur eines der beiden Felder gefüllt, steht auch nur dieses im Namen. Die Berechnung läuft, sobald eines der beiden Quellfelder angelegt oder geändert wird.

Konfiguration

Mon, 01 Jan 0001 00:00:00 +0000

Diese Seite richtet sich an die IT-Administration. Die Werte werden je Umgebung gepflegt und wirken sofort — eine Anpassung der Lösung ist dafür nicht nötig.

Umgebungsvariablen

Umgebungsvariablen werden in der Power Platform verwaltet und unterscheiden sich typischerweise zwischen Test- und Produktivumgebung.

Verbindung zu Business Central

Variable	Bedeutung
`wysa_BcBaseUrl`	Basisadresse der Business-Central-Umgebung
`wysa_BcTenantId`	Verzeichnis (Tenant), in dem Business Central betrieben wird
`wysa_BcClientId`	Anwendungskennung der registrierten Anwendung
`wysa_BcClientSecret`	Geheimnis der registrierten Anwendung

Sicherheitshinweis

wysa_BcClientSecret enthält ein Zugangsgeheimnis. Es gehört in einen Azure Key Vault und sollte dort referenziert werden, statt den Wert direkt in der Umgebungsvariablen zu hinterlegen. Bei Ablauf des Geheimnisses bricht die Übertragung ab — eine Erneuerungserinnerung ist empfehlenswert.

Berechtigungen

Mon, 01 Jan 0001 00:00:00 +0000

Diese Seite richtet sich an die IT-Administration. Die Rollen werden in der Power Platform zugewiesen.

Drei Rollen, ein Prinzip

dsyr.SalesCentral liefert drei Sicherheitsrollen mit. Zwei davon sind Ergänzungsrollen, eine ist für ein technisches Konto gedacht.

Die Rollen tragen noch den historischen Produktnamen SalesConnect — das ist dieselbe Lösung wie dsyr.SalesCentral, nur die Rollennamen wurden bei der Umbenennung nicht mitgezogen.

Rolle	Für wen	Charakter
SalesConnect Reader	Anwender, die mit den Daten arbeiten, sie aber nicht pflegen	Ergänzungsrolle, überwiegend lesend
SalesConnect Admin	Key-User und Administratoren, die die Stammdaten der Lösung pflegen	Ergänzungsrolle, schreibend
SalesConnect DataBridge	Das Dienstkonto der Datenübertragung	Eigenständige Rolle für die Schnittstelle

Wichtig: Ergänzungsrollen ersetzen keine Sales-Rolle

SalesConnect Reader und SalesConnect Admin enthalten bewusst keine Rechte auf die Standardtabellen Firma, Kontakt, Lead, Verkaufschance und Angebot. Sie regeln ausschließlich die Tabellen dieser Lösung.

Ein Anwender benötigt deshalb zusätzlich eine Standardrolle von Dynamics 365 Sales (etwa „Vertriebsmitarbeiter" oder „Vertriebsleiter"). Wird nur eine SalesConnect-Rolle zugewiesen, kann der Anwender die App zwar öffnen, sieht aber keine Verkaufschancen und keine Firmen.

Der Zuschnitt ist Absicht: Wie weit die Sichtbarkeit auf Firmen und Verkaufschancen reicht — eigene Datensätze, Geschäftseinheit oder organisationsweit — entscheidet jede Organisation über ihre Standardrollen. Die Lösung greift dieser Entscheidung nicht vor.

Meldungen

Mon, 01 Jan 0001 00:00:00 +0000

Die Regeln der Lösung laufen synchron: Wird eine Regel verletzt, bricht der Speichervorgang mit einer Meldung ab. Die folgende Übersicht erklärt, was dahintersteht.

Meldungen bei der Freigabe nach Business Central

„Die Änderung kann nicht durchgeführt werden, da die neue Firma noch nicht nach BC übertragen wurde."

Ursache — Ein für die Übertragung freigegebener Kontakt soll einer Firma zugeordnet werden, die in Business Central noch nicht existiert.

Lösung — Zunächst die Firma freigeben und die Übertragung abwarten. Sie ist abgeschlossen, sobald an der Firma die BC-Nummer gefüllt ist. Danach lässt sich der Kontakt umhängen. Alternativ die Freigabe des Kontakts vorübergehend zurücknehmen.