Dateiuploadprogramm

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.

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 (…).

Verwenden des Dateiuploadprogramms

Dieses Beispiel zeigt, wie Sie das Dateiuploadprogramm mit einem Speicher-Bucket und mit einem Dateifeld einer Entität verwenden können.

1. Fügen Sie in Ihrer App einen Speicher-Bucket und eine Data Service-Entität mit Dateifeldern hinzu.
2. Fügen Sie ein Dateiuploadprogramm- und ein Schaltflächensteuerelement hinzu.
3. Erstellen Sie eine Variable vom Typ AppsFile und nennen Sie sie „SB_file_var“. Verwenden Sie diese Variable, um die aus dem Speicher-Bucket heruntergeladene Datei zu speichern.
4. Fügen Sie die Regel Datei in Speicher-Bucket hochladen dem Ereignis Angeklickt des Schaltflächensteuerelements hinzu.
   1. Verweisen Sie im Feld Hochzuladende Datei wie folgt auf die Datei, die über das Dateiuploadprogramm-Steuerelement hochgeladen wurde:

      MainPage.FileUploader.Value

   2. Verweisen Sie im Feld Speicher-Bucket auf den Orchestrator Speicher-Bucket, den Sie zuvor Ihrer App hinzugefügt haben.
   3. Optional können Sie im Feld Nach Abschluss eine Regel Nachricht anzeigen hinzufügen, um Sie darüber zu informieren, dass der Upload erfolgreich abgeschlossen wurde.
5. Fügen Sie die Regel Datei aus Speicher-Bucket herunterladen zum Ereignis Angeklickt des Schaltflächensteuerelements hinzu.
   1. Verweisen Sie im Feld Speicher-Bucket auf den Orchestrator Speicher-Bucket, den Sie zuvor Ihrer App hinzugefügt haben.
   2. Schreiben Sie in das Feld Dateiname (mit Erweiterung) den Namen der Datei, die Ihre Benutzer herunterladen sollen.
   3. Verweisen Sie in der Variablen Datei zu App zuweisen auf die zuvor erstellte Variable „SB_file_var“.
   4. Optional können Sie im Feld Nach Abschluss eine Regel Nachricht anzeigen hinzufügen, um Sie darüber zu informieren, dass der Download erfolgreich abgeschlossen wurde.
6. Fügen Sie Ihrer App ein Beschriftungssteuerelement hinzu.
   1. Verweisen Sie im Feld „Text“ des Steuerelements wie folgt auf den Namen der heruntergeladenen Datei:

      SB_file_var.Name

      – Dabei ist „SB_file_var“ die Variable, die zum Speichern von Daten über die heruntergeladene Datei verwendet wird.

7. Führen Sie Ihre App aus und laden Sie eine Datei mit dem Dateiuploadprogramm-Steuerelement hoch. Klicken Sie auf die Schaltfläche.

Oben auf Ihrem Bildschirm sollte eine Erfolgsmeldung angezeigt werden, die Sie darüber informiert, dass der Upload/Download erfolgreich abgeschlossen wurde. Überprüfen Sie nun den Speicher-Bucket im Orchestrator. Sie sollten die Datei sehen, die Sie mit dem Dateiuploadprogramm-Steuerelement hochgeladen haben.

Gleichzeitig wurde durch Klicken auf die Schaltfläche die Datei, die in der Regel Datei aus Speicher-Bucket herunterladen angegeben ist, auf Ihr lokales Gerät heruntergeladen und die Daten in einer Variablen gespeichert. Das Beschriftungssteuerelement zeigt den Namen der heruntergeladenen Datei an.

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.
Wert	AppsFile	Name der aktuell hochgeladenen Datei.
Erforderlich	Boolescher	Gibt an, ob der Dateiupload obligatorisch ist.
RequiredErrorMessage	String	Meldung, die angezeigt wird, wenn der Dateiupload erforderlich ist, aber nicht angegeben wurde.
Ausgeblendet	Boolescher	Bestimmt die Sichtbarkeit des Dateiuploadprogramm -Steuerelements. Wenn diese Option auf „true“ festgelegt ist, wird das Steuerelement zur Laufzeit ausgeblendet.
Deaktiviert	Boolescher	Bestimmt, ob mit dem Dateiuploadprogramm -Steuerelement interagiert werden kann. Bei „true“ wird die Interaktion mit dem Dateiuploadprogramm zur Laufzeit deaktiviert.
IstGültig	Boolescher	Überprüft die Gültigkeit des Dateiuploadprogramm-Werts. „true“ gibt an, dass sie gültig ist.