FileLink

FileLink-Controls werden verwendet, um Dateien für den Download einzubinden. Für diesen Download gibt es zwei Möglichkeiten. Zum einen kann die Datei, die heruntergeladen werden soll, als statische Ressource im Resources-Ordner liegen, zum anderen kann die Datei dynamisch über einen Technical Process geladen werden.

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
`fileName`	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)
`background`	Definiert eine Farbe für den Hintergrund des Controls. Diese Einstellung überschreibt die Standardfarbe des Farbschemas! Dieses Attribut funktioniert nicht für die Controls `Maps` und `HtmlDocument`! Mögliche Werte: Hexadezimaler Farbwert, z. B. `ff5a00` Verwenden Sie keine Raute vor dem Farbwert! Verwenden Sie keine verkürzte Schreibweise des Farbwerts! Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. `A200`
`fileId`	Identifikator, der vom Prozessentwickler verwendet werden kann. Data Binding möglich. Mögliche Werte: Beliebige Zeichenkette
`enabled`	Legt fest, ob der Nutzer mit dem Control interagieren kann. Data Binding (Boolean) möglich Mögliche Werte: `true`/`false` oder Ausdruck für Data Binding Das Attribut `enabled` ersetzt das veraltete Attribut `disabled`. `enabled="true"` entspricht damit dem veralteten Attribut `disabled="false"`.
`fontFamily`	Legt die Schriftfamilie fest. Mit diesem Attribut wird die Standardschrift der Web App für dieses Control überschrieben. Wird das Attribut auf einem Element definiert, so wird die Schriftfamilie an die Kindelemente des Elementes vererbt, sofern die Kindelemente das Attribut `fontFamily` nicht explizit gesetzt haben. Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`. Mögliche Werte: `MainFont`: hinterlegte Hauptschrift Fontcode aus der Font-Palette, z. B. `Font04`
`fontSize`	Legt die Schriftgröße fest. Mit diesem Attribut wird die Standardschriftgröße der Web App für dieses Control überschrieben. Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`. Mögliche Werte: Beliebige ganze Zahl oder Dezimalzahl mit einem Punkt als Dezimaltrennzeichen, z. B. `20` ; `20.8` ; `.9` Schriftgröße in Pixel, z. B. `20px` Schriftgröße in Punkt, z. B. `18pt` Schriftgröße im Vergleich zur Schriftgröße des Elternelements, z. B. `.8em` oder `120%` Schlüsselwörter: `xx-Small` , `x-small` , `small` , `medium` , `large` , `x-large` , `xx-large` , `smaller` , `larger`
`fontStretch`	Legt die Breite der einzelnen Schriftzeichen fest. Mit diesem Attribut wird die Standardbreite der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Condensed` `Expanded` `ExtraCondensed` `ExtraExpanded` `Medium` `Normal` (Standard) `SemiCondensed` `SemiExpanded` `UltraCondensed` `UltraExpanded` Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map`, `Chart` und `HtmlDocument` .
`fontStyle`	Legt die Neigung der Schrift fest. Mit diesem Attribut wird die Standardneigung der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `italic`: kursive Schrift `normal`: normale Schrift (Standard) `oblique`: schräg gestellter Schriftstil (berechnet) Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`.
`fontWeight`	Legt die Schriftstärke fest. Mit diesem Attribut wird die Standardstärke der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Black` `Bold` `DemiBold` `ExtraBlack` `ExtraBold` `ExtraLight` `Heavy` `Light` `Medium` `Normal` (Standard) `Regular` `SemiBold` `Thin` `UltraBlack` `UltraBold` `UltraLight` Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`.
`foreground`	Definiert eine Farbe für den Vordergrund (Texte usw.) des Controls. Diese Einstellung überschreibt die Standardfarbe des Farbschemas! Dieses Attribut funktioniert nicht für die Controls `Map` und `HtmlDocument`! Mögliche Werte: Hexadezimaler Farbwert, z. B. `ff5a00` Verwenden Sie keine Raute vor dem Farbwert! Verwenden Sie keine verkürzte Schreibweise des Farbwerts! Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. `A200`
`horizontalAlign`	Richtung, in die die Elemente fließen. Reihenfolge der Elemente entspricht ihrer Deklaration. Mögliche Werte: `left` (Standard) `center` `right`
`textOverflow`	Gibt an, was passieren soll, wenn das Control voll ist. Mögliche Werte: `ellipsis` : Mit `...` zeigen, dass der Text nicht zu Ende ist `hidden` : Text abbrechen, auf ganze Wörter achten `wordBreak` : innerhalb des Wortes abbrechen `allow` (Standard): Text zwischen den Wörtern umbrechen
`visible`	Legt fest, ob das Control sichtbar ist. Data Binding (Boolean) möglich Mögliche Werte: `true` / `false` oder Zeichenkette für Data Binding

Beispiel `<FileLink>` (Dateidownload aus statischer Ressource)

Im folgenden Beispiel 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.

Beispiel FileLink

XML

<WebApp xmlns="http://softproject.de/webapp/1.0" path="download">
	<Modules>
		<Module path="Module" displayName="My Module">
			<Components>
				<DetailComponent path="Dashboard"
					displayName="Dashboard" default="true">
					<FlowLayout>
						<FileLink process="process_1.wrf" fileName="1.pdf" displayName="example.pdf" />
					</FlowLayout>
				</DetailComponent>
			</Components>
		</Module>
	</Modules>
</WebApp>

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>

Der Code aus dem Beispiel für FileLink erzeugt folgende Ansicht in der Web-Anwendung:

Beispiel <FileLink> (Dateidownload aus statischer Ressource)

Beispiel `<FileLink>` (Dateidownload aus statischer Ressource)