Skip to content

Latest commit

 

History

History
94 lines (54 loc) · 4.03 KB

enabling-the-upload-functionality-d59dbec.md

File metadata and controls

94 lines (54 loc) · 4.03 KB

Enabling the Upload Functionality

The SAP Fiori elements Table building block provides a built-in upload functionality that allows users to upload files to the server. The user can to the following:

  • Upload files either by dragging and dropping them onto the table, or by clicking the Upload button

  • Download the uploaded files by clicking on the file name in the table

  • Delete the uploaded files by selecting the lines and clicking on the Delete button, or by using the table's context menu

Uploading and deleting is only available in edit mode.

Note:

To avoid security issues, you must enable SAP Fiori elements to check for allowed file types. To do that, define @Core.AcceptableMediaTypes. The back-end service framework must ensure a virus scan and other security measures, such as maximum file size limitations and MIME-type restrictions, are in place.

Prerequisites

To enable upload functionality, ensure the following prerequisites are met:

  • The entity type must have an Edm.Stream type property that is used to store the uploaded file.

  • The UI.LineItem annotation must contain a reference to the Edm.Stream type property that is used to store the uploaded file.

  • The entity type must have the UI.MediaResource annotation with the Stream property referencing the Edm.Stream type property that is used to store the uploaded file.

Here is an example of how to define the entity type with the required annotations:

Sample Code:

XML Annotation

<Annotations Target="Namespace.EntityType">
    <Annotation Term="UI.LineItem">
        <Collection>
            <Record Type="UI.DataField">
                <PropertyValue Property="Value" Path="PropertyOfEdmStreamType"/>
                <PropertyValue Property="Label" String="File"/>
            </Record>
        </Collection>
    </Annotation>
    <Annotation Term="UI.MediaResource">
        <Record Type="UI.MediaResourceType">
            <PropertyValue Property="Stream" Path="file"/>
        </Record>
    </Annotation>
</Annotations>

Sample Code:

ABAP CDS Annotation

No ABAP CDS annotation sample is available. Please use the local XML annotation.

Sample Code:

CAP CDS annotation

You can use the Attachments plug-in to define the entity type. For more information about the plug-in, see Attachments.

Check out our live example in the flexible programming model explorer at Table - File Upload.

Additional Configuration

Add Additional Columns and Actions to the Table

You can add additional columns and actions to the table by either defining further UI.LineItem annotations or by adding custom columns and actions into the manifest.json, as described in Defining Line Items.

Control the Visibility and Enablement of the Upload Button

You can control the visibility and the enablement of the Upload button in the same way as you can control the Create button for any other table. A new instance is created through uploading a file, so the Upload button has the same semantic meaning as the Create button. For more information about controlling the visibility and enablement of the Create button, see Adding Actions to Tables.

Restrict File Type and Size

The back-end service framework must ensure a virus scan and other security measures, such as maximum file size limitations and MIME-type restrictions, are in place.

You can restrict the file type and the size of the files to be uploaded with the MaxLength and Core.AcceptableMediaTypes annotation, as described in Enabling Stream Support.