# Konfiguration

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

---

LLMS index: [llms.txt](/llms.txt)

---

<div class="pageinfo pageinfo-primary">

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.

</div>


## 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](../sync-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](../abschluss-angebot-chance/). |

### 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](../betraege-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](../meldungen/).