org.broadleafcommerce.common.presentation
Annotation Type AdminPresentation

@Retention(value=RUNTIME)
@Target(value=FIELD)
public @interface AdminPresentation

Author:

jfischer

Optional Element Summary

String	broadleafEnumeration Optional - only required for BROADLEAF_ENUMERATION field types For fields with a SupportedFieldType of BROADLEAF_ENUMERATION, you must specify the fully qualified class name of the Broadleaf Enumeration here.
String	columnWidth Optional - only required if you want to explicitly control column width for this field in a grid in the admin tool Specify the column space this field will occupy in grid widgets.
String	currencyCodeField Optional - If you have FieldType set to SupportedFieldType.MONEY, then you can specify a money currency property field.
boolean	excluded Optional - only required if you want to explicitly exclude this field from dynamic management by the admin tool Specify if this field should be excluded from inclusion in the admin presentation layer
SupportedFieldType	fieldType Optional - only required if you want to explicitly specify the field type.
String	friendlyName Optional - only required if you want to display a friendly name to the user
int	gridOrder Optional - required only if you want to order the appearance of this field as it relates to other fields in a Note that this field will only be relevant if prominent() is also set to true.
String	group Optional - only required if you want to specify a grouping for this field Specify a GUI grouping for this field Fields in the same group will be visually grouped together in the GUI Note: for support I18N, this can also be a key to retrieve a localized String
boolean	groupCollapsed Optional - only required if you want to control the initial collapsed state of the group Specify whether a group is collapsed by default in the admin UI.
int	groupOrder Optional - only required if you want to order the appearance of groups in the UI Specify an order for this group.
String	helpText Optional - only required if you want to provide help text for this field On the form for this entity, this will show a question mark icon next to the field.
String	hint Optional - only required if you want to provide a hint for this field Text to display immediately to the right of a form field.
boolean	largeEntry Optional - only required if you want to give the user extra room to enter a value for this field in the UI If the field is a string, specify that the GUI provide a text area
int	order Optional - only required if you want to order the appearance of this field in the UI The order in which this field will appear in a GUI relative to other fields from the same class
boolean	prominent Optional - only required if you want this field to appear as one of the default columns in a grid in the admin tool Provide a hint to the GUI about the prominence of this field.
boolean	readOnly Optional - only required if you want to make the field immutable Explicityly specify whether or not this field is mutable.
RequiredOverride	requiredOverride Optional - only required if you want to explicitly make a field required.
String	ruleIdentifier Optional - only required if the fieldType is SupportedFieldType.RULE_SIMPLE or SupportedFieldType.RULE_COMPLEX
String	securityLevel Optional - only required if you want to restrict this field If a security level is specified, it is registered with org.broadleafcommerce.openadmin.client.security.SecurityManager The SecurityManager checks the permission of the current user to determine if this field should be disabled based on the specified level.
String	showIfProperty Optional - propertyName , only required if you want hide the field based on this property's value
String	tab Optional - only required if you want the field to appear under a different tab Specify a GUI tab for this field
int	tabOrder Optional - only required if you want to order the appearance of the tabs in the UI Specify an order for this tab.
String	tooltip Optional - only required if you want to provide a tooltip for the field Helpful tooltip to be displayed when the admin user hovers over the field.
boolean	translatable Optional - marks this field as being translatable, which will render the translations modal in the admin UI
ValidationConfiguration[]	validationConfigurations Optional - only required if you want to provide validation for this field Specify the validation to use for this field in the admin, if any
VisibilityEnum	visibility Optional - only required if you want to restrict the visibility of this field in the admin tool Describes how the field is shown in admin GUI.

friendlyName

public abstract String friendlyName

Optional - only required if you want to display a friendly name to the user

Returns:

the friendly name

Default:

""

securityLevel

public abstract String securityLevel

Optional - only required if you want to restrict this field If a security level is specified, it is registered with org.broadleafcommerce.openadmin.client.security.SecurityManager The SecurityManager checks the permission of the current user to determine if this field should be disabled based on the specified level.

Returns:

the security level

Default:

""

order

public abstract int order

Optional - only required if you want to order the appearance of this field in the UI The order in which this field will appear in a GUI relative to other fields from the same class

Returns:

the display order

Default:

99999

gridOrder

public abstract int gridOrder

Optional - required only if you want to order the appearance of this field as it relates to other fields in a Note that this field will only be relevant if prominent() is also set to true.

Returns:

Default:

9999

visibility

public abstract VisibilityEnum visibility

Optional - only required if you want to restrict the visibility of this field in the admin tool Describes how the field is shown in admin GUI.

Returns:

whether or not to hide the form field.

Default:

org.broadleafcommerce.common.presentation.client.VisibilityEnum.VISIBLE_ALL

fieldType

public abstract SupportedFieldType fieldType

Optional - only required if you want to explicitly specify the field type. This value is normally inferred by the system based on the field type in the entity class. Explicity specify the type the GUI should consider this field Specifying UNKNOWN will cause the system to make its best guess

Returns:

the field type

Default:

org.broadleafcommerce.common.presentation.client.SupportedFieldType.UNKNOWN

group

public abstract String group

Optional - only required if you want to specify a grouping for this field Specify a GUI grouping for this field Fields in the same group will be visually grouped together in the GUI

Note: for support I18N, this can also be a key to retrieve a localized String

Returns:

the group for this field

Default:

"General"

groupOrder

public abstract int groupOrder

Optional - only required if you want to order the appearance of groups in the UI Specify an order for this group. Groups will be sorted in the resulting form in ascending order based on this parameter.

Returns:

the order for this group

Default:

99999

groupCollapsed

public abstract boolean groupCollapsed

Optional - only required if you want to control the initial collapsed state of the group Specify whether a group is collapsed by default in the admin UI.

Returns:

whether or not the group is collapsed by default

Default:

false

tab

public abstract String tab

Optional - only required if you want the field to appear under a different tab Specify a GUI tab for this field

Returns:

the tab for this field

Default:

"General"

tabOrder

public abstract int tabOrder

Optional - only required if you want to order the appearance of the tabs in the UI Specify an order for this tab. Tabs will be sorted int he resulting form in ascending order based on this parameter. The default tab will render with an order of 100.

Returns:

the order for this tab

Default:

100

largeEntry

public abstract boolean largeEntry

Optional - only required if you want to give the user extra room to enter a value for this field in the UI If the field is a string, specify that the GUI provide a text area

Returns:

is a text area field

Default:

false

prominent

public abstract boolean prominent

Optional - only required if you want this field to appear as one of the default columns in a grid in the admin tool Provide a hint to the GUI about the prominence of this field. For example, prominent fields will show up as a column in any list grid in the admin that displays this entity.

Returns:

whether or not this is a prominent field

Default:

false

columnWidth

public abstract String columnWidth

Optional - only required if you want to explicitly control column width for this field in a grid in the admin tool Specify the column space this field will occupy in grid widgets. This value can be an absolute integer or a percentage. A value of "*" will make this field use up equally distributed space.

Returns:

the space utilized in grids for this field

Default:

"*"

broadleafEnumeration

public abstract String broadleafEnumeration

Optional - only required for BROADLEAF_ENUMERATION field types For fields with a SupportedFieldType of BROADLEAF_ENUMERATION, you must specify the fully qualified class name of the Broadleaf Enumeration here.

Returns:

Broadleaf enumeration class name

Default:

""

readOnly

public abstract boolean readOnly

Optional - only required if you want to make the field immutable Explicityly specify whether or not this field is mutable.

Returns:

whether or not this field is read only

Default:

false

validationConfigurations

public abstract ValidationConfiguration[] validationConfigurations

Optional - only required if you want to provide validation for this field Specify the validation to use for this field in the admin, if any

Returns:

the configuration for the validation

Default:

{}

requiredOverride

public abstract RequiredOverride requiredOverride

Optional - only required if you want to explicitly make a field required. This setting is normally inferred by the JPA annotations on the field. Specify whether you would like the admin to require this field, even if it is not required by the ORM.

Returns:

the required override enumeration

Default:

org.broadleafcommerce.common.presentation.RequiredOverride.IGNORED

excluded

public abstract boolean excluded

Optional - only required if you want to explicitly exclude this field from dynamic management by the admin tool Specify if this field should be excluded from inclusion in the admin presentation layer

Returns:

whether or not the field should be excluded

Default:

false

tooltip

public abstract String tooltip

Optional - only required if you want to provide a tooltip for the field Helpful tooltip to be displayed when the admin user hovers over the field. This can be localized by providing a key which will use the GWT support for i18N.

Default:

""

helpText

public abstract String helpText

Optional - only required if you want to provide help text for this field On the form for this entity, this will show a question mark icon next to the field. When the user clicks on the icon, whatever HTML that is specified in this helpText is shown in a popup. For i18n support, this can also be a key to a localized version of the text Reference implementation: http://www.smartclient.com/smartgwt/showcase/#form_details_hints

Default:

""

hint

public abstract String hint

Optional - only required if you want to provide a hint for this field Text to display immediately to the right of a form field. For instance, if the user needs to put in a date, the hint could be the format the date needs to be in like 'MM/YYYY'. For i18n support, this can also be a key to a localized version of the text Reference implementation: http://www.smartclient.com/smartgwt/showcase/#form_details_hints

Default:

""

showIfProperty

public abstract String showIfProperty

Optional - propertyName , only required if you want hide the field based on this property's value

If the property is defined and found to be set to false, in the AppConfiguraionService, then this field will be excluded in the admin presentation layer

Returns:

name of the property

Default:

""

currencyCodeField

public abstract String currencyCodeField

Optional - If you have FieldType set to SupportedFieldType.MONEY, then you can specify a money currency property field.

Returns:

the currency property field

Default:

""

ruleIdentifier

public abstract String ruleIdentifier

Optional - only required if the fieldType is SupportedFieldType.RULE_SIMPLE or SupportedFieldType.RULE_COMPLEX

Identifies the type for which this rule builder is targeted. See RuleIdentifier for a list of identifier types supported out-of-the-box. Note - one of the main uses of this value is to help identify the proper RuleBuilderService instance to generate the correct field value options for this rule builder.

Returns:

The identifier value that denotes what type of rule builder this is - especially influences the fields that are available in the UI

Default:

""

translatable

public abstract boolean translatable

Optional - marks this field as being translatable, which will render the translations modal in the admin UI

Returns:

whether or not this field is translatable

Default:

false