Konfiguration

Umgebungsvariablen und Einstellungen, mit denen sich das Verhalten je Umgebung steuern lässt.

Themen:

Konfiguration

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.

Verhalten

Variable	Wirkung
`wysa_AutomaticContactSyncBC`	Steuert, ob Kontakte automatisch mit ihrer Firma für die Übertragung freigegeben werden. Ist sie deaktiviert, entscheidet der Anwender je Kontakt. Siehe Freigabe nach BC.
`wysa_SyncAccountOwnerWithSalesPerson`	Steuert, ob der Besitzer von Firma, Verkaufschance und Angebot mit dem zugeordneten BC-Verkäufer abgeglichen wird.

Einstellungen

Einstellungen (Settings) sind feiner steuerbar als Umgebungsvariablen: Sie können organisationsweit und abweichend je Anwendung gesetzt werden.

Einstellung	Standardwert	Wirkung
`wysa_DefaultLanguageGUID`	`0`	Sprache, die neuen Kontakten und Leads vorbelegt wird. Erwartet die Kennung (GUID) eines Sprachdatensatzes; `0` schaltet die Vorbelegung ab.
`wysa_EstimatedRevenueSource`	`UserProvided`	Quelle des voraussichtlichen Umsatzes einer Verkaufschance.
`wysa_EstimatedMarginSource`	`UserProvided;OpportunityproductProvided`	Quelle der voraussichtlichen Marge einer Verkaufschance.
`wysa_WinQuoteAndOpportunity`	`false`	Legt fest, ob mit dem Gewinnen eines Angebots auch die verknüpfte Verkaufschance gewonnen wird. Siehe Abschluss.

Quellen für Umsatz und Marge

wysa_EstimatedRevenueSource und wysa_EstimatedMarginSource sind unabhängig voneinander und erwarten dieselbe Schreibweise: eine mit Semikolon getrennte Liste erlaubter Quellen, von der niedrigsten zur höchsten Priorität.

Wert	Bedeutung
`UserProvided`	Nur manuelle Erfassung
`UserProvided;OpportunityproductProvided`	Zusätzlich Berechnung aus den Verkaufschancenprodukten
`UserProvided;OpportunityproductProvided;QuoteProvided`	Zusätzlich Vorrang für das führende Angebot

Ausgeliefert wird der Umsatz als reine Vertriebsschätzung (UserProvided), die Marge berechnet aus den Positionen. Details unter Beträge und Margen.

Kennung der Standardsprache ermitteln

wysa_DefaultLanguageGUID erwartet die GUID eines Sprachdatensatzes. Sie lässt sich ablesen, indem der gewünschte Eintrag — etwa „Deutsch" — in der Sprachtabelle geöffnet und die GUID aus der Adresszeile des Browsers übernommen wird.

Vorrangregel

Für jede Einstellung gilt dieselbe Rangfolge — der zuletzt genannte Wert gewinnt:

Standardwert  <  organisationsweite Einstellung  <  Einstellung je Anwendung

Damit lässt sich ein organisationsweites Verhalten festlegen und für einzelne Anwendungen gezielt abweichend definieren. Genutzt wird das etwa bei der Standardsprache: Ein international arbeitendes Team erhält eine andere Vorbelegung als ein rein deutschsprachiges.

Die Rangfolge gilt gleichermaßen für die Serverlogik und für die Formularlogik — beide lesen die Einstellungen auf demselben Weg. Ein Wert, der im Formular wirkt, wirkt auch serverseitig.

Falscher Wert bei der Standardsprache

wysa_DefaultLanguageGUID akzeptiert ausschließlich eine gültige Kennung oder 0. Ein anderer Wert führt beim Anlegen von Kontakten und Leads zu einem Abbruch mit Meldung — siehe Meldungen.