AdminPresentation (BroadleafCommerce Common Libraries 3.0.12-GA API)

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

Author:: jfischer

Optional Element Summary

Optional Elements
Modifier and Type	Optional Element and Description
`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.

- Element Detail
  - 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

Annotation Type AdminPresentation

Optional Element Summary

Element Detail

friendlyName

securityLevel

order

gridOrder

visibility

fieldType

group

groupOrder

groupCollapsed

tab

tabOrder

largeEntry

prominent

columnWidth

broadleafEnumeration

readOnly

validationConfigurations

requiredOverride

excluded

tooltip

helpText

hint

showIfProperty

currencyCodeField

ruleIdentifier

translatable