Versions Compared

Old Version 1

changes.mady.by.user Justin

Saved on

compared with

New Version 2

changes.mady.by.user Aadrian Zarin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
Definition
borderColorgreenpurple
borderWidth1
titleBGColor#ddffcc#ddccff
borderStylesolid
titleNew Feature

This feature is enhanced in Joget DX to support image resizing options


Table of Contents

Introduction

Image Upload is designed to cater to images. Uploaded images will be displayed according to dimensions set.

Panel
borderColorpurple
borderWidth1
titleBGColor#ddccff
borderStylesolid
titleNew Feature

This feature is enhanced in Joget Workflow v6 to support multiple file upload as well as drag and drop file upload.

...

The Image Upload is only available on Professional and Enterprise Edition.

Get Started

The easiest way to see how the ImageUpload works are to use the existing built-in App Expenses Claims. Here are the steps:

StepsScreens (Click to view)
  1. Start the Joget Server and open the App Center.

  2. Log in as admin and click on the pencil icon on the Expenses Claim to open the Design App. (see Figure 1)

  3. Click on  Expense Claim Form and you will be directed to the  Form Builder. 

  4. Drag and Drop an Image Upload element on the canvas and click on Edit to open up the Edit Image Upload properties. 


  5. Click on UI, tick on Enable Multiple Files Upload checkbox and click OK. (see Figure 2)


  6. Click on Preview, click inside the box to upload or drag and drop images inside the box.

Image Added

Figure 1


Image Added

Figure 2

Image Upload Properties

Edit Image Upload

NameDescriptionScreen (Click to view)

Figure 1: Screenshot highlighting Image Upload in Form Builder

Image Removed

Figure 2: Screenshot highlighting Image Upload with image uploaded in actual Form

Image Removed

Figure 3: Image Upload Properties

NameDescription
IDElement ID (By declaring as "photo", a corresponding database table column "c_photo" will be created)

Image Added

LabelElement Label to be displayed to the end-user.

...

UI

Image Removed

Figure 4: Image Upload Properties - UI

General

NameDescriptionScreen (Click to view)
Allowed multiple files upload?When checked, multiple files can be uploaded.

Image Added

Readonly

Determines if the element is editable.

Drop zone padding

Determine the extra size of padding for the larger drop zone.

Info
titleExample

50px

Info
titleExample

5%

Image Display

NameDescriptionScreen (Click to view)
Width (px)Width in integer

Image Added

Height (px)Height in integer
Create Thumbnail?Determines if the element will create a thumbnail and show it below the upload file element after an image is uploaded.

...

Image Removed

...

Advanced Options

Data

NameDescriptionScreen (Click to view)
Validator

Attach a Validator plugin to validate the input value.

Info
titleWhen will validation takes place?

Validation will

takes

take place whenever a form is submitted except when it is submitted as "Save as Draft".

Image Added

Maximum File Size (kb)Maximum File Size (KB) in Integer.
Error Message (File size limit exceeded)Error Message when file size exceeded.
Image File Type

Accepted file extension(s). (Semicolon separated values)

Code Block
titleExample
.png;.jpg
Error Message (File type mismatch)Error Message when file type mismatched.
Delete actual file during overwrite or remove?
 Actual

 The actual file will be deleted when a file is removed or being overwritten.

Info
titleNew Feature

Newly introduced in Joget Workflow v6


Image Resize

NameDescriptionScreen (Click to view)
Maximum Width (px)

If set, images will be resized to these dimensions before being uploaded.

Info
iconfalse
titleNote

If only one, Maximum Width (px) or Maximum Height (px), the original aspect ratio of the file will be preserved.

Image Added

Maximum Height (px)

If set, images will be resized to these dimensions before being uploaded.

Info
iconfalse
titleNote

If only one, Maximum Width (px) or Maximum Height (px), the original aspect ratio of the file will be preserved.

Quality (Max 1.0)set the quality of the resized image.
Method

sets how the images should be scaled down in case both Maximum Width (px) and Maximum Height (px) are provided.

There are only two methods:

  • contain

  • crop 

    Info
    iconfalse
    titleNote

    By default, it will set to contain.

Permission

...

NameDescriptionScreen (Click to view)
Permission

 Manage on who is able to access the file uploaded. Read more at Permission Control.

 

Image Added