Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
borderColorgreen
borderWidth1
titleBGColor#ddffcc
borderStylesolid
titleDefinition

Form Element is a type of plugin that is extensible via Joget's plugin architecture. Form Element is responsible for providing the end users form input elements to interact with.

There are many different form fields (i.e., TextField, SelectBox, Hidden Field, etc.) to choose from when your are designing your forms.  

You can drag-and-drop them on your form canvas and then edit their properties. 


English
Each form element has its own set of attributes, ID and Label attributes are common to most of them.


Figure 1: Text Field Properties

ID

The 'ID' in the property editor is a unique identifier.
The Joget Workflow core uses this ID as a column name within the table associated to with the form (e.g. c_title in the figure above).
When a user enters a value in the field during a workflow process, the value is stored in that column.
If the ID has never been used in previous forms associated to the same table, a new column will be created.
If the ID, on the other hand, has been used before, that column will be used. 
It is important to note that when someone enters a value when completing a form during a workflow process, that value will overwrite the existing one.

Warning
titleReserved IDs

Do not use the following reserved IDs . "appId, appVersion, version, userviewId, menuId, key, embed" on the form element's ID attribute.on the form element's ID attribute:

  • id     (can be used, but with caution)
  • appId
  • appVersion
  • version
  • userviewId
  • menuId
  • key
  • embed
  • primaryKey
Warning
titleAuto Generated IDs

Take note of the following IDs as these are automatically generated upon the creation of a new form. Please take note upon submission of the form in runtime, these fields will be updated automatically:

  • dateCreated
  • dateModified
  • createdBy
  • createdByName
  • modifiedBy
  • modifiedByName
Info
titleRecommended Naming Convention

We recommend the use of snake case (i.e. first_name) as this is the standard database naming convention. The ID declared will be part of the database table column name.

Label

"Label" is the human-readable identifier for the form field.

...