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.
- Im Fall einer Desktop-Installation wird ein Windows-Standarddialog angezeigt, der Standard-Funktionen, beispielsweise Dateifilter unterstützt.
- Im Fall einer Web EEC-Installation wird ein Fenster angezeigt, dass den Upload der auszuwählenden Datei unterstützt. Darin wird die ausgewählte Datei gelistet (2 in folgender Abbildung) und der Upload zum Server mit einer Fortschrittsanzeige (3 in folgender Abbildung) und einer Statusanzeige (1 in folgender Abbildung) visualisiert. Die eigentliche Dateiauswahl findet als Zwischenschritt in einem Windows-Standarddialog statt, der über eine Schaltfläche (4 in folgender Abbildung) 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 |
<form id="openSelectFileForm" title="Open file window">
<open ref="FileSelectionFormUI" type="link" receiver="=this" >Open file selection window </open>
</form>
<fileSelectionForm id="FileSelectionFormUI" title="Open File" >
<pathLocation text="C:\" />
<fileFilters>
<ext name="*.csv" />
<ext name="*.mdb" />
</fileFilters>
<fileButtonArea>
<okButton>
<performEvent
name="Documentation_UI_Configuration.ProjectLibrary.HelpObjects.ImportFileDataAction"
arguments="=List{$selectionReceiver}" />
</okButton>
<cancelButton></cancelButton>
</fileButtonArea>
</fileSelectionForm>
Ergebnis: