Others

This group consists of components such as Form Launcher, HTML, Hidden, History, IFrame, Vertical Space, Workflow, etc.

Attachments

The Attachments component allows you to attach files onto the form. It has the following properties.

Field Description Default
Id Name of the component that will be displayed in the form structure. “attachmentX”
Label Name of the component that will be displayed in the form. None
Store Location where the attached file is stored. None
Target Path of the file content to appear in. None
Visible Rows Number of rows in the form. “5”

To test the form, click on the “More Actions” icon at the top row and select the “Run Form” option. The form will appear in another tab.

To attach a file, click on the “+” icon at the right of the Attachment component. The “Add Attachment” dialog box will appear.

Browse to the location of the file to be attached. The name of the selected file is used by default in the “Name” field. Change the name if it is not desired. Click on the “OK” button to attach the file.

Once uploaded, the name of the attached file appears in the Attachment component along with the “Open Attachment” icon and “Delete Attachment” icon on the right. You can add more files by clicking on the “+” again.

To open the attached file, click on the icon and the content of the file will be displayed according to the value in the “Target” field in the component properties.

To delete the attached file, click on the icon and a dialog box with warning messages will appear.

To confirm deletion, click on the “OK” button. Click on the “Cancel” button to abort.

Form Launcher

The Form Launcher component allows you to launch another form from the current form by clicking on the rows on the current form.

It has the following properties.

Field Description Default
Id Name of the component that will be displayed in the form structure. “form-launcherX”
Label Name of the component that will be displayed in the form. None
Form Selects a form from the Forms page through a drop-down list. None
Workflow Selects a workflow from the Workflows page through a drop-down list. None
Columns The columns to be displayed in the form. None
Sort Field The field from elxPublic to sort the records. None
Sort Ascending If selected, sort the field in ascending order. Selected
Matching Field The field to filter the records listed. None
Target The path which the form content to appear in. None
Visible Rows Number of rows in the form. “5”

Refer to Examples for a simple example on how to create a form with form launcher.

HTML

The HTML component allows you to add a HTML onto the form. It can be text, web page, logo, etc. It has the following properties.

Field Description Default
Id Name of the component that will be displayed in the form structure. “htmlX”
Label Name of the component that will be displayed in the form. None
HTML HTML code to be entered. None

In the below example, a logo is to be added onto the form. To do so, enter the HTML code <img src="logo.png"> in the “HTML” field.

Hidden

The Hidden component allows you to store information in the form which is not visible to the user or use this . You can use this component for version control of the form, for example. a value of “1” means version 1 of the form and a value of “2” means version 2 of the form, etc. These values allow the designer to know which version of the form the user is using.

It has the following properties.

Field Description Default
Id Name of the component that will be displayed in the form structure. “hiddenX”
Value Information to be stored. None

History

The History component allows you to include history information (such as user, timestamp and result) in the form.

It has the following properties.

Field Description Default
Id Name of the component that will be displayed in the form structure. “historyX”
Label Name of the component that will be displayed in the form. None
Visible Rows Number of rows to be displayed. “5”

IFrame

The IFrame component allows you to embed another HTML document into the form. It has the following properties.

Field Description Default
Id Name of the component that will be displayed in the form structure. “iframeX”
Label Name of the component that will be displayed in the form. None
Width Width of the IFrame. “800px”
Height Height of the IFrame. “600px”
Source Path of the HTML. None
Help Text Text that will be displayed below the IFrame. None

The IFrame component is the same as the IFrame view in Dashboards. See IFrame view for more details on how to customise the HTML path.

Image

The Image component allows you to add a placeholder to load an image into the form with a workflow. It has the following properties.

Field Description Default
Id Name of the component that will be displayed in the form structure. “imageX”
Label Name of the component that will be displayed in the form. None
Height Height of the image placeholder. “200px”
Store Location where the image file is stored. “default”

To test the form, click on the “More Actions” icon at the top row and select “Run Form”. In the “Run Form” dialog box, select the desired workflow. The form with the Image component will appear with a “…” icon at the far right.

Click on the “…” icon to display the “Set Image” dialog box.

In the dialog box, browse to the location of the image file. The “Name” field takes the filename by default, change if the name is not desired. Click on the “OK” button to load the image or click the “Cancel” button to abort the action.

Upon successful uploading, the image will appear in the form.

You can reselect the image by clicking on the “…” icon.

To remove the image, click on the “Delete” icon. The “Delete Image” dialog box will appear with a warning message. To confirm, click on the “OK” button. Click on the “Cancel” button to abort.

Do note that the Image component works only when run with a workflow. If no workflow is selected in “Run Form” dialog box, the Image component will appear in the form without the “…” icon to load an image.

Vertical Space

The Vertical Space component allows you to add white space in the form, creating space between components.

It has the following properties.

Field Description Default
Id Name of the component that will be displayed in the form structure. “htmlX”
Label Name of the component that will be displayed in the form. None
Height Height of the vertical space. None

Workflow State

The Workflow State component allows you to add an existing workflow onto the form. The workflow will not appear in the form, but act as an interface to the workflow. It has the following properties.

Field Description Default
Id Name of the state of the workflow that will be used with the form. “elxState.X”

Ensure the Workflow and the form has the same name and X is the name of the state in the workflow.