Umgebungsvariable erhalten (Get Environment Variable)

UiPath.Core.Activities.GetEnvironmentVariable

Verwenden Sie diese Aktivität, um den Wert einer Umgebungsvariablen abzurufen, indem Sie seinen Namen angeben. Das Verständnis des plattformspezifischen Abrufverhaltens ist für die Erstellung zuverlässiger plattformübergreifender Automatisierungsworkflows unerlässlich.

Hinweis:

Unter Windows ruft diese Aktivität Variablen von Benutzerumgebungsvariablen mit Fallback auf Prozessumgebungsvariablen ab . Bei plattformübergreifenden Projekten ruft sie nur Prozessumgebungsvariablen ab. Es ist wichtig zu verstehen, wie Umgebungsvariablen von Maschinen- und Benutzerebene in den Prozess-Scope geladen werden, um die Windows- und plattformübergreifenden Verhaltensunterschiede der Aktivitäten Get Environment Variable und Set Environment Variable zu verstehen.

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings oder String-Variablen.

Eingabe

• Variable (Variable) - Der Name der Umgebungsvariable, dessen Wert extrahiert werden soll. Dieses Feld unterstützt nur Strings oder String-Variablen.

Ausgabe

• VariablenWert (VariableValue) - Der Wert des ausgewählten Umgebungsvariable.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Plattformspezifisches Verhalten

Windows-Umgebung

Bei der Ausführung unter Windows (Standardkonfiguration):

• Die Aktivität versucht zunächst, die Variable von der Benutzerebene (EnvironmentVariableTarget.User) abzurufen.
• Wenn sie nicht auf Benutzerebene gefunden wird, wird auf die Umgebungsvariablen auf Prozessebene zurückgegriffen.
• Dieser Fallback-Mechanismus stellt sicher, dass sowohl benutzerspezifische als auch prozessspezifische Variablen zugänglich sind.
• Über System.Environment offengelegte Systemeigenschaften (z. B. MachineName, OSVersion, UserName) werden unabhängig vom Scope immer zuerst überprüft.

Plattformübergreifende Umgebung

Bei der Ausführung auf plattformübergreifenden Systemen (Linux, macOS):

• Die Aktivität ruft Variablen nur von der Prozessebene (EnvironmentVariableTarget.Process) ab.
• Dies umfasst Variablen, die vom übergeordneten Prozess geerbt wurden, und alle, die während der aktuellen Prozessausführung festgelegt wurden.
• Es wird kein Fallback-Mechanismus verwendet, da Variablen auf Benutzerebene Windows-spezifisch sind.
• Über System.Environment offengelegte Systemeigenschaften sind weiterhin priorisiert und zugänglich.

Abrufpriorität

Die Aktivität folgt dieser Abrufreihenfolge:

1. System.Umgebungseigenschaften (alle Plattformen)

• Überprüft zunächst, ob der angeforderte Variablenname mit einer integrierten .NET-Eigenschaft übereinstimmt (z. B. CurrentDirectory, MachineName, ProcessorCount).
• Bei Übereinstimmung wird der Eigenschaftswert direkt zurückgegeben.

2. Umgebungsvariablen

• Windows: Überprüft zuerst die Benutzerebene und greift dann auf Prozessebene zurück.
• Plattformübergreifend: Überprüft nur die Prozessebene.

Technische Details

Die Aktivität verwendet eine interne TargetFramework -Eigenschaft, um den Ausführungskontext zu bestimmen:

• "windows" : Verwendet EnvironmentVariableTarget.User mit Fallback auf Prozessebene.
• „portable“ : Verwendet nur EnvironmentVariableTarget.Process .

Dieses Verhalten wird automatisch von der UiPath-Laufzeit basierend auf der Ausführungsumgebung bestimmt und kann nicht manuell über die Aktivitätseigenschaften konfiguriert werden.

Verhaltensunterschiede

Persistenz von Variablen

• Windows: Kann persistente Variablen auf Benutzerebene abrufen, die über Windows-Systemeinstellungen oder die Aktivität Set Environment Variable festgelegt wurden.
• Plattformübergreifend: Ruft nur Variablen ab, die im aktuellen Prozess-Scope verfügbar sind (geerbt von Shell oder während der Ausführung festgelegt).

Variablenumfang

• Windows: Hat Zugriff auf einen größeren Variablenbereich (Benutzer + Prozess).
• Plattformübergreifend: Hat Zugriff auf einen kleineren Scope (nur Prozess).

Best Practices

• Bei Windows-Workflows können Sie sich für die Konfiguration auf Umgebungsvariablen auf Benutzerebene verlassen. Das automatische Fallback stellt sicher, dass Variablen auf Prozessebene weiterhin zugänglich sind.
• Verlassen Sie sich bei plattformübergreifenden Workflows nur auf Umgebungsvariablen, die an den Prozess übergeben oder während der Ausführung festgelegt wurden. Verlassen Sie sich nicht auf Variablen auf Benutzerebene, da diese nicht verfügbar sind. Erwägen Sie, die erforderliche Konfiguration über Prozessargumente oder Konfigurationsdateien zu übergeben.
• Bei portierbaren Workflows werden Workflows entworfen, die den Scope auf Prozessebene annehmen, nur um ein konsistentes Verhalten über alle Plattformen hinweg sicherzustellen. Testen Sie, ob beim Prozessstart alle erforderlichen Variablen verfügbar sind, und dokumentieren Sie alle Umgebungsvoraussetzungen eindeutig.
• Systemeigenschaften: Verwenden Sie lieber die integrierten System.Environment -Eigenschaften von .NET (z. B. MachineName, UserName), wenn verfügbar, da sie plattformübergreifend konsistent funktionieren.

Rückgabewert

• Gibt den Umgebungsvariablenwert als Zeichenfolge zurück.
• Gibt eine leere Zeichenfolge oder NULL zurück, wenn die Variable nicht gefunden wird (Verhalten kann je nach Plattform und .NET-Version variieren).
• Systemeigenschaftswerte werden mit .ToString() als Zeichenfolgen zurückgegeben.

Beispielszenarien

Szenario 1: Lesen der PATH-Variablen

• Windows: Erfolgreich vom Benutzer- oder Prozess-Scope abgerufen.
• Linux/maOS: Erfolgreich aus dem Prozess-Scope abgerufen.

Szenario 2: Lesen einer benutzerspezifischen benutzerdefinierten Variablen, die über Windows-Systemeigenschaften festgelegt wurde

• Windows: Ruft den Wert erfolgreich ab.
• Linux/maOS: Gibt leer/null zurück (Variablen auf Benutzerebene sind nicht vorhanden).

Szenario 3: Lesen von MachineName

• Alle Plattformen: Wird erfolgreich von der Eigenschaft System.Environment.MachineName abgerufen.