Umgebungsvariablen

Abgeschlossen

Wenn Sie Power Automate-Cloud-Flows erstellen, ist es üblich, Werte zu haben, die Sie in den Flow-Schritten angeben, die spezifisch für eine Umgebung sind, in der der Flow implementiert wird. Flow-Aktionen können sich zum Beispiel auf den Dokumentnamen, die URL eines externen Dienstes oder die E-Mail-Adresse für Benachrichtigungen beziehen, die je nach Umgebung variieren können, wie Entwicklung, Test und Produktion.

Umgebungsvariablen ermöglichen eine getrennte Definition und Einrichtung dieser Werte aus der Cloud-Flow-Definition. Die Umgebungsvariable kann dann in jeder Umgebung, in der der Cloud-Flow bereitgestellt wird, einen anderen Wert haben. Andere Microsoft Power Platform-Ressourcen, wie z. B. Power Apps oder benutzerdefinierte Konnektoren, können auch Umgebungsvariablen verwenden. Nachdem die Umgebungsvariablenwerte festgelegt wurden, können Cloud-Flows hartcodierte Inhalte durch Umgebungsvariablenwerte ersetzen, ähnlich wie andere dynamische Inhalte verwendet werden.

Umgebungsvariablen bestehen aus zwei Teilen: Definition und aktueller Wert. Die Definition legt den Datentyp einer Variablen fest und kann einen Standardwert enthalten. Der zweite Teil ist ein aktueller Wert, der optional in jeder Umgebung zum Überschreiben des Standardwerts bereitgestellt werden kann. Wenn eine Lösung, die die Definition einer Umgebungsvariablen enthält, in eine andere Umgebung importiert wird und noch kein aktueller Wert festgelegt wurde, fordert der Import zur Eingabe des Werts auf.

Wählen Sie + Neu > Mehr > Umgebungsvariable aus, um Umgebungsvariablen in einer Lösung zu erstellen. Die folgende Abbildung zeigt ein Beispiel für die Erstellung einer Variable Error Notification Email.

Screenshot des Erstellens einer neuen Umgebungsvariable

Denken Sie beim Ausfüllen der Felder Anzeigename und Name daran, dass der Name den Zweck verdeutlichen und eindeutig sein sollte. Wenn Sie die Beispielvariable zum Beispiel E-Mail nennen, wäre dies zu allgemein. Sie können den Anzeigename ändern, der von Benutzern nach der Erstellung angezeigt wird. Der Name, der intern und beim programmgesteuerten Zugriff auf die Variable verwendet wird, kann nicht geändert werden, um zu verhindern, dass etwas beschädigt wird, das den Variablenwert verwendet. Der Datentyp legt fest, welche Art von Werten gespeichert werden können und kann auch nach der Erstellung nicht mehr verändert werden. Datentypen von Datenquelle und Geheimnis sind eindeutig und werden später in diesem Modul beschrieben.

Nachdem Sie sich für einen Datentyp entschieden haben, können Sie einen Standardwert festlegen. Ein Standardwert ist nicht erforderlich, es ist jedoch hilfreich, einen zu haben. Wenn Sie zum Beispiel eine Variable Expiration Days haben, können Sie sie standardmäßig auf 28 Tage setzen, aber sie könnte in jeder Umgebung durch einen aktuellen Wert überschrieben werden. Der folgende Screenshot zeigt den Prozess zum Bereitstellen eines Standardwerts für die Variable.

Screenshot des Standardwerts für eine Umgebungsvariable

Sie können für die Umgebung auch einen aktuellen Wert angeben. Zum Beispiel könnte in der Entwicklung der DevTeam-Alias verwendet werden.

Screenshot des aktuellen Werts für eine Umgebungsvariable

Wenn Sie einen aktuellen Wert festlegen, stellen Sie sicher, dass Sie die Variable nach dem Erstellen erneut zur Bearbeitung öffnen und dann den aktuellen Wert aus der Lösung entfernen. Wenn Sie diese Aktion nicht abschließen, wird die Komponente Aktueller Wert der Entwicklungsumgebung in die Exporte der Lösung aufgenommen. Als Ergebnis wird die Entwicklungsumgebung Aktueller Wert in anderen Umgebungen wie Test und Produktion verwendet. Wählen Sie Aus dieser Lösung entfernen aus, um sie aus der Lösung zu entfernen, aber nur für die Entwicklungsumgebung eingerichtet zu lassen.

Screenshot des Entfernens des aktuellen Werts aus einer Lösung

Datenquelle-Umgebungsvariablen

Der Datentyp von Datenquelle dient zum Speichern der Konfiguration, wie eine Verbindung auf eine bestimmte Datenquelle verwiesen wird. Nach der Auswahl von Datenquelle als Datentyp müssen Sie einen Konnektor auswählen, der für diesen Konfigurationstyp unterstützt wird. Derzeit wird nur SharePoint unterstützt. Wenn beispielsweise SharePoint ausgewählt ist, müssen Sie einen Parametertyp von Site oder List auswählen. Sie müssen eine Datenquellen-Umgebungsvariable Site einrichten, bevor Sie eine Umgebungsvariable List einrichten können. Der folgende Screenshot zeigt ein Beispiel für die Erstellung einer Datenquellenvariable Site.

Screenshot des Einrichtens einer Datenquellen-Umgebungsvariable

Geheime Umgebungsvariablen

Der Datentyp Geheimnis dient zum Referenzieren von Geheimnissen, die im Microsoft Azure Key Vault gespeichert sind. Dieser Variablentyp benötigt eine andere Einrichtung. Weitere Informationen finden Sie unter Azure Key Vault-Geheimschlüssel verwenden. Geheime Umgebungsvariablen tragen dazu bei, zu verhindern, dass vertrauliche Informationen versehentlich Benutzern oder im Ausführungsverlauf des Flows offengelegt werden.

Umgebungsvariablen verwenden

In Ihrem Lösungs-Cloud-Flow können Sie hartcodierte Werte ersetzen, indem Sie auf die Umgebungsvariablen verweisen. Nachdem Sie Variablen in einer Umgebung festgelegt haben, können die verfügbaren Umgebungsvariablen aus dem Feld Dynamische Inhalte ausgewählt werden. Der folgende Screenshot zeigt ein Beispiel für die Verwendung der Variable Error Notification Email, die Sie zuvor festgelegt haben.

Screenshot von einer Umgebungsvariablen in einem Aktionsschritt zum Ersetzen eines hartcodierten Werts

Sie können den Wert auch mit dem Parameterausdruck abrufen. Zum Beispiel würde parameters('contoso_ErrorNotificationEmail') den gleichen Wert abrufen.