Umgebungsordner erhalten (Get Environment Folder)

UiPath.Core.Activities.GetEnvironmentFolder

Verwenden Sie diese Aktivität, um den Pfad zu speziellen Systemordnern (z. B. Desktop, Documents, AppData usw.) mithilfe der Aufzählung Environment.SpezialOrdner von .NET abzurufen. Das Verständnis des plattformspezifischen Verhaltens ist für die Erstellung zuverlässiger plattformübergreifender Automatisierungsworkflows unerlässlich.

Hinweis:

Die Aufzählung Spezialordner ist plattformübergreifend konsistent, aber die tatsächlichen Ordnerzuordnungen und die Verfügbarkeit unterscheiden sich erheblich zwischen Windows- und plattformübergreifenden Umgebungen. Viele Windows-spezifische Ordner geben unter Linux/ macOS eine leere Zeichenfolge zurück.

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• SonderOrdner - Der Ordner vom Typ SonderOrdner, dessen Pfad extrahiert werden soll. Wählen Sie aus den verfügbaren Environment.SpecialFolder -Aufzählungswerten aus.

Ausgabe

• OrdnerPfad - Der vollständige Pfad des ausgewählten Ordners vom Typ SonderOrdner. Gibt eine leere Zeichenfolge zurück, wenn der Ordner auf der aktuellen Plattform nicht verfügbar ist.

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:

• Alle Standard-Spezialordner werden zu ihren erwarteten Windows-Pfaden aufgelöst (z. B. Desktop, ProgramFiles, System, ApplicationData).
• Nur Windows-Ordner wie ProgramFiles, ProgramFilesX86, Windows, AdminTools und CommonProgramFiles geben gültige Pfade zurück.
• Ordner werden in der Regel zu Speicherorten unter C:\Users\<username> oder Systemverzeichnisse wie C:\Windows aufgelöst.

Plattformübergreifende Umgebung

Bei der Ausführung unter Linux oder macOS:

• Nur eine Teilmenge spezieller Ordner wird in gültige Pfade aufgelöst; viele Windows-spezifische Ordner geben eine leere Zeichenfolge zurück.
• Ordnerpfade folgen den XDG Base Directory-Spezifikationen unter Linux (mit Umgebungsvariablen wie $XDG_CONFIG_HOME, $XDG_DATA_HOME) und macOS-Konventionen.
• Die Aktivität erstellt nie Verzeichnisse; es löst nur bekannte Speicherorte basierend auf dem Betriebssystem auf.
• Wenn ein Ordner auf der aktuellen Plattform nicht aufgelöst werden kann, gibt die Aktivität eine leere Zeichenfolge (nicht null) zurück und löst keine Ausnahme aus.

Allgemeine Ordnerzuordnungen

Plattformübergreifende Ordner

Diese Ordner werden in der Regel sowohl in Windows- als auch in plattformübergreifenden Umgebungen aufgelöst:

• Benutzerprofil – Windows: C:\Users\<user>, Linux/maOS: $HOME
• Desktop – Windows: C:\Users\<user>\Desktop, Linux/maOS: ~/Desktop (wenn vorhanden)
• MyDocuments – Windows: C:\Users\<user>\Documents, Linux/maOS: ~/Documents (falls vorhanden)
• Anwendungsdaten – Windows: %APPDATA% (Roaming), Linux/ macOS: ~/.config (XDG)
• LocalApplicationData – Windows: %LOCALAPPDATA%, Linux/maOS: ~/.local/share (XDG)

Nur Windows-Ordner

Diese Ordner geben unter Windows gültige Pfade zurück, unter Linux/MacOS jedoch in der Regel eine leere Zeichenfolge:

• ProgramFiles, ProgramFilesX86 - Windows-Programminstallationsverzeichnisse
• System, SystemX86, Windows – Windows-Systemverzeichnisse
• CommonApplicationData – Windows: %PROGRAMDATA%, Linux/maOS: leere Zeichenfolge
• CommonProgramFiles, CommonProgramFilesX86 - Gemeinsame Programmdateien
• AdminTools, Vorlagen, Favoriten, Zuletzt verwendet, Senden an, StartMenü, Startup – Windows-Shell-Ordner

Plattformspezifische Überlegungen

• Schriftarten – Windows: %WINDIR%\Fonts, macOS: /System/Library/Fonts (System) oder /Library/Fonts (Benutzer), Linux: variiert je nach Verteilung, gibt häufig einen leeren String zurück
• Desktop, MyDocuments – Kann eine leere Zeichenfolge zurückgeben, wenn das Verzeichnis im Benutzerprofil nicht vorhanden ist, auch auf Plattformen, auf denen sie erwartet werden

Best Practices

• Ergebnis immer validieren: Prüfen Sie auf string.IsNullOrEmpty(folderPath) bevor Sie den zurückgegebenen Pfad verwenden, da viele Ordner auf bestimmten Plattformen möglicherweise nicht vorhanden sind.
• Für plattformübergreifende Workflows: Bevorzugen Sie die Verwendung UserProfile, ApplicationData oder LocalApplicationData zum Speichern von Anwendungsdaten, da diese plattformübergreifend konsistente Zuordnungen aufweisen.
• Nur Windows-Ordner vermeiden: Verlassen Sie sich nicht auf Ordner wie ProgramFiles, System oder Windows in plattformübergreifenden Workflows, da diese unter Linux/ macOS leere Zeichenfolgen zurückgeben.
• Fehlende Verzeichnisse behandeln: Die Aktivität erstellt keine Verzeichnisse. Wenn Sie in einen speziellen Ordner schreiben müssen, überprüfen Sie, ob er vorhanden ist, und erstellen Sie ihn ggf.
• Auf Zielplattformen testen: Die Verfügbarkeit von Ordnern kann je nach Benutzerprofilkonfiguration variieren, insbesondere bei Ordnern, die abhängig von der Anwesenheit sind, wie Desktop und Dokumente.
• Containerisierte Umgebungen: Beachten Sie, dass containerisierte oder eingeschränkte Umgebungen aufgrund fehlender oder nicht zugänglicher Pfade leere Zeichenfolgen für weitere Ordner zurückgeben können.

Rückgabewert

• Gibt den vollständigen Ordnerpfad als Zeichenfolge zurück, wenn der spezielle Ordner auf der aktuellen Plattform verfügbar ist.
• Gibt eine leere Zeichenfolge (string.Empty) zurück, wenn der Ordner auf der aktuellen Plattform nicht aufgelöst werden kann.
• Gibt nie null zurück und löst keine Ausnahmen für nicht unterstützte Ordner aus.

Beispielszenarien

Szenario 1: Abrufen des Benutzerprofils

• Windows: Gibt C:\Users\<username>zurück
• Linux/maOS: Gibt /home/<username> oder /Users/<username>zurück.

Szenario 2: Abrufen von ProgramFiles

• Windows: Gibt C:\Program Fileszurück
• Linux/maOS: Gibt leere Zeichenfolge zurück

Szenario 3: Abrufen von ApplicationData

• Windows: Gibt C:\Users\<username>\AppData\Roamingzurück
• Linux/maOS: Gibt ~/.config zurück (XDG-Spezifikation)

Szenario 4: Abrufen des Desktops, wenn der Ordner nicht vorhanden ist

• Alle Plattformen: Gibt eine leere Zeichenfolge zurück, wenn der Desktop-Ordner im Benutzerprofil nicht vorhanden ist