FileLink | X4Documentation

Mit <FileLink>-Controls können Sie Links zum Herunterladen einer Datei vom Server auf den Client einbinden. Die Datei kann entweder über einen Technical Process bereitgestellt werden, indem das Attribut process genutzt wird, oder direkt über eine zuvor gebundene Base64-Property mit dem Attribut data.

Hinweise zur Verwendung

Ein <FileLink>-Control wird mit dem Element <FileLink> erzeugt.

<FileLink>
...
</FileLink>

<FileLink>-Controls können in allen verfügbaren Layouttypen verwendet werden. Weitere Informationen finden Sie unter Layouts.

Attribute

Hinweis:

Es gibt eine Reihe von Standardattributen, die für alle Controls festgelegt werden können. Weitere Informationen zu den Standardattributen finden Sie unter Standardattribute.

Zusätzlich zu den Standardattributen können Sie die folgenden Attribute für <FileLink>-Controls definieren.

Attribut	Beschreibung
`data`	Nur verwenden, wenn eine Base64-Datei zum Download angeboten wird! Gibt an, welche Datei heruntergeladen werden soll. Mögliche Werte: Zeichenkette für Data Binding Der Data-Binding-Ausdruck muss auf eine Property vom Typ `base64` verweisen!
`displayName`	Name der Datei, die in der Web-Anwendung angezeigt wird und als Dateiname für die heruntergeladene Datei vergeben wird. Übersetzbar Data Binding möglich Mögliche Werte: Beliebige Zeichenkette inkl. Dateiendung
`fileId`	Identifikator, der vom Prozessentwickler verwendet werden kann. Data Binding möglich Mögliche Werte: Beliebige Zeichenkette
`fileName`	Erforderlich Identifikator für den Technical Process, der die Daten liefert. Übersetzbar Data Binding möglich Mögliche Werte: Beliebige Zeichenkette
`process`	Technical Process, der die Datei liefert. Mögliche Werte: Zeichenkette (URI)

Beispiel

Im folgenden Beispiel mit einem Dateidownload aus einer statischen Ressource ist die Verwendung des <FileLink>-Tags gezeigt. Dabei liegt die Datei 1.pdf, die zum Download bereitgestellt werden soll, direkt im Ordner Resources und wird über den Technical Process process_1.wrf im Ordner Services/Processes geliefert. Sowohl eine Datei als auch ein Technical Process müssen für einen Download vorhanden sein.

FileLink-Control in der Detail Component

XML

<DetailComponent path="Dashboard" displayName="Dashboard" default="true">
    <FlowLayout>
        <TextBox value="You can download your profile data as a digital business card." textOverflow="hidden"/>
        <FileLink process="process_1.wrf" fileName="1.pdf" displayName="Download digital business card"/>
    </FlowLayout>
</DetailComponent>

In obiger Web-App-Definition wird der Datei-Link definiert. Für FileLink wird ein Technical Process hinterlegt, der die Datei liefert (process_1.wrf). Es wird ein Anzeigename vergeben (displayName="example.pdf"), der als Text in der Web App und als Dateiname des Downloads verwendet wird. Das Attribut fileName ist in diesem Beispiel nicht relevant, dieses Attribut kann in komplexeren Anwendungen verwendet werden, da es dem verarbeitenden Technical Process vom Control zurückgeliefert wird.

Input FileLink

XML

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<fileId>1.pdf</fileId>