File Selection / File Selection View

Using the file selection feature, you can upload files to the server and make them available for download.

To do this, create the file selection on an input page. The uploaded files can be saved using the corresponding button, provided that a file data field is linked to the file selection.

Starting with Intrexx version 12.0.2:

Please note the instructions for generating file names.

Clicking on the element opens the standard dialog box, where you can select an image file. You can also drag and drop images into the element or paste images that you've previously copied to the clipboard using the CTRL + V shortcut.

The "File Selection View" element can display uploaded files.

For both elements, there are templates that allow for different ways of displaying the images.

Both application elements belong to the "Images and Files" element category.

You can find the file selection elements in the "Applications" module under "Elements. " You can create a new element by dragging and dropping it from here onto the workspace.

For more information on creating elements, click here.

An element's Properties dialog box opens automatically when it is created. You can open the Properties dialog box for an existing element by double-clicking the element on the workspace, selecting "Properties" from the context menu, or choosing "Edit / Properties" from the main menu when the element is selected on the workspace.

File Selection

General

In the Properties dialog box for the file selection, you'll find the following settings on the "General" tab:

Title

Enter the title of the file selection here. You can find information about multilingual titles here.

Edit Text Alternative

Opens a dialog box where you can enter text that will be displayed in place of the icon on devices that cannot display images.

Template

In this section, you can select templates for displaying the files in the browser. Each template is based on a VM file, which you can find in the portal directory internal/system/vm/html/fileviews. Most templates use their own style classes, which are entered in the corresponding field on the "View" tab.

The templates function according to the settings on the "Options" and "Display" tabs.

1. "Advanced" template (downloadTemplateAdvanced.vmi)

Style Class: File_Edit_Advanced

Displays the downloaded image files as thumbnails in a row. The file size is displayed below each image. Above the images, you'll find the option to upload additional files. When you hover your mouse over an image, a button appears in the upper-right corner that allows you to delete the image. Click on an image to download it.

2. "Basic" template (downloadTemplateBasic.vmi)

Style class: File_Edit_Basic

With this template, you can download additional files from the top section.

All images are displayed one below the other as thumbnails. Click on an image to download it. The file name and file size are displayed to the right of the image. You'll also find a button here that allows you to delete the corresponding file.

3. "Minimal" template (uploadTemplateMinimal.vmi)

Style class: File_Edit_Minimal

Here you'll find all the uploaded images at the top of the page, displayed in a row as thumbnails. Click on an image to download it. In addition, when you hover over the image with the mouse, a button appears in the upper-right corner that allows you to delete the image. Below the images, you'll find a button that allows you to upload additional files.

4. "Standard" Template (downloadTemplateStandard.vmi)

Style Class: File_Edit_Standard

At the top of this page, you'll find the option to upload additional files. Below that, all images are displayed as thumbnails—according to the settings in the view. Clicking on an image will load it in its original size. Click the file name link to download the image. For each image, the file size is displayed below the file name, along with a button that can be used to delete that image.

5. "Office 365" Template

A template that has been specifically customized for Microsoft Office 365. This allows files to be opened directly in Microsoft Office 365, in addition to the option to download them. In addition, thumbnails of files from Microsoft Office 365 can be displayed.

6. "Custom View" Template

The "Custom View" template allows you to include your own Velocity file for display in the browser.

Display of Uploaded Files / Display of New Files

When you click on one of the preview images, the corresponding paths to the Velocity files used for the display are updated. Clicking the "Custom View" preview image clears these fields and enables the editing buttons so that you can import your own Velocity file.

Select Velocity File

Opens a dialog box where you can select a Velocity file to use as a template for your own view.

Select Velocity File

Reference the Velocity file from the application package

Shows the path to the file from the application package. All Velocity files from the application package are stored in the portal directory internal/application/store/<AppGuid>/resources.

Select Velocity File

Opens the Velocity File Manager, where you can select a Velocity file.

Edit the Velocity file

Opens the script editor, where you can edit the Velocity file.

Reference an existing Velocity file on the server

Shows the path to the file on the server.

Click "OK" to save your changes and close the dialog box.

Image Editing

This feature allows you to enable two editors for editing previously uploaded image files (JPEG and PNG). You can find all the information here.

Input Required

With this setting, the file selection becomes a required field.

Enable Download

This option allows users to download files.

• Save As...

  Users can save the file after downloading it.

• Open in browser

  Users can open the file in their browser after downloading it.

• Open in a new window

  When opened in a browser, the file will open in a new window with this setting.

Delete File

The following options are available:

• Do not allow

  No button appears on the device that allows the file to be deleted.

• When saving

  Displays a button that allows you to delete the file. However, the file is not physically deleted until the entire data set has been saved.

• Immediately

  Displays a button that allows you to delete the file. The file is physically deleted immediately when the user clicks this button.

Upload Behavior

• Replace existing files

  With this setting, files with the same filename will be overwritten when uploaded.

• Insert files at the beginning

  New files are inserted at the beginning of the file list. Intrexx uses an internal sort field for this purpose.

• Append files to the end

  Causes the new files to be inserted after the existing ones.

Options

Here you'll find all the settings for uploading files.

Upload Settings

Enable the upload of multiple files

This setting allows you to upload multiple files per record. Below, you can specify the maximum number of files allowed per record.

Max. file size

Here you can specify the maximum file size that can be uploaded. Select the desired unit from the list to the right of the input field.

Accepted File Types

To do this, enter the file extensions—preceded by a period and separated by commas—such as .txt or .xml, in the "Allowed file types" field. Capitalization does not matter in this context. Wildcards are not used here. The process of determining whether a file is valid or not checks the specified file extension. In principle, if, for example, "document.txt" is entered here, the check would interpret all files ending in "document.txt" as valid—including, for example, a file named "my-document.txt."

Asynchronous Upload

Allows you to upload individual files to the server without saving the record at the same time. However, the association with the record is not established until the record is saved. This allows for more precise control over the upload process—especially when dealing with large files.

• Upload Files Automatically

  causes files placed via drag-and-drop to load immediately after the mouse button is released.

• Start Upload, Cancel Upload, Remove File

  Displays the corresponding buttons in the browser that can be used to control the upload process.

Preview for Image Files / Audio Files / Video Files

The preview is displayed when the file has already been selected but the record has not yet been saved. When viewing an existing record, it is not this setting but the thumbnail setting that determines how the record is displayed.

Presentation

Here you'll find all the settings for displaying uploaded files.

Show thumbnail

With this setting, all images loaded via the file selector are automatically resized in view tables and displayed as thumbnails.

Show link to full-size image

If the image has already been saved, it will be displayed in its original size in a new window when the user clicks on it. This setting can only be selected if the "Allow downloads" option on the "General" tab is not selected.

Rotate Rotated Images to Their Original Size

Rotates the image to its original size.

Rotate Rotated Images

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

Maximum size

Sets the maximum size of the image. Enter the width and height of the image in pixels. Larger images are scaled down proportionally, while smaller images remain unchanged.

Crop Image

The width and height of the image are adjusted to fit the surrounding element.

Enlarge smaller images

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

Optimize (reduce) the file size of thumbnails

This reduces the file size, resulting in faster loading times for the application page.

Thumbnails for files

If the uploaded file is not an image, you can select an appropriate representation here.

• Depending on the file type

  With this selection, you can specify in the fileextension.properties file—located in the portal directory internal/cfg—which file extension is linked to which thumbnail image.

• Intrexx Standard

  An image provided by Intrexx is used.

• Select an image

  Opens a dialog box where you can select an image.

Starting with Intrexx Version 12

Data field

No link

With this option, the file selection is not linked to a data field. The selected values are not saved.

Data Field

Here, you can select an existing file data field.

Create a New Data Field

Opens a dialog box where you can create a new data field.

Data Group

You can find all the information about the settings in this section here.

File Selection View

General

Most of the settings here on the "General" tab in the "File Selection View" Properties dialog box can also be found in the "File Selection" Properties dialog box. The following describes the different settings:

Template

In this section, just as with file selection, you can choose templates for displaying the files in the browser. Each template is based on a VM file, which you can find in the portal directory internal/system/vm/html/fileviews. Most templates use their own style classes, which are entered in the corresponding field on the "View" tab.

The templates work according to the settings in the options. For example, if the maximum number of files per record is limited to "1," only the first image will be displayed for each template.

viewTemplateBasic.vmi (1)

Style Class: File_View_Basic

Displays the first image. The size is based on the setting selected for "Show thumbnails" in the options.

viewTemplateMinimal.vmi (2)

Style class: File_View_Minimal

Displays all images uploaded per record as thumbnails in a single row.

viewTemplateStandard.vmi (3)

Style class: File_View_Standard

Displays all images as thumbnails one below the other. If the settings are configured in the options, the text and file size will be displayed to the right of each image here.

viewTemplateImageScroller.vmi (4)

Style class: File_View_Scroller

This template allows you to display multiple images in a small space. To the right and left of it, you'll find arrow buttons that let you scroll through the images.

viewTemplateBgImage.vmi (5)

Style class: ix-cover ix-center-center

Displays all images in their original size, one below the other.

viewTemplateResponsiveGallery.vmi (6)

Displays all images in a gallery.

To the right and left of the image, you'll find arrow buttons that you can use to scroll through the images. Below the image, the images it contains are displayed as small circles. Clicking on it will switch to the selected image. You can start a slideshow by clicking the Play button in the lower right corner.

Office 365 (7) and Custom View (9)

You can also find these templates in the Properties dialog box for the file selection (input field). The functions are the same here.

Starting with Intrexx version 12.2.0

Connectors (7) and Custom View (9)

You can also find the "Custom View " template in the Properties dialog box for the file selection (input field). The functions are the same here.

If the portal contains connections to the following connectors, you will find corresponding templates here in the dialog that you can use to display the files:

	Connector for SharePoint
	Connector for Salesforce
	Connector for Dracoon
	Connector for Microsoft 365 and Teams

WebDAV (8)

This template is related to the "WebDAV functionality," which allows you to open, edit, and save documents or files directly using the appropriate program via your portal.

All other settings required for "WebDAV functionality" and further explanations on this topic can be found in the following sections:

• Opening, Editing, and Saving Documents in Intrexx (WebDAV)

• Upload and View Documents

Handling Images in Emails

Appendix

Images are treated as attachments by the file selector.

Embedded

Images are embedded from the file selector.

Options

Show File Name

Causes the names of the uploaded files to be displayed one below the other in the column.

Show size

With this setting, the size of each file is also displayed in the column.

Show thumbnail

A thumbnail image is displayed for each uploaded file.

Edit Thumbnail Settings

Opens a dialog box where you can edit the relevant settings.

Options for Responsive Images

Image height in pixels

Here, define the maximum image height in pixels for the Small, Medium, and Large layout sizes. If any fields are left blank, the setting for the smaller layout size (if available) is used.

Resize Image

Specify the image scaling method here.

Cover (Image will be scaled and cropped)

This option scales and crops the image.

Position of the cutout

Select the desired position for the scaled and cropped image here.

Fit (Image is scaled while maintaining its aspect ratio)

With this option, the image is also scaled, but not cropped. It retains its original proportions.

Click "OK" to save your changes and close the dialog box.

View Gallery

Allows the user to scroll forward and backward through the uploaded images within the table column using two buttons arranged in a small gallery.

Edit Gallery Settings

Opens a dialog box where you can edit the relevant settings.

You can find all the information about the settings in this dialog box here.

Click "OK" to save the changes and close the dialog box.

Maximum number of files per record

Specifies the maximum number of files that can be uploaded per record.

Enable WebDAV

Clicking on a file opens it in the configured editor

If you select this checkbox, clicking on the file in the portal will immediately open it in the program you have set as the default in the configuration settings.

Data field

No link

With this option, the file selection is not linked to a data field. The selected values are not saved.

Data field

Here, you can select an existing file data field.

Create a New Data Field

Opens a dialog box where you can create a new data field.

Data Group

You can find all the information about the settings in this section here.

Column Display in View Tables

You can find all the information on this topic here.

More Information

Functions of the file selection with the "Image URL" control type