Dateiuploadprogramm

UiPath Apps unterstützen jetzt das IResource- Format für die Dateiverarbeitung.

Hinweis:

Öffentliche Apps unterstützen das Dateiuploadprogramm- Steuerelement nicht.

Arbeiten mit IResource

Wenn Sie eine Datei als ILocalResource erhalten, wird sie automatisch in eine IResource konvertiert, indem Folgendes verwendet wird:

JobAttachment.fromResource(file) // file is a ILocalResource

Wichtig:

Die folgenden Funktionen sind veraltet und sollten nicht mehr verwendet werden:

• .toLocalResource
• .toAppsFile

Allgemein

• Max. Dateigröße – Die maximale Dateigröße, die Benutzer hochladen können. Die empfohlene maximale Dateigröße beträgt 10 MB.
• Zulässige Dateitypen – Die Dateitypen, die Benutzer hochladen können. Verwenden Sie „ , “, um Dateierweiterungen zu trennen. Wenn Sie z. B. .jpg, .png, .svg schreiben, dürfen nur diese Dateitypen hochgeladen werden. Das . “-Symbol ist beim Auflisten der Dateitypen nicht obligatorisch.
• Hilfstext – Der Hilfetext, der bei der Laufzeit angezeigt werden soll.
• Tooltip – Der Text, der angezeigt werden soll, wenn ein App-Benutzer mit dem Mauszeiger auf das Steuerelement zeigt. Damit können Sie zusätzliche Informationen über das Steuerelement bereitstellen.
• Beschriftung – Der Anzeigetext des Steuerelements.
• Erforderlich – Bei „true“ müssen App-Benutzer Daten im Steuerelement angeben. Um das Steuerelement zur Laufzeit als obligatorisch zu markieren, wird nach dem Beschriftungstext ein Sternchen * hinzugefügt.
• Benutzerdefinierte Fehlermeldung – Der Text, der angezeigt wird, wenn die Eigenschaft Erforderlich auf „true“ festgelegt ist und das Steuerelement leer bleibt.
• Ausgeblendet – Bei „true“ wird das Steuerelement während der Runtime ausgeblendet.
• Deaktiviert – Bei „true“ wird das Steuerelement während der Laufzeit deaktiviert.
  Hinweis:

  • Das Dateiuploadprogramm- Steuerelement kann jeweils nur eine Datei hochladen.
  • Apps in einem mobilen Browser unterstützen keine nativen, Kamera-basierten Fotouploads. Speichern Sie stattdessen das Foto auf Ihrem Gerät und laden Sie dann die gespeicherte Datei mit dem Dateiuploadprogramm-Steuerelement hoch.

Events

• Datei hinzugefügt – Konfigurieren Sie, was passiert, wenn eine Datei hinzugefügt wird.
• Datei entfernt – Konfigurieren Sie, was passiert wenn eine Datei entfernt wird.

Stil

• Ausrichtung von Steuerelementen – Erbt standardmäßig die übergeordnete Ausrichtung. Eine andere Ausrichtung als die übergeordnete kann festgelegt werden. Um die Standardausrichtung wiederherzustellen, heben Sie die Markierung der überschriebenen Optionen auf.

  Hinweis:

  Die Ausrichtung hängt vom Layout ab, das für das übergeordnete Element ausgewählt wurde (Vertikal vs. Horizontal).

• Beschriftungsplatzierung – Standardmäßig wird die Beschriftung so eingestellt, dass sie oben auf dem Steuerelement auf der linken Seite angezeigt wird. Sie können es links neben dem Steuerelement in derselben Zeile platzieren. Die Eigenschaft Beschriftungsbreite konfiguriert, wie breit die Beschriftung sein soll, und die Eigenschaft Zwischenraum legt den Abstand zwischen der Beschriftung und dem Steuerelement fest.

• Schriftart – Die Schriftattribute für sowohl den Beschriftungs- als auch den Eingabetext, z. B. Schriftfamilie, Größe, Farbe oder Stil (Fett, Kursiv und Unterstrichen). Standardmäßig erbt das Steuerelement die Schriftfamilie des unmittelbar übergeordneten Containers, der durch das Schlüsselwort „Geerbt“ angegeben wird.

• Seitenrand – Der Seitenrand des Steuerelements. Standardmäßig ist ein Seitenrand von 4px festgelegt. Die Randeigenschaften Oben/Unten und Links/Rechts werden kombiniert. Diese Eigenschaften können mit der Schaltfläche Link rechts neben dem Abschnitt Seitenrand getrennt werden.

• Größe – Die Breite und Höhe des Steuerelements. Standardmäßig ist die Größe auf auto festgelegt. Um Mindest- oder Höchstwerte festzulegen, klicken Sie auf das Drei-Punkte-Symbol (…).

VB-Eigenschaften

VB-Eigenschaft	Datentyp	Beschreibung
Tooltip	String	Informationstext, der angezeigt wird, wenn der Benutzer mit dem Mauszeiger auf das Dateiuploadprogramm zeigt.
Label	String	Die Bezeichnung des Dateiuploadprogramms, in der Regel Text, der vor dem Steuerelement angezeigt wird.
Value	IResource	Name der aktuell hochgeladenen Datei.
Required	Boolescher	Gibt an, ob der Dateiupload obligatorisch ist.
RequiredErrorMessage	String	Meldung, die angezeigt wird, wenn der Dateiupload erforderlich ist, aber nicht angegeben wurde.
Hidden	Boolescher	Bestimmt die Sichtbarkeit des Dateiuploadprogramm- Steuerelements. Bei „true“ wird das Steuerelement zur Laufzeit ausgeblendet.
Disabled	Boolescher	Bestimmt, ob das Dateiuploadprogramm- Steuerelement interaktionsfähig ist. Bei „true“ wird die Interaktion mit dem Dateiuploadprogramm zur Laufzeit deaktiviert.
IsValid	Boolescher	Überprüft die Gültigkeit des Dateiuploadprogramm-Werts. Bei „true“ ist sie gültig.

Verwenden des Dateiuploadprogramms

Dieses Beispiel zeigt, wie Sie das Dateiuploadprogramm mit einem Speicher-Bucket verwenden können.

1. Öffnen Sie eine bereits vorhandene App oder erstellen Sie eine neue.
   • Fügen Sie ein Dateiuploadprogramm- Steuerelement hinzu.
   • Wählen Sie Ereignisse aus. Wählen Sie in Datei hinzugefügt die Option Automatisierung definieren aus.
2. Fügen Sie Ihrem Workflow eine Aktivität Upload Storage File hinzu.
   • Geben Sie den Orchestrator-Ordnerpfad und den Namen des Speicher-Buckets an.
   • Wählen Sie im Feld Datei den Ausdruck Controls.MainPage.FileUploader.Value aus.
   • Wählen Sie im Feld Uploadziel den Ausdruck Controls.MainPage.FileUploader.Value.FullName aus.
3. Testen oder führen Sie Ihre App aus.

Wenn Sie die App ausführen und eine Datei im Dateiuploader hinzufügen, lädt die App die Speicherdatei in den Speicher-Bucket hoch.