Upload File

UiPath.Box.Activities.File.UploadFile

Die Aktivität Datei hochladen verwendet die Box Datei-Upload- API , um eine Datei (Dateipfad) in einen angegebenen Ordner (IDdes übergeordneten Ordners ) unter dem vorhandenen oder neuen Dateinamen (Dateiname) hochzuladen.

Nach dem Verschieben der Datei gibt die Aktivität ein BoxFile -Objekt (BoxFile) aus, das die Eigenschaften der kopierten Datei und den der Datei zugewiesenen String -Bezeichner (Datei-ID ) enthält, die Sie beide in nachfolgenden Aktivitäten verwenden können (z. B. Datei verschieben).

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie die Aktivität Box Scope zu Ihrem Projekt hinzu.
3. Fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der einen File.Id -Wert ausgibt (z. B. Upload File, Search for Contentusw.).
4. Fügen Sie die Aktivität Datei hochladen innerhalb der Aktivität Box Scope hinzu.
5. Geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen und geben Sie die Variablen String und BoxFile für die Ausgabeeigenschaft ein.
   • Ihre Eingabeeigenschaftswerte werden in der API-Vorgangsanforderung Datei hochladen gesendet.
   • Die Operation gibt die Werte String und BoxFile an Ihre Ausgabeeigenschaftsvariablen zurück.
     
     

     

     
     

Eigenschaften

Allgemein

• ContinueOnError – Gibt an, ob die Aktivität weiter ausgeführt werden soll, wenn ein Fehler ausgegeben wird. Dieses Feld unterstützt nur Boolean -Werte.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings- oder String-Variablen.

Eingabe

• Dateipfad – Der Speicherort der Datei, die Sie hochladen möchten. Dieses Feld unterstützt nur Strings - oder String -Variablen.
• ID des übergeordnetenOrdners – Die ID des übergeordneten Ordners, in den Sie die Datei hochladen möchten. Dieses Feld unterstützt nur Strings - oder String -Variablen.
  • Geben Sie den Wert „0“ ein, um den Stammordner der Anwendung zu verwenden.
  • Um die ID eines Ordners abzurufen, der kein Stammordner ist, verwenden Sie die Aktivität Search for Content .

Sonstiges

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

Optionen

• Dateiname – Der Name, den Sie auf die Datei anwenden möchten. Dieses Feld unterstützt nur Strings - oder String -Variablen. Wenn diese Eigenschaft leer bleibt, wird der vorhandene Dateiname angewendet.

• Upload-Modus – Der Modus, den Sie zum Hochladen Ihrer Datei verwenden möchten. Wählen Sie eine der drei Optionen aus der Dropdownliste aus:

  • Auto – Die Aktivität überprüft die Größe der Datei. Wenn die Datei größer als 50 MB ist, wird der Upload in Blöcken verwendet. Wenn die Datei weniger als 50 MB groß ist, wird der direkte Upload (einzeln) verwendet.
  • Einzeln – Die Aktivität lädt die gesamte Datei unabhängig von der Größe hoch. Wenn die Datei 50 MB überschreitet, wird ein Fehler ausgegeben.

  • Aufgeteilt (Chunked) – Die Aktivität lädt die Datei mithilfe des aufgeteilten Uploads hoch. Verwenden Sie diese Option nur, wenn Ihre Datei größer als 20 MB ist.

    Hinweis: Weitere Informationen zu den Upload-Typen finden Sie unter Aufgeteilte Uploads und direkte Uploads in der Box-Dokumentation.

Ausgabe

• Box-Datei - Das Box File -Objekt, das die Dateieigenschaften enthält. Geben Sie eine Box File -Variable ein. Das Box File -Objekt enthält mehrere Eigenschaften , die Sie in anderen Aktivitäten verwenden können.
• Datei-ID - Der Bezeichner, der dem BoxFile -Objekt zugewiesen ist. Dieses Feld unterstützt nur Strings - oder String -Variablen.