Skip to content

# Attachment field

An attachment field type can be used to attach additional information to a document such as images, photos, text documents or other files. All file types are supported.

Note : Please be aware that some browsers may block downloads. For instance, Chrome shows the popup blocker icon ( ) when downloads are blocked.

Note : When you upload attachments on your mobile device, ensure that the app runs in the foreground untill all uploads have been completed. When you close the app, you mobile operating system will terminate the upload.

Note : Attachments can have a maximimum file size of 5 Gb.

### Properties

Setting | Required | Description
--- | --- | ---
Label | Yes | The label is used for users of BizzStream. The label is shown in documents left to the value of the field.
Translation key | No | Can be used to replace the field label with a translation .
Name | Yes | The name is a BizzStream system field. Once the document definition is persisted, this field cannot be edited anymore.

### How the data is stored

The meta data of the attachments is stored as array in the database. Each object represents a single attachment:

    attachmentField:[
        {
            "_id":"b19c516f5c0a55afac85c934",
            "_fileName":"cdv_photo_001.jpg",
            "store":"image",
            "_size":5781513,
            "_width":4032,
            "_height":3024
        }
    ]

The attachments themselves are stored as object in an Amazon S3 Bucket.

### Upload multiple photos / images

It is possible by making use of a mobile device to upload multiple photos / images by making use of the camera or library (gallery).

Camera

A mobile Android device makes it possible to take and upload multiple photos in a row (maximum of 10) by using the camera of the device (Button 'Take photo'). When it is desirable to upload less photos the user is able to cancel the capture mode by pressing the 'back' button on the device.

Library / Gallery

Both a mobile Android and an iOS device will provide the functionality of uploading multiple images from the library ('Photo' library button). When it is desirable to upload less images the user is able to cancel the capture mode by pressing the 'back' button on the device.

Option | Description
--- | ---
| Click to activate the camera on your device. On Android you can take multiple photo's in one go.
| Click to upload images from your device.
| Click to upload documents from your device.

# Uploading attachments on Mobile and Desktop - Differences

When uploading a new attachment on desktop and your facing internet connection drop, then you do not need to worry about your uploading progress because it will resume right after your connection is up again. As a mobile user, you need to know that if your uploading an attachment and your internet connection drops, you will be able to see a "Warning" on your app that the upload failed and you just need to restart it from the "Uploads Tracker" window.