OS Independant and Secure File Management for Web Applications
The File Exchange container allows Trust1Connector to manage files and directories, to upload or download files to/from the filesystem from/to the requesting party (especially for web application). The user of the device must give a consent prior of file operations.
The File Explorer exposes a controlled and secured abstraction for file operations.
The File Exchange container provides the following functionalities:
selecting a folder based on application type
listing files in selected application type
downloading one or more files into selected application type
uploading one or more files from the selected application type
creating sub directories in 'mapped' folders (application types)
The Trust1Connector does NOT allow the deletion of folders or files residing on the user's device.
An application type resolves locally to an absolute file system path.
An application can create additional folders for a given application type, those folders are relative to the absolute path which has been locally mapped on the application type. This means that the web application can ask the user to create subdirectories in an application type which has been already mapped.
The File Exchange container provides additionally:
optional user notification for file transfer completion
copy and move files between application types
user consent to allow the consuming application to perform file operations
application/domain scoped, application types are bound to the application domain
OS native files and directory chooser dialogs
Detailed developers documentation can be found in the technical documentation:
File Explorer Functionalities
Selecting the 'File Explorer' menu show the following applciation screen:
The File Explorer contextualizes folder mapping based on the connected application (done virtually using an application identifier).
Each application can have one or more 'Entities'. The example entity used in this application is called 'RMC'. You can have more application Entities defined using the Trust1Connector. For the example applciation, one has been predefined.
Within an Entity, one or more folder-mappings can be defined, this is called a 'Type' mapping. Basically it means you create a virtual name, and link it to an existing folder on your local device.
Select the button 'create type and assign location':
After defining the name, a file-chooser will pop-up from the Trust1Connector, now you can create and select a folder. The folder will be linked to the 'type', which means all files in the folder will become available for the web application. In order to do so, a user consent is needed:
The result of the file creation and mapping is show in the main application overview:
For an existing 'Type' (see Overview), you can create a new folder within the root directory:
A file can be uploaded to the web application from the local device.
When copying files to the linked folder (linked to the 'type' definition), the files will also appear/be accissable in/for the web applciation. Remember the web application can access all data from the root folder recursively.
After selecting and confirming the file upload, the file will be show in the application overview
With a file selected, additional options are available:
download file
print file
rename file
move file
copy file
The meaning of 'Download File' is from the perspective of the local device - aka - the local device downloads a file form the web application (upload and download MUST be seen from the perspective of the local device).
When donwloading a a file, the user can perform this off course in any system folder.
The Trust1Connector has a printer module enabled, which means that a printer (available on the operating system) can be selected and triggered for a print job.
Rename a file from the web application as would be the case using the local operating system.
Move a file from the web application as would be the case using the local operating system, but with the additional restriction that this can only be done between accessible folders, or within the same folder. Moving files to unaccessible folders are not allowed and will be prevented from the Trust1Connector.
Copy a file from the web application as would be the case using the local operating system, but with the additional restriction that this can only be done between accessible folders, or within the same folder. Copying files to unaccessible folders are not allowed and will be prevented from the Trust1Connector.
| Nr | Function | Description |
|---|---|---|
1
Type - linked to local (root)-folder
Folder acting as an isolated file space for the web application
2
Upload File
Upload a file from your web application to the local file system
3
Create Folder
Create new folder within the selected 'Type'
4
Create Type
Add another/new Type mapping
5
Delete Type
Deletes only the virtual mapping, NOT the real data from the local device
