View source for File Upload Size Restriction

{{UnderConstructionStart}}
== File Upload Size Restriction ==

'''Overview'''

This feature introduces a configurable file upload size restriction. Its purpose is to prevent users from attempting to upload excessively large files (for example, a 100 MB file) when a much smaller upload limit is enforced.

Previously, when a file exceeded the allowed limit, the system would repeatedly attempt to upload it. Since the upload could never succeed, this resulted in an internal retry loop. The user received no feedback, leaving them confused and unaware of why their changes were not being fully committed.

The new '''FileUploadSizeRestriction''' mechanism resolves this issue by enforcing a maximum allowed file size before any upload attempt is performed. When a file exceeds this configured limit, the system immediately stops the upload and provides clear user feedback.

=== User Feedback ===

When an over-sized file is detected:

* The user immediately receives a notification.
<br>
The notification includes:

* The actual size of the selected file.

* The configured maximum size allowed for uploads.
<br>
This ensures that the user knows exactly:

* What went wrong

* How large their file currently is

* What the maximum allowed file size is
<br>
[[File:Notification_FileUploadSizeRestriction.png]]

=== ViewModel Properties ===

To provide additional flexibility and UI customization, two new properties are available for UI developers and Customizer implementations.

==== 1. FileNotUploadedReason ====

A string containing a explanation of why the file was not uploaded.
<br>
'''It includes:'''

* The actual file size (MB, rounded to 2 decimals)
* The configured upload limit (MB)
<br>

''If no size-restriction applies or the file does not exceed the configured limit, this property returns null as its default value.''
<br>

Example usage:
<source lang="xml">Text="{Binding DocumentViewModel.FileNotUploadedReason}"</source>
<br>


==== 2. MaxUploadSizeMB ====

A double representing the maximum allowed file size in megabytes.<br>
This allows UI elements to display helpful contextual information directly.
<br>
<br>
''If no size restriction is configured for the content, this property returns null as its default value.''
<br>

Example usage:

<source lang="xml">Text="{Binding DocumentViewModel.MaxUploadSizeMB}"</source>

<br>

How and where these values are displayed is entirely up to the UI customizer.


= Availability =
{| class="wikitable" style="text-align: center; width: 30%" 
|-
! style="width:60%" | Clients
!! style="width:40%" | Available since
|-
| Mobile
|| [[Version_5.1_(Mobile)]]
|-
| WinX
|| [[Version_5.1_(WinX)]]
|}

[[Category:Client|File Upload Size Restriction]]
[[Category:Mobile|File Upload Size Restriction]]
[[Category:Version 5.1|File Upload Size Restriction]]
[[Category:WinX|File Upload Size Restriction]]