Chapter III. SJS Front reference

permId

String

Sets the permanent identifier to this application element. Permanent identifiers are used by different framework parts, like dynamic security or record/replay controllers to uniquely identify an application element. Permanent identifiers are generated by the SJS build based on the element id but must be explicitely set if Spring XML is used.

grantedRoles

ListOfString

Assigns the roles that are authorized to use this view. Whenever the user is not granted sufficient privileges, the view is replaced by an empty section at runtime. It supports "!" prefix to negate the role(s). Setting the collection of granted roles to null (default value) disables role based authorization on the view level. The framework then checks for the model roles authorizations and will apply the same restrictions. If both view and model granted roles collections are null, then access is granted to anyone.

booleanWritabilityGates

ListOfString

Assigns a collection of gates to determine view writability. A view will be considered writable (updatable) if and only if all boolean gates are open.

form 'form1', booleanWritabilityGates: ['prop1', '!prop2']

This mecanism is mainly used for dynamic UI authorization based on model state, e.g. a validated invoice should not be editable anymore. View assigned gates will be cloned for each view instance created and backed by this descriptor. So basically, each view instance will have its own, unshared collection of writability gates. By default, view descriptors are not assigned any gates collection, i.e. there is no writability restriction. Note however that view actual writability is the combination of view and model writability.

rolesWritabilityGates

ListOfString

Assigns a collection of gates to determine view writability. A view will be considered writable (updatable) if and only if the user role matches at least one of the role.

form 'form2', rolesWritabilityGates: ['role1', '!role2']

The mecanism is different from booleanWritabilityGates since only one role condition has to be matched to open the gate. In the example, if the user has role1 OR does not have role2, then the access is granted.

enumWritabilityGates

MapOfListOfString

Assigns a collection of gates to determine view writability. A view will be considered writable (updatable) if and only if all enum gates are open.

form 'form1', enumWritabilityGates: ['prop1':['VAL1','VAL2'], '!prop2':['VAL3']]

This mecanism is mainly used for dynamic UI authorization based on model state, e.g. a validated invoice should not be editable anymore. View assigned gates will be cloned for each view instance created and backed by this descriptor. So basically, each view instance will have its own, unshared collection of writability gates. By default, view descriptors are not assigned any gates collection, i.e. there is no writability restriction. Note however that view actual writability is the combination of view and model writability.

regexWritabilityGates

MapOfString

Assigns a collection of gates to determine view writability. A view will be considered writable (updatable) if and only if all regex gates are open.

form 'form1', regexWritabilityGates: ['prop1':'[A-Z]*', '!prop2':'[a-z]*']

This mecanism is mainly used for dynamic UI authorization based on model state, e.g. a validated invoice should not be editable anymore. View assigned gates will be cloned for each view instance created and backed by this descriptor. So basically, each view instance will have its own, unshared collection of writability gates. By default, view descriptors are not assigned any gates collection, i.e. there is no writability restriction. Note however that view actual writability is the combination of view and model writability.

model

RefDomain

modelDescriptor

Assigns the model descriptor backing the view. The model descriptor serves several purposes :

Although it is the developer responsibility to make sure the correct model descriptor is assigned to the view, there are cases where the framework will infer it. For instance, a composite view will by default transmit its model descriptor to its children that do not have their model descriptor explicitely set. This allows for setting the model descriptor only on the composite view and keep default null value on the children as an implicite model inheritance enablement. Most of the time it is not necessary to explicitly use the property model. By convention, with SJS, the name of the componant is prefixed by the name of the model. In the following example SJS automatically determines that the form uses the entity "Company"

form 'Company.pane', ...

validationModel

RefDomain

This property is SJS specific. It allows to enforce SJS controls without actually assigning a model to the generated view. This is especially useful when overriding the default result table view on collection modules where the table model is determined at runtime.

icon

String

iconImageURL

Sets the icon image URL of this descriptor. Supported URL protocols include :

iconWidth

Integer

iconPreferredWidth

Allows to define a custom width for the icon. In that case, the default dimension computed by the view factory is ignored.

iconHeight

Integer

iconPreferredHeight

Allows to define a custom height for the icon. In that case, the default dimension computed by the view factory is ignored.

styleName

String

Assigns the style name to use for this view. The way it is actually leveraged depends on the UI channel. It will generally be mapped to some sort of CSS style name. Default value is null, meaning that a default style is used.

name

String

Sets the name of this descriptor. Name is used in conjunction with the Jspresso i18n layer so that the name property set here is actually an i18n key used for translation.

description

String

Sets the description of this descriptor. Most of the descriptor descriptions are used in conjunction with the Jspresso i18n layer so that the description property set here is actually an i18n key used for translation. Description is mainly used for UI (in tooltips for instance) but may also be used for project technical documentation, contextual help, ...

i18nNameKey

String

Sets i18n key used for translation if it is different from the description

actionMap

RefActionMap

Assigns the view action map on top of the view. An action map is generally represented as a toolbar attached to the view. The toolbar follows the structure of the action map :

Depending on the UI channel, the view action map may also be replicated in a component contextual menu. In that case, the translated action name is used to label each menu item. The same grouping rules apply for the contextual menu than for the toolbar.

secondaryActionMap

RefActionMap

Assigns the view a secondary action map at the bottom of the view

readOnly

Boolean

Allows to set a view read-only, i.e. none of the view part will allow for updating the underlying model. This is mainly a shortcut to assigning an "always closed" writability gate. One difference though is that , since the framework knows that the view will never be updatable, it may take specific decisions to render properties in a slightly different way, e.g. instead of using a disabled textfied, use a label. Default value is false, i.e. view is updatable.

background

String

Sets the background color of the UI component. The color must be defined using its string hexadecimal representation (0xrgba encoded) Default value is null, meaning use UI default.

foreground

String

Sets the foreground color of the UI component. The color must be defined using its string hexadecimal representation (0xrgba encoded) Default value is null, meaning use UI default.

font

String

Allows to customize the font used by the UI component. The font must be string encoded using the pattern "[name];[style];[size]" :

Any of the above pattern section can be left empty, thus falling back to the component default. Default value is null, meaning use default component font.

borderType

String

Sets the border type of the view. This is either a value of the EBorderType enum or its equivalent string representation :

Default value is EBorderType.NONE, i.e. no border.

preferredWidth

Integer

Allows to set a preferred width (in pixels) for the created peer UI component. This will override default and give hints to the UI layouting system.

preferredHeight

Integer

Allows to set a preferred height (in pixels) for the created peer UI component. This will override default and give hints to the UI layouting system.

paramSets

ListOfString

paramSets makes it possible to use a list of paramSet. The properties declared in the paramSet come to be added to the properties of the current descriptor. The properties brought by the paramSet can be overridden by the current descriptor. If a property is overridden with the null value the property is ignored.

model

RefDomain

modelDescriptor

Assigns the model descriptor backing the view. The model descriptor serves several purposes :

Although it is the developer responsibility to make sure the correct model descriptor is assigned to the view, there are cases where the framework will infer it. For instance, a composite view will by default transmit its model descriptor to its children that do not have their model descriptor explicitely set. This allows for setting the model descriptor only on the composite view and keep default null value on the children as an implicite model inheritance enablement. Most of the time it is not necessary to explicitly use the property model. By convention, with SJS, the name of the componant is prefixed by the name of the model. In the following example SJS automatically determines that the form uses the entity "Company"

form 'Company.pane', ...

validationModel

RefDomain

This property is SJS specific. It allows to enforce SJS controls without actually assigning a model to the generated view. This is especially useful when overriding the default result table view on collection modules where the table model is determined at runtime.

icon

String

iconImageURL

Sets the icon image URL of this descriptor. Supported URL protocols include :

styleName

String

Assigns the style name to use for this view. The way it is actually leveraged depends on the UI channel. It will generally be mapped to some sort of CSS style name. Default value is null, meaning that a default style is used.

name

String

Sets the name of this descriptor. Name is used in conjunction with the Jspresso i18n layer so that the name property set here is actually an i18n key used for translation.

description

String

Sets the description of this descriptor. Most of the descriptor descriptions are used in conjunction with the Jspresso i18n layer so that the description property set here is actually an i18n key used for translation. Description is mainly used for UI (in tooltips for instance) but may also be used for project technical documentation, contextual help, ...

i18nNameKey

String

Sets i18n key used for translation if it is different from the description

actionMap

RefActionMap

Assigns the view action map on top of the view. An action map is generally represented as a toolbar attached to the view. The toolbar follows the structure of the action map :

Depending on the UI channel, the view action map may also be replicated in a component contextual menu. In that case, the translated action name is used to label each menu item. The same grouping rules apply for the contextual menu than for the toolbar.

secondaryActionMap

RefActionMap

Assigns the view a secondary action map at the bottom of the view

readOnly

Boolean

Allows to set a view read-only, i.e. none of the view part will allow for updating the underlying model. This is mainly a shortcut to assigning an "always closed" writability gate. One difference though is that , since the framework knows that the view will never be updatable, it may take specific decisions to render properties in a slightly different way, e.g. instead of using a disabled textfied, use a label. Default value is false, i.e. view is updatable.

borderType

String

Sets the border type of the view. This is either a value of the EBorderType enum or its equivalent string representation :

Default value is EBorderType.NONE, i.e. no border.

paramSets

ListOfString

paramSets makes it possible to use a list of paramSet. The properties declared in the paramSet come to be added to the properties of the current descriptor. The properties brought by the paramSet can be overridden by the current descriptor. If a property is overridden with the null value the property is ignored.

position

String

Allows define where, if the layout allows it, to drop the page section in the composite page. Allowed values are LEFT, RIGHT, TOP or BOTTOM

clientTypes

ListOfString

forClientTypes

Gets the restricted list of client types that will display this property view. Defaults to null, which means no restriction. The provided list is not empty, then the actual session client type is matched against each of the restricted client type with either equal or substring or regexp semantic. Allowed values are DESKTOP_SWING, DESKTOP_FLEX, DESKTOP_HTML5, MOBILE_HTML5_TABLET, MOBILE_HTML5_PHONE or any substring or regex like DEFKTOP, MOBILE, HTML5, ...

mainAction

RefAction

Installs the main action for the page. It is generally displayed in the page main toolbar, i.e. top right.

enterAction

RefAction

Configures an action to be trigerred when the user enters the page.

backAction

RefAction

Configures an action to be trigerred when the user leaves the page using the back button of the main toolbar.

pageEndAction

RefAction

Configures an action to be trigerred when the user scrolls to the end of the page.

swipeLeftAction

RefAction

Configures an action to be trigerred when the user swipes the page left.

swipeRightAction

RefAction

Configures an action to be trigerred when the user swipes the page right.

parent

RefView

Allows to use an other descriptor as a model and to override certain properties.

label

RefField

Configures the model property name to use as label field on the chart.

legend

Boolean

legendVisible

Configures the visibility of the legend block on the chart. Default value is true, which means that a legend block is created and visible.

rowAction

RefAction

Registers an action that is implicitely triggered everytime the user activates a series (e.g. double-clicked for current UI channels) on the chart view UI peer. The context of the action execution is the same as if the action was registered in the view action map.

itemSelectionAction

RefAction

Registers an action that is implicitely triggered everytime the user selects a series. The context of the action execution is the same as if the action was registered in the view action map.

autoSelectFirstRow

Boolean

Configures the default selection that gets applied when the content of the collection view changes. Whenever set to true, the 1st row will be automatically selected, whereas nothing happens whe set to false. The default value depends on the selection mode of the collection view. When a cumulative selection mode is used, autoSelectFirstRow defaults to false. It defaults to true otherwise.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

labelsPosition

String

Instructs Jspresso where to place the fields label. This is either a value of the ELabelPosition enum or its equivalent string representation :

Default value is ELabelPosition.ASIDE, i.e. fields label next to the property UI component.

labelsHorizontalPosition

String

When labels are positionned ASIDE, you can decide where to place them. This is either a value of the EHorizontalPosition enum or its equivalent string representation :

Default value is ELabelPosition.LEFT, i.e. fields label at the left of the property UI component.

labelFont

String

Defines the font used for the labels of form. The font must be string encoded using the pattern "[name];[style];[size]" :

Any of the above pattern section can be left empty, thus falling back to the component default. Whenever this property is set, it can be overridden on a field basis using a nested property view definition. Default value is null, meaning use default series font.

valueFont

String

Defines the font used for the values of the form. The font must be string encoded using the pattern "[name];[style];[size]" :

Any of the above pattern section can be left empty, thus falling back to the component default. Whenever this property is set, it can be overridden on a field basis using a nested property view definition. Default value is null, meaning use default series font.

columnCount

Integer

Configures the number of columns on this component view. Property fields that are to be displayed in the view are spread across columns and rows following their defined order. Whenever a row does not contain enough empty cells to recieve the next field (either because the last column has been reached or the next field has been configured to span multiple columns and there is not enough cells left in the current row to satisfty the span), a new row is created and the next field is added to the first column on the new row. Note that column count and span are defined in fields coordinates (the field including the property UI component + its label). The underlying grid is actually finer since it has to cope with the labels; but this is internal implementation details and Jspresso takes care of it, without the developer having to cope with labels placements. Default value is 1, meaning that all rendered fields will be stacked in a single column.

fields

ListOfField

renderedProperties

Determines which of the referenced component fields should be displayed The property must be configured with a List of fields to display A null value (default), means that all non-scalar properties will be rendered using default rendered properties as specified in their referenced model descriptor.

widths

Map

propertyWidths

This property allows to simply define property spans in the underlying grid without having to extensively define the propertyViewDescriptors property. It must be configued with a Map containing only the properties that need to span more than 1 column. The other properties will follow the default span of 1. The Map is :

Default value is null, meaning all property fields have a span of 1.

verticallyScrollable

Boolean

Tells wether vertical scrollbar should be installed in case there is not enough room.

widthResizeable

Boolean

Tells wether horizontal space is filled when available.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

longitude

RefField

longitudeProperty

the model property name that returns the longitude coordinate of the marker to display on the map.

latitude

RefField

latitudeProperty

the model property name that returns the latitude coordinate of the marker to display on the map.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

columns

ListOfField

renderedProperties

Determines which of the referenced component properties should be displayed as columns of the table The property must be configured with a List of columns to display A null value (default), means that all non-scalar properties will be rendered using default rendered properties as specified in their referenced model descriptor.

horizontallyScrollable

Boolean

This property allows to define the table horizontal scrolling behaviour. Whenever it is set to false, the corresponding table UI component will adapt its columns to fit the available horizontal space. Default value is true, i.e. table columns will have their default size and tha table will scroll horizontally as needed

sortable

Boolean

This property allows to define the table sorting behaviour. Whenever it is set to false, the corresponding table UI component will not allow manual sorting of its rows. Default value is true, i.e. table allows for its rows to be sorted

columnReordering

Boolean

columnReorderingAllowed

Configures if the table columns can be re-ordered by the user.

selectionMode

String

Sets the selection mode of the collection view.

Default value MULTIPLE_INTERVAL_SELECTION, i.e. any type of selection allowed.

rowAction

RefAction

Registers an action that is implicitely triggered everytime a row is activated (e.g. double-clicked for current UI channels) on the collection view UI peer. The context of the action execution is the same as if the action was registered in the view action map.

itemSelectionAction

RefAction

Registers an action that is implicitely triggered everytime the selection changes on the collection view UI peer. The context of the action execution is the same as if the action was registered in the view action map.

autoSelectFirstRow

Boolean

Configures the default selection that gets applied when the content of the collection view changes. Whenever set to true, the 1st row will be automatically selected, whereas nothing happens whe set to false. The default value depends on the selection mode of the collection view. When a cumulative selection mode is used, autoSelectFirstRow defaults to false. It defaults to true otherwise.

sortingAction

RefAction

Configures the action to be activated when a sort is triggered by the user. It should be used with caution and rarely be overriden from the default.

paginationView

RefView

paginationViewDescriptor

Configures a view that will control the pagination (if any) on this collection view. When contructed, the collection view will be decorated with the pagination view. The pagination view will be bound to the same model as the one providing the collection of the collection view.

selectionModel

RefDomain

selectionModelDescriptor

Bi-directionally binds the collection view selection to a model collection. Selected items in the view are kept in sync with the bound model collection.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

iconProvider

RefBean

iconImageURLProvider

The icon image URL provider is the delegate responsible for inferring a tree node icon based on its underlying model. By default (i.e. when iconImageURLProvider is null), Jspresso will use the underlying component descriptor icon, if any. Using a custom icon image URL provider allows to implement finer rules like using different icons based on the underlying object state. There is a single method to implement to achieve this : String getIconImageURLForObject(Object userObject);

rendered

RefField

renderedProperty

Configures the model property to be rendered in the list. Whenever this property is left to null (default value), the toStringProperty of the element component descriptor is used.

selectionMode

String

Sets the selection mode of the collection view.

Default value MULTIPLE_INTERVAL_SELECTION, i.e. any type of selection allowed.

rowAction

RefAction

Registers an action that is implicitely triggered everytime a row is activated (e.g. double-clicked for current UI channels) on the collection view UI peer. The context of the action execution is the same as if the action was registered in the view action map.

itemSelectionAction

RefAction

Registers an action that is implicitely triggered everytime the selection changes on the collection view UI peer. The context of the action execution is the same as if the action was registered in the view action map.

autoSelectFirstRow

Boolean

Configures the default selection that gets applied when the content of the collection view changes. Whenever set to true, the 1st row will be automatically selected, whereas nothing happens whe set to false. The default value depends on the selection mode of the collection view. When a cumulative selection mode is used, autoSelectFirstRow defaults to false. It defaults to true otherwise.

paginationView

RefView

paginationViewDescriptor

Configures a view that will control the pagination (if any) on this collection view. When contructed, the collection view will be decorated with the pagination view. The pagination view will be bound to the same model as the one providing the collection of the collection view.

selectionModel

RefDomain

selectionModelDescriptor

Bi-directionally binds the collection view selection to a model collection. Selected items in the view are kept in sync with the bound model collection.

displayIcon

Boolean

Configures wether the list displays icons for its elements.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

ref

RefView

Allows to reference an existing property view using its identifier.

name

RefField

Sets the name of this descriptor. Name is used in conjunction with the Jspresso i18n layer so that the name property set here is actually an i18n key used for translation.

width

Integer

When the property has to be displayed in a grid-like layout (e.g. in a component view), this property defines the umber of grid columns the corresponding UI component will span.

Default value is null, meaning use default span of 1

labelBackground

String

When the property has to be labelled (e.g. in a component view), this property defines the background color of the corresponding label. It might differ from the field component one. The color must be defined using its string hexadecimal representation (0xrgba encoded). Default value is null, meaning use UI default.

labelFont

String

When the property has to be labelled (e.g. in a component view), this property defines the font of the corresponding label. It might differ from the field component one. The font must be string encoded using the pattern "[name];[style];[size]" :

Any of the above pattern section can be left empty, thus falling back to the component default. Default value is null, meaning use default component font.

labelForeground

String

When the property has to be labelled (e.g. in a component view), this property defines the foregroud color of the corresponding label. It might differ from the field component one. The color must be defined using its string hexadecimal representation (0xrgba encoded). Default value is null, meaning use UI default.

labelHorizontalPosition

String

When labels are positionned ASIDE in a form, you can decide where to place them relatively to their component. This is either a value of the EHorizontalPosition enum or its equivalent string representation :

Default value is ELabelPosition.LEFT, i.e. field label at the left of the property UI component.

action

RefAction

Configures the action to be triggered when acting on this property. There are 2 cases :

renderedChildProperties

ListOfField

Whenever the property decriptor backing the view is not scalar, this property allows to override which of the referenced component fields should be displayed :

The property must be configured with a List containing the property names to render for the child element(s). A null value (default), means that the non-scalar property will be rendered using default rendered properties as specified in its referenced model descriptor. Please note that this is quite unusual to embed non-scalar properties directly in a property view. Although permitted, you won't have as much flexibility in the content layouting as you would have when using composite views; so the latter is by far recommended.

horizontalAlignment

String

This property allows to control the property alignment in views that support it. This is either a value of the EHorizontalAlignment enum or its equivalent string representation :

Default value is null, meaning use property type default.

sortable

Boolean

Configure the sortability of a property view when used to defines a table column for instance. Whenever it is not explicitely set, it falls back to the model property sortability. If no model descriptor is set, defaults to true.

clientTypes

ListOfString

forClientTypes

Gets the restricted list of client types that will display this property view. Defaults to null, which means no restriction. The provided list is not empty, then the actual session client type is matched against each of the restricted client type with either equal or substring or regexp semantic. Allowed values are

charAction

RefAction

characterAction

Allows to declare an action that will be triggered each time the text changes in the UI.

lovAction

RefAction

Allows to override the default "List of values" action attached to this reference property view. A null value (default) keeps the standard action.

allowedValues

ListOfString

Configures an optional allowed set of values to restrict the model ones. Only values belonging to the allowed set should be actually made available as a choice.

forbiddenValues

ListOfString

Configures an optional forbidden set of values to restrict the model ones. Only values not belonging to the forbidden set should be actually made available as a choice.

radio

Boolean

Configures the rendering of the enumeration property as radio buttons if supported instead of combobox. Default value is false.

orientation

String

Configures wether radio values be rendered horizontally or vertically. HORIZONTAL if radio values should be rendered horizontally and VERTICAL otherwise. Default value is VERTICAL.

enumIconWidth

Integer

Configures the with of the icon. If not set, defaults to 16.

enumIconHeight

Integer

Configures the height of the icon. If not set, defaults to 16.

scrollable

Boolean

Configures the image view to be either croped or scrollable when the display area is too small to display it. A value of true (default) means that the image view will be made scrollable.

scaledWidth

Integer

Sets scaled width. This property, when set to a positive integer will force the image width to be resized to the target value. If only one of the 2 scaled dimensions is set, then the image is scaled by preserving its aspect ratio.

scaledHeight

Integer

Sets scaled height. This property, when set to a positive integer will force the image height to be resized to the target value. If only one of the 2 scaled dimensions is set, then the image is scaled by preserving its aspect ratio.

drawable

Boolean

Allows the user to draw on the image and save the result. This can be very useful to capture the user signature as a POD for instance.

verticallyScrollable

Boolean

Configures the html view to be either croped or vertically scrollable when the display area is too small to display it. A value of true (default) means that the html view will be made scrollable vertically.

horizontallyScrollable

Boolean

Configures the html view to be either wrapped or horizontally scrollable when the display area is too small to display it. A value of true (default) means that the html view will be made scrollable horizontally.

action

RefAction

Assigns the action to display as a view. The action will typically be rendered as a button in the UI. whenever you want to size the icon used to display the action (and thus the button peer), you might use the preferredWidth / preferredHeight properties.

renderingOptions

String

Indicates how the actions should be rendered. This is either a value of the ERenderingOptions enum or its equivalent string representation :

Default value is null, i.e. determined from outside, e.g. the view factory.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

rendered

RefField

renderedProperty

This property allows to define the model property used to label the node.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

rendered

RefField

renderedProperty

This property allows to define the model property used to label the root node.

iconProvider

RefBean

iconImageURLProvider

The icon image URL provider is the delegate responsible for inferring a tree node icon based on its underlying model. By default (i.e. when iconImageURLProvider is null), Jspresso will use the underlying component descriptor icon, if any. Using a custom icon image URL provider allows to implement finer rules like using different icons based on the underlying object state. There is a single method to implement to achieve this : String getIconImageURLForObject(Object userObject);

expanded

Boolean

Setting this property to true configures the created tree to appear with its node expanded. A value of false (default) means that the tree nodes are initially collapsed.

itemSelectionAction

RefAction

This property alows to bind an action that gets triggered every time the selection changes on the tree view. The action context passed to the action when it is executed is the same as if it had been registered on the tree view.

rowAction

RefAction

Registers an action that is implicitely triggered everytime a row is activated (e.g. double-clicked for current UI channels) on the collection view UI peer. The context of the action execution is the same as if the action was registered in the view action map.

maxDepth

Integer

This property is used only when the tree (or sub-tree) is declared recursively, i.e. a tree level belongs to its own children hierarchy. Default value is 10, meaning that a maximum number of 10 levels can be nested.

displayIcon

Boolean

Configures wether the tree displays icons for its elements.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

views

ListOfView

Registers the list of views to be displayed as tabs. The tabs order follows the children views order of this list.

cascadingModels

Boolean

Enables the model "cascading" behaviour. This allows for instance to link 2 nested tables where the 2nd table model is the selected row of the first table (or null if selection is empty). Using cascadingModel=true is only necessary when tracking view selection on the master nested view. You don't need it if, for instance, the master nested view is a single model view like a omponent view. In the latter case, you can bind a table detail view just by adding it to the same composite without having to set cascadingModel=true. Default value is false, i.e. al nested views share the same model than the outer composite unless explicitely specified differently.

renderingOptions

String

Indicates how the actions should be rendered. This is either a value of the ERenderingOptions enum or its equivalent string representation :

Default value is null, i.e. determined from outside, e.g. the view factory.

lazy

Boolean

Lazy binds tabs based on user selection.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

views

ListOfView

Registers the list of views to be displayed as tabs. The tabs order follows the children views order of this list.

renderingOptions

String

Indicates how the actions should be rendered. This is either a value of the ERenderingOptions enum or its equivalent string representation :

Default value is null, i.e. determined from outside, e.g. the view factory.

lazy

Boolean

Lazy binds tabs based on user selection.

carouselMode

Boolean

Should this mobile tab view be rendered as a casousel ?

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

orientation

String

With SJS the orientation is defined directly in the name of the descriptor : split_vertical or split_horizontal

left

RefView

leftTopViewDescriptor

Sets the child view to layout in the left zone of a split_horizontal

right

RefView

rightBottomViewDescriptor

Sets the child view to layout in the rigth zone of a split_horizontal

top

RefView

leftTopViewDescriptor

Sets the child view to layout in the top zone of a split_vertical

bottom

RefView

rightBottomViewDescriptor

Sets the child view to layout in the bottom zone of a split_vertical

cascadingModels

Boolean

Enables the model "cascading" behaviour. This allows for instance to link 2 nested tables where the 2nd table model is the selected row of the first table (or null if selection is empty). Using cascadingModel=true is only necessary when tracking view selection on the master nested view. You don't need it if, for instance, the master nested view is a single model view like a omponent view. In the latter case, you can bind a table detail view just by adding it to the same composite without having to set cascadingModel=true. Default value is false, i.e. al nested views share the same model than the outer composite unless explicitely specified differently.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

east

RefView

eastViewDescriptor

Sets the child view to layout in the east zone. The child view will be resized vertically.

west

RefView

westViewDescriptor

Sets the child view to layout in the west zone. The child view will be resized vertically.

south

RefView

southViewDescriptor

Sets the child view to layout in the south zone. The child view will be resized horizontally.

north

RefView

northViewDescriptor

Sets the child view to layout in the north zone. The child view will be resized horizontally.

center

RefView

centerViewDescriptor

Sets the child view to layout in the center zone. The child view will be resized both horizontally and vertically.

cascadingModels

Boolean

Enables the model "cascading" behaviour. This allows for instance to link 2 nested tables where the 2nd table model is the selected row of the first table (or null if selection is empty). Using cascadingModel=true is only necessary when tracking view selection on the master nested view. You don't need it if, for instance, the master nested view is a single model view like a omponent view. In the latter case, you can bind a table detail view just by adding it to the same composite without having to set cascadingModel=true. Default value is false, i.e. al nested views share the same model than the outer composite unless explicitely specified differently.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

cascadingModels

Boolean

Enables the model "cascading" behaviour. This allows for instance to link 2 nested tables where the 2nd table model is the selected row of the first table (or null if selection is empty). Using cascadingModel=true is only necessary when tracking view selection on the master nested view. You don't need it if, for instance, the master nested view is a single model view like a omponent view. In the latter case, you can bind a table detail view just by adding it to the same composite without having to set cascadingModel=true. Default value is false, i.e. al nested views share the same model than the outer composite unless explicitely specified differently.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

views

ListOfView

viewDescriptors

Registers the list of card view descriptors. Every time the bound model changes, this list is iterated until a card with a matching model is found. The first matching card is displayed. Whenever no registered card matches, an empty view is displayed.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

selector

RefBean

cardNameSelector

Configures the card determination strategy. This delegate is responsible for selecting the card name key based on the model bound to the view. Everytime the bound model changes, the card name selector is triggered to select a new card. The names returned by the card name selector must match the names under which the cards are registered. Whenever the card name selector returns an unknown name, the card view displays an empty view. The card name selector can optionally implement ICardProvider in which case, it will be given a chance to create cards dynamically based on their names.

views

MapOfView

cardViewDescriptors

Registers the card views keyed by their name keys. The names used as key of the Map must match the names that are returned by the registered card name selector.

parents

ListOfActionMaps

parentActionMaps

Assigns the parent action maps. The action lists that will actually be rendered will be the merge of the directly owned action lists and of the parent action maps. Action lists that have the same name are merged together and into a merged action list, local actions will replace parent actions with the same name.

renderingOptions

String

Indicates how the actions should be rendered. This is either a value of the ERenderingOptions enum or its equivalent string representation :

Default value is null, i.e. determined from outside, e.g. the view factory.

grantedRoles

ListOfString

Assigns the roles that are authorized to execute this action map. It supports "!" prefix to negate the role(s). This will directly influence the UI behaviour since unauthorized action maps won't be displayed. Setting the collection of granted roles to null (default value) disables role based authorization on this action map.

permId

String

Sets the permanent identifier to this application element. Permanent identifiers are used by different framework parts, like dynamic security or record/replay controllers to uniquely identify an application element. Permanent identifiers are generated by the SJS build based on the element id but must be explicitely set if Spring XML is used.

validationModel

RefDomain

This property is SJS specific. It allows to enforce SJS controls without actually assigning a model to the action gates.

parent

RefAction

Allows to reference another descriptor as a model and to override certain properties.

class

String

java class that implement the action

ref

RefAction

Allows to reference an existing action using its identifier. It can be used everywhere an action can, e.g. in action lists.

next

RefAction

nextAction

Registers an action to be executed after this action and after the wrapped one. This is perfectly suited to chain an action of the same type (frontend or backend) as this one.

wrapped

RefAction

wrappedAction

Registers an action to be executed after this action but before the next one. This is perfectly suited to chain a backend action from a frontend action since the control flow will return back to the calling layer (the frontend).

custom

Map

Map of custom properties that have to be set on the action. When a property is a reference, its key has to be suffixed by "_ref". This enables SJS to generate the appropriate XML and to control the existence of the reference.

custom:[

    parentModuleName:'Projects', 

    componentDescriptor_ref:'Project'])

name

String

Sets the key used to compute the internationalized name of the action. The translated name is then usually used as label for the action (button label, menu label, ...)

description

String

Sets the description of this action. Most of the descriptor descriptions are used in conjunction with the Jspresso i18n layer so that the description property set here is actually an i18n key used for translation.

accelerator

String

acceleratorAsString

Configures a keyboard accelerator shortcut on this action. Support of this feature depends on the UI execution platform. The syntax used consists of listing keys that should be pressed to trigger the action, i.e. "alt shift D" or "ctrl C". This is the syntax supported by the javax.swing.KeyStroke

icon

String

iconImageURL

Sets the icon image URL of this descriptor. Supported URL protocols include :

iconWidth

Integer

iconPreferredWidth

Allows to define a custom width for the icon. In that case, the default dimension computed by the view factory is ignored.

iconHeight

Integer

iconPreferredHeight

Allows to define a custom height for the icon. In that case, the default dimension computed by the view factory is ignored.

styleName

String

Assigns the style name to use for this view. The way it is actually leveraged depends on the UI channel. It will generally be mapped to some sort of CSS style name. Default value is null, meaning that a default style is used.

grantedRoles

ListOfString

Assigns the roles that are authorized to execute this action. It supports "!" prefix to negate the role(s). This will directly influence the UI behaviour since unauthorized actions won't be displayed. Setting the collection of granted roles to null (default value) disables role based authorization on this action. Note that this Actions authorization enforcement does not prevent programatic access that is of the developer responsbility.

permId

String

Sets the permanent identifier to this application element. Permanent identifiers are used by different framework parts, like dynamic security or record/replay controllers to uniquely identify an application element. Permanent identifiers are generated by the SJS build based on the element id but must be explicitely set if Spring XML is used.

booleanActionabilityGates

ListOfString

Assigns a collection of gates to determine action actionability. An action will be considered actionable (enabled) if and only if all boolean gates are open. With SJS a boolean actionability gate can be suffixed by '_cb', which stands for 'collection based'. Collection based actions will typically be installed on selectable views (table, list , tree) and will be enabled only when the view selection is not empty (a default gate is installed for this purpose). Moreover, boolean actionnability gates that are configured on collection based actions take their model from the view selected components instead of the view model itself. In case of multi-selection enabled UI views, the actionability gates will actually open if and only if their opening condition is met for all the selected items.

action('actionA', booleanActionabilityGates: ['!prop1', 'prop2_cb'] ...

This mecanism is mainly used for dynamic UI authorization based on model state, e.g. a validated invoice should not be validated twice. Action assigned gates will be cloned for each concrete action instance created and bound to its respective UI component (usually a button). So basically, each action instance will have its own, unshared collection of actionability gates. By default, frontend actions are assigned a generic gate that closes (disables the action) when the view is not assigned any model

rolesActionabilityGates

ListOfString

Assigns a collection of gates to determine action actionability. An action will be considered actionable (enabled) if and only if all rolesGates are open.

action('actionA', rolesActionabilityGates: ['role1', '!role2'] ...

Same mecanism has booleanActionabilityGates

enumActionabilityGates

MapOfListOfString

Assigns a collection of gates to determine action actionability. An action will be considered actionable (enabled) if and only if all enum gates are open. With SJS an enum actionability gate can be suffixed by '_cb', which stands for 'collection based'. Collection based actions will typically be installed on selectable views (table, list , tree) and will be enabled only when the view selection is not empty (a default gate is installed for this purpose). Moreover, enum actionnability gates that are configured on collection based actions take their model from the view selected components instead of the view model itself. In case of multi-selection enabled UI views, the actionability gates will actually open if and only if their opening condition is met for all the selected items.

action('actionA', enumActionabilityGates: ['!prop1':['VAL1','VAL2'], 'prop2_cb':['VAL3']] ...

This mecanism is mainly used for dynamic UI authorization based on model state, e.g. a validated invoice should not be validated twice. Action assigned gates will be cloned for each concrete action instance created and bound to its respective UI component (usually a button). So basically, each action instance will have its own, unshared collection of actionability gates. By default, frontend actions are assigned a generic gate that closes (disables the action) when the view is not assigned any model

regexActionabilityGates

MapOfString

Assigns a collection of gates to determine action actionability. An action will be considered actionable (enabled) if and only if all regex gates are open. With SJS a regex actionability gate can be suffixed by '_cb', which stands for 'collection based'. Collection based actions will typically be installed on selectable views (table, list , tree) and will be enabled only when the view selection is not empty (a default gate is installed for this purpose). Moreover, boolean actionnability gates that are configured on collection based actions take their model from the view selected components instead of the view model itself. In case of multi-selection enabled UI views, the actionability gates will actually open if and only if their opening condition is met for all the selected items.

action('actionA', regexActionabilityGates: ['!prop1':'[A-Z]*', 'prop2_cb':'[a-z]*'] ...

This mecanism is mainly used for dynamic UI authorization based on model state, e.g. a validated invoice should not be validated twice. Action assigned gates will be cloned for each concrete action instance created and bound to its respective UI component (usually a button). So basically, each action instance will have its own, unshared collection of actionability gates. By default, frontend actions are assigned a generic gate that closes (disables the action) when the view is not assigned any model

collectionBased

Boolean

Declares the action as working on a collection of objects. Collection based actions will typically be installed on selectable views (table, list , tree) and will be enabled only when the view selection is not empty (a default gate is installed for this purpose). Moreover, model gates that are configured on collection based actions take their model from the view selected components instead of the view model itself. In case of multi-selection enabled UI views, the actionability gates will actually open if and only if their opening condition is met for all the selected items.

multiSelection

Boolean

multiSelectionEnabled

Declares the action as being abled to run on a collection containing more than 1 element. A multiSelection = false action will be disabled when the selection contains no or more than one element.

validationModel

RefDomain

This property is SJS specific. It allows to enforce SJS controls without actually assigning a model to the action gates.

parent

RefView

Allows to reference another descriptor as a model and to override certain properties.

selection

RefView

selectionViewDescriptor

Defines the selection view of the navigation page, either tree or list.

headerSections

ListOfView

headerSectionDescriptors

Defines a list of section views to be placed above the selection view.

next

RefView

nextAction

Defines the page that will be navigated to when the user clicks an item in the selection view.

parent

RefWorkspace

Allows to use an other descriptor as a model and to override certain properties.

name

String

Configures the key used to translate actual internationalized workspace name. The resulting translation will be leveraged as the workspace label on the UI side.

description

String

Configures the key used to translate actual internationalized workspace description. The resulting translation will generally be leveraged as a tooltip on the UI side but its use may be extended for online help.

headerDescription

String

Configures the key used to translate actual internationalized workspace header description. The resulting translation will generally be leveraged as a textual section that explains the workspace goal.

icon

String

iconImageURL

Sets the icon image URL of this descriptor. Supported URL protocols include :

iconWidth

Integer

iconPreferredWidth

Allows to define a custom width for the icon. In that case, the default dimension computed by the view factory is ignored.

iconHeight

Integer

iconPreferredHeight

Allows to define a custom height for the icon. In that case, the default dimension computed by the view factory is ignored.

startup

RefAction

startupAction

Configures an action to be executed the first time the workspace is "started" by the user. The action will execute in the context of the workspace but with no specific module selected. It will help initializing workspace values, notify user, ...

permId

String

Sets the permanent identifier to this application element. Permanent identifiers are used by different framework parts, like dynamic security or record/replay controllers to uniquely identify an application element. Permanent identifiers are generated by the SJS build based on the element id but must be explicitely set if Spring XML is used.

grantedRoles

ListOfString

Assigns the roles that are authorized to view this workspace. It supports "!" prefix to negate the role(s). This will directly influence the UI behaviour since unauthorized workspaces won't be displayed. Setting the collection of granted roles to null (default value) disables role based authorization on this workspace.

parent

RefModule

Allows to use an other descriptor as a model and to override certain properties.

name

String

Configures the key used to translate actual internationalized module name. The resulting translation will be leveraged as the module label on the UI side.

description

String

Configures the key used to translate actual internationalized module description. The resulting translation will generally be leveraged as a tooltip on the UI side but its use may be extended for online help.

icon

String

iconImageURL

Sets the icon image URL of this descriptor. Supported URL protocols include :

iconWidth

Integer

iconPreferredWidth

Allows to define a custom width for the icon. In that case, the default dimension computed by the view factory is ignored.

iconHeight

Integer

iconPreferredHeight

Allows to define a custom height for the icon. In that case, the default dimension computed by the view factory is ignored.

moduleView

RefView

projectedViewDescriptor

Configures the view descriptor used to construct the view that will be displayed when this module is selected.

startup

RefAction

startupAction

Reference to an action trigerred at statup when the module is first selected

entry

RefAction

entryAction

Configures an action to be executed every time the module becomes the current selected module (either through a user explicit navigation or a programmatic selection). The action will execute in the context of the current workspace, this module being the current selected module.

exit

RefAction

exitAction

Configures an action to be executed every time the module becomes unselected (either through a user explicit navigation or a programmatic deselection). The action will execute in the context of the current workspace, this module being the current selected module (i.e. the action occurs before the module is actually left).

ref

RefModule

Allows to reference an existing module using its identifier. It can be used everywhere a module can.

permId

String

Sets the permanent identifier to this application element. Permanent identifiers are used by different framework parts, like dynamic security or record/replay controllers to uniquely identify an application element. Permanent identifiers are generated by the SJS build based on the element id but must be explicitely set if Spring XML is used.

grantedRoles

ListOfString

Assigns the roles that are authorized to start this module. It supports "!" prefix to negate the role(s). Whenever the user is not granted sufficient privileges, the module is simply not installed in the workspace . Setting the collection of granted roles to null (default value) disables role based authorization on this module.

Some specific modules that are component/entity model based i.e. Bean(Collection)Module also inherit their authrorizations from their model.

component

RefDomain

elementComponentDescriptor

Configures the type of bean element this collection module manages . A bunch of default values are inferred from this element component descriptor. For instance, paging size (if used) will default to the component one unless explicitely set. Same goes for icon image URL, default ordering properties or even granted roles. The latter means that bean collection modules based on forbidden entities will automatically be excluded from the workspace of the logged-in user.

if not explicitely configured, the eement component descriptor can be inferred from the collection view descriptor configured as projected view descriptor.

detailView

RefView

elementViewDescriptor

This property is not used by the module itself, but by built-in actions that maybe registered on this module. One of tese actions is AddBeanAsSubModuleAction.

This property indicates the view to use whenever the user requests a "form-like" view on a collection element. Naturally the configured element view descriptor must be backed by a model matching the type of the module managed beans.

component

RefDomain

elementComponentDescriptor

This property allows to configure a custom filter model descriptor. If not set, which is the default value, the filter model is built out of the element component descriptor (QBE filter model).

filterComponent

RefDomain

filterComponentDescriptor

Assigns the filter to this module instance. It is by default assigned by the module startup action (see InitModuleFilterAction). So if you ever want to change the default implementation of the filter, you have to write and install you own custom startup action or explicitely inject a specific instance.

filterView

RefView

filterViewDescriptor

This property allows to refine the default filer view to re-arange the filter fields. Custom filter view descriptors assigned here must not be assigned a model descriptor since they will be at runtime. This is because the filter component descriptor must be reworked - to adapt comparable field structures for instance.

pagingStatus

RefView

Allows to change the default view for the paging status. If not set (default), a default paging status view is created containing the curent pageas well as the total number of pages available and the total number of records in the result set. This paging status view is the bordered with the bage navigation actions.

pagingAction

RefAction

Configures a custom action to be trigerred when paging.

ordering

Map

Configures a custom map of ordering properties for the result set. If not set, which is the default, the elements ordering properties is used. This property consist of a Map whose entries are composed with :

Ordering properties are considered following their order in the map iterator.

pageSize

Integer

Configures a custom page size for the result set. If not set, which is the default, the elements default page size is used.

component

RefDomain

componentDescriptor

Configures the type of bean element this collection module manages . A bunch of default values are inferred from this element component descriptor. For instance, paging size (if used) will default to the component one unless explicitely set. Same goes for icon image URL, default ordering properties or even granted roles. The latter means that bean collection modules based on forbidden entities will automatically be excluded from the workspace of the logged-in user.

if not explicitely configured, the element component descriptor can be inferred from the collection view descriptor configured as projected view descriptor.

name

String

Sets the application name.

description

String

Sets the application description.

icon

String

iconImageURL

Sets the icon image URL that is used as the application icon.

iconWidth

Integer

iconPreferredWidth

Allows to define a custom width for the icon. In that case, the default dimension computed by the view factory is ignored.

iconHeight

Integer

iconPreferredHeight

Allows to define a custom height for the icon. In that case, the default dimension computed by the view factory is ignored.

workspaceIcon

String

workspacesMenuIconImageUrl

Sets the icon image URL that is used as the workspace menu icon. Same supported URL protocols than icon property.

actionMap

RefActionMap

References an application-wide action map that will be installed in the main application frame. These actions are available at any time from the UI and thus, do not depend on the active workspace. General purpose actions like "Change password" action should be installed here.

secondaryActionMap

RefActionMap

References a secondary application-wide action map that will be installed in the main application frame. These actions are available at any time from the UI and thus, do not depend on the active workspace.

helpActionMap

RefActionMap

Reference the help action map. The help action map should contain actions that are related to helping the user (online help, reference manual, tutorial, version dialog...).

The help action map is visually distinguished from the regular aplication action map. For instance elp actions can be represented in a menu that is right-aligned in the menubar.

context

String

loginContextName

Configures the name of the JAAS login context to use to authenticate users. It must reference a valid JAAS context that is installed in the JVM, either through setting the java.security.auth.login .config system property or through server-specific configuration.

language

String

forcedStartingLocale

Configures the locale used to initiate the login process. Whenever the forced starting locale is null, the client host default locale is used.

As soon as the user logs-in, his locale is then used to translate the UI . Whenever the login process is disabled, then the forced starting locale is kept as the UI I18N locale.

startup

RefAction

startupAction

Reference to an action trigerred at statup when when the application starts. An example of such an action would be a default workspace/module opening and selection, a "tip of the day" like action, ...

login

RefAction

loginAction

Configures an action to be executed just after the user has succesfully logged-in but before any UI initialization has begun. An example of such an action would be constructing a map of dynamic user right based on some arbitrary datastore so that the UI construction can actually depend on these extracted values.

onModuleEnter

RefAction

onModuleEnterAction

Reference an action to be executed each time a module of the application is entered. The action is executed in the context of the module the user enters.

onModuleExit

RefAction

onModuleExitAction

Reference an action to be executed each time a module of the application is exited. The action is executed in the context of the module the user exits. Default frontend controller configuration installs an action that checks current module dirty state.

onModuleStartup

RefAction

Reference an action to be executed each time a module of the application is started. The action is executed in the context of the module the user starts.

workspaces

ListOfWorkspace

Registers the workspaces that are available in the application. Workspaces are application entry-points and are hierarchically composed of modules / sub-modules.

width

Integer

frameWidth

Configures the width under which a scrollbar will appear.

height

Integer

frameHeight

Configures the height under which a scrollbar will appear.

basenames

ListOfString

Configures the list of I18N resource bundles that will be used for the translations

id

ListOfString

List of authorized external references

SJSAll

*

Map of any valid SJS properties with their values

SJSAll

*

Map of any valid SJS properties with their values

parent

Ref

Allows to use an other descriptor as a model and to override certain properties.

prototype

Boolean

wether this bean is a prototype (i.e. a new instance is created every time) as opposed to a singleton.

class

String

Bean's java class

ref

String

Allows to reference an existing reference using its identifier.

name

String

Sets the name of this descriptor. Most of the descriptor names are used in conjunction with the Jspresso i18n layer so that the name property set here is actually an i18n key used for translation. The descriptor name property semantic may vary depending on the actual descriptor type. For instance, a property descriptor name is the name of the property and a component descriptor name is the fully qualified name of the underlying class...

description

String

Sets the description of this bean. Most of the descriptor descriptions are used in conjunction with the Jspresso i18n layer so that the description property set here is actually an i18n key used for translation.

custom

Map

Map of custom properties that have to be set on the action. When a property is a reference, its key has to be suffixed by "_ref". This enables SJS to generate the appropriate XML and to control the existence of the reference.

custom:[

    parentModuleName:'Projects', 

    componentDescriptor_ref:'Project'])

values

ListOfString

List of string values

values

ListOfString

List of string values

values

Map

Map of string values