UploadCollection SAP SE This control allows you to upload single or multiple files from your devices (desktop, tablet or phone) and attach them to the application. The consuming application needs to take into account that the consistency checks of the model during the upload of the file need to be performed, for example, if the user is editing or deleting a file. <br> As of version 1.62, there is an {@link sap.m.upload.UploadSet} control available that is based on this control. {@link sap.m.upload.UploadSet} provides enhanced handling of headers and requests, unified behavior of instant and deferred uploads, as well as improved progress indication. 1.26.0 sap.ui.core/Control Defines the allowed file types for the upload. The chosen files will be checked against an array of file types. If at least one file does not fit the file type requirements, the upload is prevented. Example: ["jpg", "png", "bmp"]. Specifies the maximum length of a file name. If the maximum file name length is exceeded, the corresponding event 'filenameLengthExceed' is triggered. Specifies a file size limit in megabytes that prevents the upload if at least one file exceeds the limit. This property is not supported by Internet Explorer 8 and 9. Defines the allowed MIME types of files to be uploaded. The chosen files will be checked against an array of MIME types. If at least one file does not fit the MIME type requirements, the upload is prevented. This property is not supported by Internet Explorer 8 and 9. Example: mimeType ["image/png", "image/jpeg"]. Lets the user select multiple files from the same folder and then upload them. Internet Explorer 8 and 9 do not support this property. Please note that the various operating systems for mobile devices can react differently to the property so that fewer upload functions may be available in some cases. If multiple property is set to false, the control shows an error message if more than one file is chosen for drag & drop. Allows you to set your own text for the 'No data' text label. Allows you to set your own text for the 'No data' description label. Allows the user to use the same name for a file when editing the file name. 'Same name' refers to an already existing file name in the list. Defines whether separators are shown between list items. Enables the upload of a file. Specifies the URL where the uploaded files have to be stored. If false, no upload is triggered when a file is selected. In addition, if a file was selected, a new FileUploader instance is created to ensure that multiple files from multiple folders can be chosen. Sets the title text in the toolbar of the list of attachments. To show as well the number of attachments in brackets like the default text does. The number of attachments could be retrieved via "getItems().length". If a new title is set, the default is deactivated. The default value is set to language-dependent "Attachments (n)". Defines the selection mode of the control (e.g. None, SingleSelect, MultiSelect, SingleSelectLeft, SingleSelectMaster). Since the UploadCollection reacts like a list for attachments, the API is close to the ListBase Interface. sap.m.ListMode.Delete mode is not supported and will be automatically set to sap.m.ListMode.None. In addition, if instant upload is set to false the mode sap.m.ListMode.MultiSelect is not supported and will be automatically set to sap.m.ListMode.None. If true, the button used for uploading files is invisible. If true, the button that is used to terminate the instant file upload gets visible. The button normally appears when a file is being uploaded. The event is triggered when files are selected in the FileUploader dialog. Applications can set parameters and headerParameters which will be dispatched to the embedded FileUploader control. Limitation: parameters and headerParameters are not supported by Internet Explorer 9. A unique Id of the attached document. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. A FileList of individually selected files from the underlying system. See www.w3.org for the FileList Interface definition. Limitation: Internet Explorer 9 supports only single file with property file.name. Since version 1.28.0. The event is triggered when an uploaded attachment is selected and the Delete button is pressed. A unique Id of the attached document. This parameter is deprecated since 1.28.0. Use the <code>item</code> parameter instead. Use the <code>item</code> parameter instead. An item to be deleted from the collection. Since version 1.28.0. The event is triggered when the name of a chosen file is longer than the value specified with the maximumFilenameLength property (only if provided by the application). A unique Id of the attached document. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. A FileList of individually selected files from the underlying system. Limitation: Internet Explorer 9 supports only single file with property file.name. Since version 1.28.0. The event is triggered when the file name is changed. A unique Id of the attached document. This parameter is deprecated since 1.28.0. Use the <code>item</code> parameter instead. Use the <code>item</code> parameter instead. The new file name. This parameter is deprecated since 1.28.0. Use the <code>item</code> parameter instead. Use the <code>item</code> parameter instead. The renamed UI element as an UploadCollectionItem. Since 1.28.0. The event is triggered when the file size of an uploaded file is exceeded (only if the maxFileSize property was provided by the application). This event is not supported by Internet Explorer 9. A unique Id of the attached document. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. The size in MB of a file to be uploaded. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. A FileList of individually selected files from the underlying system. Limitation: Internet Explorer 9 supports only single file with property file.name. Since 1.28.0. The event is triggered when the file type or the MIME type don't match the permitted types (only if the fileType property or the mimeType property are provided by the application). A unique Id of the attached document. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. File type. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. MIME type. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. A FileList of individually selected files from the underlying system. Limitation: Internet Explorer 9 supports only single file. Since 1.28.0. The event is triggered as soon as the upload request is completed. Ready state XHR. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. Response of the completed upload request. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. Status Code of the completed upload event. This parameter is deprecated since 1.28.0. Use the <code>files</code> parameter instead. Use the <code>files</code> parameter instead. A list of uploaded files. Each entry contains the following members. fileName : The name of a file to be uploaded. response : Response message which comes from the server. On the server side, this response has to be put within the 'body' tags of the response document of the iFrame. It can consist of a return code and an optional message. This does not work in cross-domain scenarios. reponse : deprecated Since version 1.48.0. This parameter is deprecated, use parameter response instead. responseRaw : HTTP-Response which comes from the server. This property is not supported by Internet Explorer Versions lower than 9. status : Status of the XHR request. This property is not supported by Internet Explorer 9 and lower. headers : HTTP-Response-Headers which come from the server. Provided as a JSON-map, i.e. each header-field is reflected by a property in the header-object, with the property value reflecting the header-field's content. This property is not supported by Internet Explorer 9 and lower. Since 1.28.0. The event is triggered as soon as the upload request was terminated by the user. Specifies the name of the file of which the upload is to be terminated. This callback function returns the corresponding header parameter (type sap.m.UploadCollectionParameter) if available. The event is triggered before the actual upload starts. An event is fired per file. All the necessary header parameters should be set here. Specifies the name of the file to be uploaded. Adds a header parameter to the file that will be uploaded. Returns the corresponding header parameter (type sap.m.UploadCollectionParameter) if available. Fires when selection is changed via user interaction inside the control. The item whose selection has changed. In <code>MultiSelect</code> mode, only the topmost selected item is returned. This parameter can be used for single-selection modes. Array of items whose selection has changed. This parameter can be used for <code>MultiSelect</code> mode. Indicates whether the <code>listItem</code> parameter is selected or not. Uploaded items. Specifies the header parameters for the FileUploader that are submitted only with XHR requests. Header parameters are not supported by Internet Explorer 8 and 9. Specifies the parameters for the FileUploader that are rendered as a hidden input field. Specifies the toolbar. Specifies the info toolbar for filtering information. Sorting information will not displayed. Internal aggregation to hold the list in controls tree. The icon is displayed in no data page Internal aggregation to hold the drag and drop icon of indicator. Internal aggregation to hold the drag and drop text of indicator.