Hints

Calendar Widget

Depending on the context you may want to hide the New Calendar Entry button when using the calendar widget on a form:

• Set the header > showNewButton property to false.

To specify another menu to be displayed when clicking the New Calendar Entry button:

• Use the menuItem property to specify another than the default menu M_CalNew.

Getting a Tree's Root Record in a Form

In order to get the uid of the tree's root record in a form you have to use a binding where Source = "#rootUid". Example in UPDATE_DEFAULT: RecordHistory widget.

Grouping Radio Buttons/Toggle Buttons on a Form

Use the groupName and groupValue properties to manage the value of a group of radio buttons or toggle buttons. Radio/toggle buttons with the same groupName are considered as grouped. This means activating a button from a group deacitvates the other buttons in the group. Use the groupValue property to pass the value of currently selected button to some other widget.

"radioButton1": {
	"type": "RadioButton",
	"options": { "groupName": "groupradio1", "value": "0" },
	"binding": [
		{
		"sourcePath": [ "#radio1" ],
		"targetPath": [ "@groupValue" ]
		}
	]
},
"radioButton2": {
	"type": "RadioButton",
	"options": { "groupName": "groupradio1", "value": "1" },
	"binding": [
		{
		"sourcePath": [ "#radio1" ],
		"targetPath": [ "@groupValue" ]
		}
	]
}

Example in UPDATE_DEFAULT: The Daily/Weekly radio buttons on the Recurring form.

List Widgets

All properties used to configure the functionality and appearance (header, default action, menu, etc.) of the various list widgets (SearchView, RecordListBox, QueryResultPresenter, etc.) can be found in the grid property group.

ListView Widget

When defining forms with "hierarchical" lists (e.g. to display records from FI, KP and MA) you can hide ListView widgets for which no parent record is selected:

1. Check the hideIfNoLink property.
2. Also check autoLoad. Otherwise the ListView widget's header would still be displayed.

hideIfNoLink is also available for the RecordListBox widget.

RecordListBox Widget

When using a RecordListBox widget in a DashboardPanel and wanting to hide the DashboardPanelItem in case the RecordListBox contains no results:

1. Set the hideItemsIfEmpty property of the DashboardPanel widget to true. For further details, see Configuring Dashboards.
2. Set the hideIfEmpty property of the RecordListBox to true.

RecordTreeView

To use a RecordTreeView widget in a form:

• make sure to specify a root record for the tree by setting a valid uid,
• set a height under css, otherwise the widget is not displayed.

SearchView Widget

To hide the With me button:

• Set the form > showOwnItems property to false.

To manage the search history for two SearchView widgets which use the same Search&List configuration:

• Use the form > historyNamespace property. This saves separate search histories for each widget.

  You need to define a unique value for historyNamespace for each SearchView widget if you use two searches with the same Search&List configuration but e.g. different fixed filters on one form. Otherwise, the second filter is never applied as the searches share the same cache.