Diese Funktionalität ist nur in bestimmten Ausbaustufen verfügbar.

fileSelectionForm

Ein <fileSelectionForm> dient der Dateiauswahl. Das Dateiauswahlfenster wird mit Hilfe des Elements <open> über seine ID aufgerufen. Die ausgewählte Datei kann direkt von einem Skript weiterverarbeitet oder der absolute Name an einen Parameter übergeben werden.

Für das Dateiauswahlfenster kann der Titel (siehe 1 in Abbildung Dateiauswahlfenster) und die auswählbaren Dateitypen (siehe 2 in Dateiauswahlfenster) definiert werden.

Das fileSelectionForm wird mit Hilfe des Elements open aus einem anderen Form-UI oder aus einem Graph2D-Diagramm aufgerufen.

Die Darstellung des Dateiauswahlfensters unterscheidet sich, je nachdem ob es in einer Desktop- oder Web EEC-Installation gestartet wird.

Soll die Schaltfläche [Abbrechen] keine Aktion ausführen, muss diese in der fileButtonArea nicht explizit aufgeführt werden. Für [OK] ist immer eine Aktion anzugeben.

Der Aktion, die beim Betätigen von einer Schaltfläche ausgelöst wird, ist in der Liste der Argumente für die run()-Methode kein Argument für den gewählten Dateipfad vorzusehen (siehe Abbildung Dateipfad für Aktion). Der absolute Pfad zur ausgewählten Datei wird von EEC als letztes Argument an die Liste angefügt bevor die run()-Methode der Aktion aufgerufen wird.

Es ist nur sichergestellt, dass der übergebene Dateiname demjenigen entspricht, der von <fileSelectionForm> zurückgegeben wird.

Hinweis:

In einer Client/Server-Umgebung wird der Pfad der Client-Seite auf der Server-Seite durch einen temporären Pfad ersetzt, beispielsweise wird aus dem Client-seitigen c:\test\BOM.csv auf der Server-Seite c:\tmp\33568991\BOM.csv.

Hinweis:

In einer Web EEC-Umgebung wird eine Upload-Datei in einem temporären Ordner unterhalb von <Tomcat-Installationspfad>\temp abgelegt. Diese Ordner haben den Namen fileupload_<Sessionnummer>.

Hinweis:

Durch Beenden oder Verlassen einer Session wird der dazugehörige temporäre Ordner gelöscht. Für eventuell vorher gestartete Erzeugungen von Zieldaten stehen die Daten im temporären Ordner dann nicht mehr zur Verfügung!

Attributname Verwendung Attributwerte Defaultwert Beschreibung
id benötigt beliebig   eindeutige ID, auf die Bezug genommen wird
title benötigt beliebig   Name des Form-UIs
Erlaubte Unterelemente Anzahl
fileButtonArea 0..1
fileFilters (nicht für Web EEC) 0..1
pathLocation (nicht für Web EEC) 0..1