Upload and display documents

Create new data field for WebDAV access to documents

Step-by-step guide

To create a data field that enables access to documents via WebDAV, proceed as follows:

Select the data group you want to add the data field to.
Right click on it.
Select "New" > "Data field" in the context menu.

The "New data field" dialog box is displayed.
Enter a title.
Activate the "File more..." option
Click on"more..." (configure data field).

The "Filehandler" dialog box is displayed.
Activate the "GUID" or "Integer" option.
Select a file location.

Detailed information on this can be found in section File storage locations.
Activate the "Enable editing of the file via WebDAV" checkbox.
Click on "OK".

You return to the "New data field" dialog box.
Click on "OK".

You have created a new data field for accessing documents via WebDAV.

More information

Use existing data field for WebDAV access to documents

Step-by-step guide

To use an existing data field for WebDAV access to documents, proceed as follows:

Start the properties dialog of the data group that contains the data field of type "File".
Switch to the "Data fields" tab.
Select the data field of type "File" that you want to set up for WebDAV access.
Click on the icon.

The "Properties - Data field" dialog box is displayed.
Switch to the "Configuration" tab.
Field descriptions
File storage locations

Select the file storage location here.

Relative path

You can also specify a relative path, meaning a child folder path from the selected file storage location.

Upload settings

Maximum number of files per data record

Determines how many files are allowed per data record.

Max. file size

Defines the maximum size that uploaded files may have. Select the desired unit in the list to the right of the edit field.

Permitted file types

Specify which file types are allowed with a preceding point, such as .txt or .xml, and separate them with a comma.

Delete files when data field is deleted

Here, you can decide what should happen when the file data field is deleted.
- If allowed by Alias
  
  uploaded files are deleted if deletion is permitted by the settings set for the corresponding file storage location.
- No
  
  Uploaded files are not deleted.
Take files into account when exporting

The same conditions can also be defined for what happens when files are exported.

Image in case of error

Opens a dialog in which an image can be selected to be displayed if files are not physically present.

Data fields
Activate the "Enable editing of the file via WebDAV" checkbox.
Click on "OK".

You return to the "Properties - Data group" dialog box.
Click on "OK".

Set up document upload

Documents are uploaded via theFile selection" element.

Step-by-step guide

To set up the upload of documents that can be opened and edited via WebDAV, proceed as follows:

Start the application for which documents are to be uploaded via WebDAV.
Create an input page below the data group that contains the data field for saving the document references.
Use drag-and-drop to place the "File selection" element on the input page.

The "General" dialog box is displayed.
Field descriptions
Presentation of uploaded files / Presentation of new files

When you click one of the preview images, the paths to the corresponding Velocity files in use will be refreshed in the fields below the preview images. Clicking on the "Custom view" preview graphic clears these fields and activates the buttons for editing so that a custom velocity file can be integrated.

Select Velocity file

Opens a dialog in which a velocity file can be selected to be used as a template for a custom view.

Input required

This setting will make the file selection mandatory.

Enable download

Users can download the files with this option.
- Save as...
  
  Users can save the file after downloading it.
- Open in browser
  
  Users can open the file in the browser after downloading it.
- Open in new window
  
  With this setting, the file will open in a new window when it is opened in the browser.
Delete file

The following options are available:
- Do not enable
  
  A button will not be shown in the end device that allows the file to be deleted.
- While saving
  
  A button is shown to delete the file. The file will only be deleted, however, when the entire data record is saved.
- Immediately
  
  A button is shown to delete the file. The file is immediately physically deleted when the user clicks this button.
Please note that the "Immediately" deletion setting deletes the file irrevocably, regardless of whether the entire data record is saved or not.

Upload mode
- Replace existing files
  
  With this setting, files of the same name will be replaced in the upload procedure.
- Attach files at beginning
  
  New files will be inserted at the top of the file list. Intrexx uses an internal sorting field for this.
- Attach files at end
  
  Causes the files to be attached at the end of the list.
File selection/File selection view
Enter a title.
Click on "Next".

The "Options" dialog box is displayed.
Field descriptions
Find all the settings for uploading files here.

Upload settings

Enable multi-file uploads

This setting allows multiple files to be uploaded for each data record. Below, you can specify the permitted ""Maximum number of files per data record"".

Max. file size

You can specify the maximum file size that can be uploaded here. Select the desired unit in the list to the right of the edit field.

The settings "Max. number of files per data record" and "Maximum file size" can also be set for the file field.

If you do not want to limit the number of files or file size, please leave the corresponding fields here empty.

The setting you specify there is decisive for the "File selection" element. For example, if you specify a maximum number of ten files per data record in the properties of the file field, the file selection cannot upload more than ten files per data record, regardless of the number permitted in its properties. If you set the file selection for a maximum number of e.g. five files per data record, ten files are allowed via the data field, but the control only allows five files. Therefore, the setting in the File selection properties takes priority when setting restrictions.

The same principle applies for the setting for the ""Allowed file types"", which you can also specify in this dialog.

Permitted file types

Enter extensions for ""Allowed file types"" with a period in front of them, such as "".txt"" or "".xml"", each of them separated from the others with a comma. These entries are not case-sensitive. Wildcards cannot be applied here. When testing, whether a file is permitted or not, only the ending will be tested. In principle, if document.txt is entered here, for example, the check would interpret all files that end with document.txt as permissible, e.g. also a file with the name my-document.txt.

Asynchronous upload

Enables individual files to be uploaded to the server without saving the data set at the same time. However, the assignment to the record will only be created when the data set is saved. With this, the upload process can be controlled more precisely, especially with large files.

Please note that the user needs to be informed about this process. If this is not the case, we recommend using the "automatic upload" option.
- Upload files automatically
  
  causes the files placed via drag & drop to be loaded immediately after the mouse button is released.
- Start upload, Terminate upload, Delete file
  
  The corresponding buttons will be shown on the end device, allowing the upload process to be controlled accordingly.
Preview of image / audio / video files

The preview is shown when the file has already been selected but the data record has not been saved yet. When viewing an existing data record, this setting is not relevant for the presentation, but rather the setting for the thumbnail.

File selection/File selection view
Click on "Next".

The "Display" dialog box is displayed.
Field descriptions
Here you can find all the settings for displaying uploaded files.

Display thumbnail

With this setting, every image uploaded with the file selection is automatically made smaller and shown as a thumbnail in view tables.

Display link to image in original size

Provided it has already been saved, the image will be shown in its original size in a new window when the user clicks on the image. This setting can only be selected if the "Enable download" setting is not selected on the "General" tab.

Rotate images in original size

Rotates the image in its original size.

Rotate images

Rotates the images in the size specified in the Application Designer.

Maximum size

Define the maximum height and width that an image can take up in pixels. Larger images are reduced proportionally but smaller images will not be changed.

Crop image

The image's width and height will be adjusted to the surrounding element.

Enlarge smaller images

If this setting is also selected, smaller images are enlarged to the specified maximum size.

Optimize file size for thumbnails (reduce)

Reduces the file size for the purpose of increasing the application page's loading time.

Thumbnails for files

If the uploaded file is not an image, a suitable representation can be selected here.
- Dependent on file type
  
  With this setting, you can define which file extension is linked with which thumbnail image in the file ""fileextension.properties"" which is found in the portal directory /internal/cfg.
- Intrexx standard
  
  An image defined by Intrexx is used.
- Select static image / image
  
  Opens a dialog in which an image can be selected.
File selection/File selection view
Click on "Next".

The "Data field" dialog box is displayed.
Activate the "Data field" option and select the data field you created previouslyCreate new data field for WebDAV access to documents).
Click on "Next".

The "Final settings" dialog box is displayed.
Click on "Finish".

More information

File selection

Set up document display

Documents are displayed and edited via theFile selection view" element.

Step-by-step guide

To set up the display and editing of documents that can be opened and edited via WebDAV, proceed as follows:

Start the application for which documents are to be uploaded via WebDAV.
Create a view page below the data group containing the data field to save the document references.
Use drag-and-drop to place the "File selection view" element on the display page.

The "General" dialog box is displayed.
Select the "WebDAV" tile under "Template".
Field descriptions
Enable download

Users can download the files with this option.
- Save as...
  
  Users can save the file after downloading it.
- Open in browser
  
  Users can open the file in the browser after downloading it.
- Open in new window
  
  With this setting, the file will open in a new window when it is opened in the browser.
Handling images in emails

Attachment

Images from the File menu will be treated as an attachment.

Embedded

Images will be embedded by the File menu element.

File selection/File selection view
Click on "Next".

The "Options" dialog box is displayed.

Field descriptions

Display file name

Causes the names of the uploaded files to be shown in a vertical list in the column.

Display file size

Causes the size of the corresponding files to be shown in the column as well.

Display thumbnail

A thumbnail image is displayed for each uploaded file.

Edit settings for thumbnail

Opens a dialog in which the corresponding settings can be edited. The description of the settings can be found here.

Display gallery

Causes two buttons to be shown within the table column, allowing the user to navigate forwards and backwards through a small gallery of uploaded images.

Edit settings for gallery

Opens a dialog in which the corresponding settings can be edited.

Maximum number of files per data record

Determines the maximum number of files that can be uploaded for each data set.

File selection/File selection view

Enable WebDAV

The "Activate WebDAV" checkbox is activated and greyed out, as you selected the "WebDAV" tile in the previous dialog.

Click on the file to open it in the configured editor

If you activate this checkbox, the file is opened immediately in the portal with the program that you have defined as the default program in the configuration settings when you click on it.

See section Set default program for opening files.
Click on "Next".

The "Data field" dialog box appears.
Activate the "Data field" option and select the data group and the data field that you created previouslyCreate new data field for WebDAV access to documents).
Click on "Next".

The "Final settings" dialog box appears.
Click on "Finish".

More information

File selection view