Introduction

Get Started

The easiest way to see how the Multi Select Box works is to create a new app. Here are the steps:

...

1. Start the Joget Server and open the App Center.
   
   
2. Log in as admin and click on the Design New App button. (see Figure 1)
   
   Image Added
   Figure 1
   
   
3. Fill up the App Details as follows and click Save (see Figure 2):
   1. App ID: tutorial
   2. App Name: Tutorial
   
   Image Added
   Figure 2
   
   
4. You will be directed to the Design App. Click on the Create New Form button and fill up the Form Details as follows (see Figure 3):
   
   1. Form ID: mulltiSb
   2. Form Name: Multi Select Box
   3. Table Name: tutorial
   
   Image Added
   Figure 3
   
   
5. Click on Save and you will be directed to the  Form Builder.
   
   
6. Drag and drop a Multi Select Box element on to the canvas.
   
   
7. Hover the mouse over the Multi Select Box element on the canvas and click on Edit to open up the Edit Multi Select Box properties.
   
   

8. Fill up the Options Hardcoded field as follows and click on OK (see Figure 4):

   Default Value	Label
   Local	Local
   International	International

   Image Added
   Figure 4
   
   

9. Click on Preview,

...

1.  try typing one of the labels and/or selecting both options to see it working.

...

^{Image Removed}

^{Figure 1}

Image Removed

^{Figure 2}

Image Removed

^{Figure 3}

Image Removed

...

Multi Select Box Properties

Edit Multi Select Box

Image Added

Image Removed

Name	Description	Screen (Click to view)
ID	Element ID (By declaring as "country", a corresponding database table column "c_country" will be created)	Please see Form Element for more information about defining the ID and list of reserved IDs.
Label	Element Label to be displayed to the end-user.
Options (Hardcoded)	Select Box options Info Options defined here will not be put into use if Options Binder is defined below.
Or Choose Options Binder	Options to be populated dynamically using Options Binder plugin. Warning title Performance Warning If you have thousands of select options or sourcing them from Options Binder, this may cause a significant increase in page load time. Consider using Popup Select Box instead.

Advanced Options

Data

Image Added

#currentUser.firstName# #currentUser.lastName#

option1;option2;option3

Dependency

Image Added

Name	Description	Screen (Click to view)
Field ID to control available options based on Grouping	Dynamically change the available options based on the "grouping" attribute defined in the options by matching the current value of the element ID defined. Image Removed

UIUI

Image Added

200px

Validation

Image Added

Name	Description	Screen (Click to view)
Validator	Attach a Validator plugin to validate the input value. Info title When will validation takes place? Validation will take place whenever a form is submitted except when it is submitted as "Save as Draft". Image Removed

WorkflowWorkflow

Image Added

Name

DescriptionScreen (Click to view)

Workflow Variable

If the form is part of a workflow process, upon saving of the form (by clicking on "Save as Draft" or "Complete" button). The value in this input field will be saved into the corresponding workflow variable named here. Info title Using a non-existent Workflow Variable name You will get the following warning with the name printed out (e.g. status) in the server log if you attempt to map to a non-existent Workflow Variable. Code Block context attribute status does not exist in process context - adding new attributes to the process context is not allowed Image Removed

Related Video Tutorials

...