Speicherdatei hochladen

Diese Aktivität „Upload Storage File“, die eine Datei in einen angegebenen Speicher-Bucket in Orchestrator hochlädt.

UiPath.Core.Activities.Storage.UploadStorageFile

Beschreibung

Lädt eine Datei in einen angegebenen Speicher-Bucket im Orchestrator hoch.

Hinweis:

Orchestrator-Berechtigungen

Diese Aktivität läuft unter dem Orchestrator-Konto des Roboters, der sie ausführt. Sie muss über folgende Orchestrator-Rollenberechtigungen für den Zielordner verfügen:

• Storage Buckets.View: Wird verwendet, um den Speicher-Bucket aufzulösen
• Storage Files.Create: Wird zum Hochladen oder Schreiben von Dateien in den Bucket verwendet
• Folders.View: Zum Durchsuchen und Auswählen des Orchestrator-Ordners

In Windows- und plattformübergreifenden Projekten mit System 26.10.0 oder höher speichert die Aktivität die hochgeladene Datei mit ihrem Inhaltstyp (MIME-Typ). Der Inhaltstyp wird aus der Erweiterung des hochgeladenen Dateinamens, dann aus dem Typ, den die Dateiressource meldet, und dann aus der Erweiterung der lokalen Datei entnommen.

Die folgenden Buckets behalten den Inhaltstyp nicht bei, da Orchestrator ihn verwirft:

• Lokale Dateisystem-Buckets
• Lokale verschlüsselte Buckets
• MinIO-Buckets

Projektkompatibilität

Windows – Legacy | Windows | Plattformübergreifend

Plattformübergreifende Konfiguration

• Orchestrator-Ordnerpfad– Der Pfad zum Orchestrator-Ordner, den Sie mit dieser Aktivität verwenden möchten. Wenn dies leer gelassen wird, wird der aktuelle Orchestrator-Ordner verwendet. Dieses Feld unterstützt nur Zeichenfolgen und String -Variablen. Verwenden Sie / als Trennzeichen für Unterordner, um den gewünschten Ordner anzugeben.
• Name des Speicher-Buckets– Der Name des Speicher-Buckets, in den Sie die Datei hochladen möchten. Dieses Feld ist ein Pflichtfeld. Dieses Feld unterstützt nur Strings und String-Variablen.
• Datei– Der vollständige Pfad der Datei, die Sie in den genannten Speicher-Bucket hochladen möchten. Sie können den Umschalter zwischen der Verwendung eines lokalen Pfads oder einer Variablen des Typs IResource verwenden. Wenn Sie einen lokalen Pfad verwenden, werden relative Ordnerpfade empfohlen, um die unterschiedliche Dateistruktur zwischen Windows- und Linux-Maschinen beim Ausführen eines Projekts zu berücksichtigen. Beispiel: newFolder/newFileName.txt.
• Zielpfad– Der Pfad im Speicher-Bucket, in den die Datei hochgeladen wird, einschließlich des Dateinamens. Ein Wert, der mit / endet, wird als Ordner verwendet, sowie jeder Wert, wenn der Name der hochgeladenen Datei festgelegt ist und der Dateiname dann aus dem Namen der hochgeladenen Datei oder aus der Quelldatei stammt. Ein leerer Wert lädt die Datei in das Stammverzeichnis des Buckets hoch.
• Name der hochgeladenen Datei– Der Name der Datei im Speicher-Bucket. Wenn diese Option festgelegt ist, wird sie an den Zielpfad angehängt, der dann als Ordner verwendet wird. Wenn leer gelassen, stammt der Name aus dem Zielpfad oder, wenn es sich um einen Ordner handelt oder leer ist, aus der Quelldatei.

Hinweis:

Im Designer bietet der Zielpfad eine durchsuchbare Liste der Bucket-Ordner mit Einträgen, die auf / enden, z. B. archive/, und aktualisiert sie, wenn sich der Orchestrator-Ordner oder der Bucket ändert. Sie können weiterhin einen Wert oder einen Ausdruck eingeben. In Studio Web Lösungen ist das Feld ein Nur-Text ohne Liste.

¹Für plattformübergreifende Projekte, die in Studio Web als Teil einer Lösung erstellt wurden, ist das Feld Orchestrator-Ordnerpfad nicht verfügbar. Wenn die Aktivität einen Ordnerpfad hatte, bevor sie Teil der Lösung wurde, wird das Feld schreibgeschützt angezeigt und dieser Ordner überschreibt die Lösungsressource. Wenn Sie die Ressource erneut auswählen, wird der Ordner entfernt.

²Für plattformübergreifende Projekte, die in Studio Web als Teil einer Lösung erstellt wurden, bietet das Namensfeld Optionen zum Definieren neuer Orchestrator-Ressourcen, wie z. B. Warteschlangen, Assets oder Speicher-Buckets, während der Entwurfszeit oder zum Öffnen des Orchestrators für die Ressourcenverwaltung.

Erweiterte Optionen

Sonstige

• Timeout (Millisekunden)– Gibt an, wie lange (in Millisekunden) darauf gewartet wird, dass der Orchestrator antwortet oder die Dateiübertragung voranschreitet, bevor ein Fehler ausgegeben wird. Es ist nicht die gesamte Übertragungszeit begrenzt, sodass große Dateien über langsame Verbindungen trotzdem abgeschlossen werden. Der Standardwert ist 300.000 Millisekunden (5 Minuten). Das Öffnen einer Verbindung ist immer auf 30 Sekunden begrenzt.

  Hinweis:

  Bei einer Zeitüberschreitung schlägt die Aktivität mit einem TimeoutException mit dem Fehlercode Orchestrator_Sys_Timeout fehl, sodass „Bei Fehler fortfahren“ und „Scope wiederholen“ wie für jeden anderen Fehler gelten. Ein Wert von 0 oder eine negative Zahl wird durch 30 Sekunden ersetzt und das Abbrechen des Auftrags wird als Abbruch und nicht als Timeout gemeldet.

  Wenn der Orchestrator den Dateiinhalt selbst bereitstellt, anstatt eine Anbieter-URL auszugeben, was beim vom Orchestrator verwalteten Speicher mit aktivierter Features.Buckets.StorageOffloadRequiresAuth -Funktion der Fall ist, muss der Upload auch insgesamt innerhalb dieses Werts abgeschlossen werden.

• Bei Fehler fortfahren– Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.

  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft ContinueOnError auf Wahr True gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

Windows – Legacy, Windows-Konfiguration

• Zielpfad– Nur Windows-Projekte. Der Pfad im Speicher-Bucket, in den die Datei hochgeladen wird, einschließlich des Dateinamens. Ein Wert, der mit / endet, wird als Ordner verwendet, sowie jeder Wert, wenn der Name der hochgeladenen Datei festgelegt ist und der Dateiname dann aus dem Namen der hochgeladenen Datei oder aus der Quelldatei stammt. Ein leerer Wert lädt die Datei in das Stammverzeichnis des Buckets hoch. Dieses Feld unterstützt nur Strings und String -Variablen.
• Name der hochgeladenen Datei– Nur Windows-Projekte. Der Name der Datei im Speicher-Bucket. Wenn diese Option festgelegt ist, wird sie an den Zielpfad angehängt, der dann als Ordner verwendet wird. Wenn leer gelassen, stammt der Name aus dem Zielpfad oder, wenn es sich um einen Ordner handelt oder leer ist, aus der Quelldatei. Wenn die Zieldatei bereits vorhanden ist, wird sie überschrieben.
• Ziel– Nur Windows – Legacy-Projekte. Der Pfad, unter dem Sie die Datei im Speicher-Bucket hochladen möchten. Das Verzeichnistrennzeichen ist \. Wenn die Zieldatei bereits vorhanden ist, wird sie überschrieben. Dieses Feld unterstützt nur Strings und String -Variablen.
• Datei– Der vollständige Pfad der Datei, die Sie in den Speicher-Bucket hochladen möchten, der im Feld Name des Speicher-Buckets angegeben ist. Dieses Feld unterstützt Variablen des Typs IResource . Verwenden Sie dieses Feld, wenn die Datei während der Ausführung dynamisch abgerufen wird, z. B. ein Anhang aus einer E-Mail.
• Pfad – Der vollständige lokale Pfad zu der Datei, die Sie in den angegebenen Speicher-Bucket hochladen möchten. Relative Pfade werden basierend auf dem Laufzeitausführungsverzeichnis aufgelöst. Dieses Feld unterstützt nur Strings und String-Variablen. Verwenden Sie dieses Feld, wenn sich die Datei im Projektordner befindet.
• Name des Speicher-Buckets– Der Name des Speicher-Buckets, in den Sie die Datei hochladen möchten. Dieses Feld ist ein Pflichtfeld. Dieses Feld unterstützt nur Strings und String-Variablen.
  Wichtig:

  Sie müssen eines dieser Felder verwenden, da sie sich gegenseitig ausschließen. Wenn Sie einen lokalen Pfad angeben, verwenden Sie immer relative Ordnerpfade, um die Kompatibilität zwischen verschiedenen Dateistrukturen auf Windows- und Linux-Systemen zu gewährleisten. Zum Beispiel: newFolder/newFileName.txt.

Eigenschaften-Panel

Allgemein

• Bei Fehler fortfahren– Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.

  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft ContinueOnError auf Wahr True gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• DisplayName – Der Anzeigename der Aktivität.

• Timeout (Millisekunden)– Gibt an, wie lange (in Millisekunden) darauf gewartet wird, dass der Orchestrator antwortet oder die Dateiübertragung voranschreitet, bevor ein Fehler ausgegeben wird. Es ist nicht die gesamte Übertragungszeit begrenzt, sodass große Dateien über langsame Verbindungen trotzdem abgeschlossen werden. Der Standardwert ist 300.000 Millisekunden (5 Minuten). Das Öffnen einer Verbindung ist immer auf 30 Sekunden begrenzt.

  Hinweis:

  Bei einer Zeitüberschreitung schlägt die Aktivität mit einem TimeoutException mit dem Fehlercode Orchestrator_Sys_Timeout fehl, sodass „Bei Fehler fortfahren“ und „Scope wiederholen“ wie für jeden anderen Fehler gelten. Ein Wert von 0 oder eine negative Zahl wird durch 30 Sekunden ersetzt und das Abbrechen des Auftrags wird als Abbruch und nicht als Timeout gemeldet.

  Wenn der Orchestrator den Dateiinhalt selbst bereitstellt, anstatt eine Anbieter-URL auszugeben, was beim vom Orchestrator verwalteten Speicher mit aktivierter Features.Buckets.StorageOffloadRequiresAuth -Funktion der Fall ist, muss der Upload auch insgesamt innerhalb dieses Werts abgeschlossen werden.

Von (From)

• Datei– Der vollständige Pfad der Datei, die Sie in den Speicher-Bucket hochladen möchten, der im Feld Name des Speicher-Buckets angegeben ist. Dieses Feld unterstützt Variablen des Typs IResource . Verwenden Sie dieses Feld, wenn die Datei während der Ausführung dynamisch abgerufen wird, z. B. ein Anhang aus einer E-Mail.
• Pfad – Der vollständige lokale Pfad zu der Datei, die Sie in den angegebenen Speicher-Bucket hochladen möchten. Relative Pfade werden basierend auf dem Laufzeitausführungsverzeichnis aufgelöst. Dieses Feld unterstützt nur Strings und String-Variablen. Verwenden Sie dieses Feld, wenn sich die Datei im Projektordner befindet.
  Wichtig:

  Sie müssen eines dieser Felder verwenden, da sie sich gegenseitig ausschließen. Wenn Sie einen lokalen Pfad angeben, verwenden Sie immer relative Ordnerpfade, um die Kompatibilität zwischen verschiedenen Dateistrukturen auf Windows- und Linux-Systemen zu gewährleisten. Zum Beispiel: newFolder/newFileName.txt.

Sonstiges

• Ordnerpfad– Der Pfad zum Orchestrator-Ordner, den Sie mit dieser Aktivität verwenden möchten. Wenn dies leer gelassen wird, wird der aktuelle Orchestrator-Ordner verwendet. Dieses Feld unterstützt nur Strings und String-Variablen. Verwenden Sie / als Trennzeichen für Unterordner, um den gewünschten Ordner anzugeben.
• Privat– Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe „Verbose“ protokolliert.

Speicher

• Zielpfad– Nur Windows-Projekte. Der Pfad im Speicher-Bucket, in den die Datei hochgeladen wird, einschließlich des Dateinamens. Ein Wert, der mit / endet, wird als Ordner verwendet, sowie jeder Wert, wenn der Name der hochgeladenen Datei festgelegt ist und der Dateiname dann aus dem Namen der hochgeladenen Datei oder aus der Quelldatei stammt. Ein leerer Wert lädt die Datei in das Stammverzeichnis des Buckets hoch. Dieses Feld unterstützt nur Strings und String -Variablen.
• Name der hochgeladenen Datei– Nur Windows-Projekte. Der Name der Datei im Speicher-Bucket. Wenn diese Option festgelegt ist, wird sie an den Zielpfad angehängt, der dann als Ordner verwendet wird. Wenn leer gelassen, stammt der Name aus dem Zielpfad oder, wenn es sich um einen Ordner handelt oder leer ist, aus der Quelldatei. Wenn die Zieldatei bereits vorhanden ist, wird sie überschrieben.
• Ziel– Nur Windows – Legacy-Projekte. Der Pfad, unter dem Sie die Datei im Speicher-Bucket hochladen möchten. Das Verzeichnistrennzeichen ist \. Wenn die Zieldatei bereits vorhanden ist, wird sie überschrieben. Dieses Feld unterstützt nur Strings und String -Variablen.
• Name des Speicher-Buckets– Der Name des Speicher-Buckets, in den Sie die Datei hochladen möchten. Dieses Feld ist ein Pflichtfeld. Dieses Feld unterstützt nur Strings und String-Variablen.