Class DataFieldBase
- All Implemented Interfaces:
Serializable,Cloneable,Copyable,DictionaryBean,UifDictionaryBean,Component,DataBinding,Ordered,ScriptEventSupport,DataField,Field,LifecycleElement,Helpable,org.springframework.core.Ordered
- Direct Known Subclasses:
InputFieldBase
- Author:
- Kuali Rice Team (rice.collab@kuali.org)
- See Also:
-
Field Summary
FieldsFields inherited from class org.kuali.rice.krad.uif.component.ComponentBase
templateOptionsFields inherited from class org.kuali.rice.krad.datadictionary.DictionaryBeanBase
componentCode, namespaceCodeFields inherited from interface org.kuali.rice.krad.uif.component.Ordered
INITIAL_ORDER_VALUEFields inherited from interface org.springframework.core.Ordered
HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidNo-op implementation.voidcompleteValidation(ValidationTrace tracer) Validates different requirements of component compiling a series of reports detailing information on errors found in the component.voidcopyFromAttributeDefinition(AttributeDefinition attributeDefinition) Defaults the properties of theDataFieldto the corresponding properties of itsAttributeDefinitionretrieved from the dictionary (if such an entry exists).protected StringGenerates the html to be used and sets the readOnlyDisplayReplacement for DataFields that contain lists and do not have their own readOnlyDisplayReplacement defined.Allows specifying hidden property names without having to specify as a field in the group config (that might impact layout)Returns theBindingInfoinstance that is configured for the componentData Field Security object that indicates what authorization (permissions) exist for the fieldDefault value for the model property the field points toClass<? extends org.kuali.rice.krad.valuefinder.ValueFinder> Gives Class that should be invoked to produce the default value for the fieldArray of default values for the model property the field points toName of the attribute within the data dictionary the attribute field is associated withObject entry name in the data dictionary the associated attribute is apart ofFor read only DataFields, if forcedValue has a value, the value of it will be used instead of the value received from the propertyName specified for this field; this can be combined with SpringEL to format a property value in some way, for example.getHelp()Help configuration object for the containerSummary help text for the fieldHelp title which is used for the HTML title attribute of the help iconInquiry widget for the fieldMaskFormatter instance that will be used to mask the field value whenDataField.isApplyMask()is truegetName()Returns the full binding path (the path used in the name attribute of the input).Performs formatting of the field value for display and then converting the value back to its expected type from a stringName of the property (relative to the parent object) the component binds toList of property names whose values should be displayed read-only under this fieldReturns the alternate display valueReturns the alternate display attribute name to be displayed when the field is readonly.Returns the additional display value.Returns the additional display attribute name to be displayed when the field is readonlyThe readOnlyListDelimiter is used to set the delimiter used when "DELIMITED" type is set for readOnlyListDisplayTypeGets the readOnlyListDisplayType.Sets the sort type if this field is used within a collectionprotected booleanDetermines whether or not to create an automatic inquiry widget for this field within the current lifecycle.booleanIndicates whether the value for the field is secure.protected voidInitializes (if necessary) the component security instance for the component typebooleanIndicates the field should be read-only but also a hidden should be generated for the fieldbooleanIndicates whether the value for the field should be masked (or partially masked) on displaybooleanIndicates whether inquiries should be automatically set when a relationship for the field's property is foundbooleanReturns true if HTML escape allowed for this fieldbooleanIndicates whether the data field instance allows input, subclasses should override and set to true if input is allowedbooleanReturns true if this field is of typeTextAreaControl.booleanbooleanWhen true, render the info message span which contains can contain additional information about the field (used by Field Query functionality)booleanWhen true, render the marker icon span to show icons related to the field (used by CompareFieldCreateModifier on maintenance documetnts to mark editted fields)voidperformApplyModel(Object model, LifecycleElement parent) The following finalization is performed: Make sure that a label is defined for any data fields.voidperformFinalize(Object model, LifecycleElement parent) The following finalization is performed: Set the labelForComponentId to this component id Set the label text on the label field from the field's label property Set the render property on the label's required message field if this field is marked as required The following finalization is done here: progressiveRender and conditionalRefresh variables are processed if set If any of the style properties were given, sets the style string on the style property Set the skipInTabOrder flag for nested components The last phase before the view is renderedvoidperformInitialization(Object model) The following updates are done here: Invoke performInitialize on component modifiers Initializes the componentprotected voidprocessReadOnlyListDisplay(Object model, List<?> originalList) This method is called when the list is readOnly as determined in DataField's performFinalize method.voidsetAddHiddenWhenReadOnly(boolean addHiddenWhenReadOnly) Setter for the read-only hidden indicatorvoidsetAdditionalHiddenPropertyNames(List<String> additionalHiddenPropertyNames) Setter for the hidden property namesprotected voidsetAlternateAndAdditionalDisplayValue(View view, Object model) Sets alternate and additional property value for this field.voidsetApplyMask(boolean applyMask) Setter for the apply value mask flagvoidsetBindingInfo(BindingInfo bindingInfo) Setter for the binding info instancevoidsetComponentSecurity(ComponentSecurity componentSecurity) Override to assert aFieldSecurityinstance is setvoidsetDefaultValue(Object defaultValue) Setter for the fields default valuevoidsetDefaultValueFinderClass(Class<? extends org.kuali.rice.krad.valuefinder.ValueFinder> defaultValueFinderClass) Setter for the default value finder classvoidsetDefaultValues(List<Object> defaultValues) Setter for the fields default valuesvoidsetDictionaryAttributeName(String dictionaryAttributeName) Setter for the dictionary attribute namevoidsetDictionaryObjectEntry(String dictionaryObjectEntry) Setter for the dictionary object entryvoidsetEnableAutoInquiry(boolean enableAutoInquiry) Setter for enabling automatic inquiriesvoidsetEscapeHtmlInPropertyValue(boolean escapeHtmlInPropertyValue) Sets HTML escaping for this property value.voidsetForcedValue(String forcedValue) voidSetter for the containers help contentvoidsetHelpSummary(String helpSummary) Setter for the summary help textvoidsetInquiry(Inquiry inquiry) Setter for the inquiry widgetvoidsetMaskFormatter(MaskFormatter maskFormatter) Setter for the MaskFormatter instance to apply when the value is maskedvoidsetMultiLineReadOnlyDisplay(boolean multiLineReadOnlyDisplay) Setter for multiLineReadOnlyDisplayvoidsetPropertyEditor(PropertyEditor propertyEditor) Setter for the custom property editor to use for the fieldvoidsetPropertyEditorClass(Class<? extends PropertyEditor> propertyEditorClass) Convenience setter for configuring a property editor by classvoidsetPropertyName(String propertyName) Setter for the component's property namevoidsetPropertyNamesForAdditionalDisplay(List<String> propertyNamesForAdditionalDisplay) Setter for the list of informational property namesvoidSetter for the alternative display valuevoidsetReadOnlyDisplayReplacementPropertyName(String readOnlyDisplayReplacementPropertyName) Sets the alternate display attribute name to be displayed when the field is readonly.voidsetReadOnlyDisplaySuffix(String value) Setter for the additional display valuevoidsetReadOnlyDisplaySuffixPropertyName(String readOnlyDisplaySuffixPropertyName) Additional display attribute name, which will be displayed next to the actual field value when the field is readonly with hyphen in between like PropertyValue - AdditionalPropertyValuevoidsetReadOnlyListDelimiter(String readOnlyListDelimiter) Set the readOnlyListDelimitervoidsetReadOnlyListDisplayType(String readOnlyListDisplayType) Set the readOnlyListDisplayTypevoidsetRenderInfoMessageSpan(boolean renderInfoMessageSpan) voidsetRenderMarkerIconSpan(boolean renderMarkerIconSpan) voidvoidsetTooltipOfComponent(Tooltip tooltip) Setter for the component's tooltip.Methods inherited from class org.kuali.rice.krad.uif.field.FieldBase
getComponentTypeName, getFieldLabel, getFieldSecurity, getLabel, getLabelColSpan, getLabelStyleClasses, getShortLabel, isEditInLineAuthz, isLabelLeft, isLabelRendered, isViewInLineAuthz, setEditInLineAuthz, setFieldLabel, setLabel, setLabelColSpan, setLabelLeft, setLabelRendered, setLabelStyleClasses, setNestedComponentIdAndSuffix, setShortLabel, setShowLabel, setViewInLineAuthzMethods inherited from class org.kuali.rice.krad.uif.component.ComponentBase
addAriaAttribute, addDataAttribute, addScriptDataAttribute, addStyleClass, addWrapperCssClass, appendToStyle, checkMutable, clone, getAdditionalComponentsToRefresh, getAdditionalComponentsToRefreshJs, getAdditionalCssClasses, getAdditionalTemplates, getAlign, getAriaAttributes, getAriaAttributesAsString, getCanCopyOnReadOnly, getCellWidth, getColSpan, getComponentModifiers, getComponentSecurity, getConditionalRefresh, getConditionalRefreshConditionJs, getConditionalRefreshControlNames, getContainerIdSuffix, getContext, getCssClasses, getCssGridSizes, getDataAttributes, getEventHandlerScript, getExcludeIf, getExcludeUnless, getFieldsToSendOnRefresh, getFinalizeMethodAdditionalArguments, getFinalizeMethodInvoker, getFinalizeMethodToCall, getId, getLibraryCssClasses, getMethodToCallOnRefresh, getOnBlurScript, getOnChangeScript, getOnClickScript, getOnCloseScript, getOnDblClickScript, getOnDocumentReadyScript, getOnFocusScript, getOnInputScript, getOnKeyDownScript, getOnKeyPressScript, getOnKeyUpScript, getOnLoadScript, getOnMouseDownScript, getOnMouseMoveScript, getOnMouseOutScript, getOnMouseOverScript, getOnMouseUpScript, getOnSubmitScript, getOnUnloadScript, getOrder, getPhasePathMapping, getPostRenderContent, getPreRenderContent, getProgressiveDisclosureConditionJs, getProgressiveDisclosureControlNames, getProgressiveRender, getPropertyReplacerComponents, getPropertyReplacers, getReadOnly, getRefreshTimer, getRefreshWhenChangedPropertyNames, getRenderedHtmlOutput, getRequired, getRole, getRowSpan, getScriptDataAttributes, getScriptDataAttributesJs, getSimpleDataAttributes, getStyle, getStyleClassesAsString, getTemplate, getTemplateName, getTemplateOptions, getTemplateOptionsJSString, getTitle, getToolTip, getValign, getViewPath, getViewStatus, getWidth, getWrapperCssClasses, getWrapperCssClassesAsString, getWrapperStyle, isDisableSessionPersistence, isDisclosedByAction, isEditAuthz, isFinal, isForceSessionPersistence, isHidden, isInitialized, isModelApplied, isMutable, isOmitFromFormPost, isProgressiveRenderAndRefresh, isProgressiveRenderViaAJAX, isRefreshedByAction, isRender, isRendered, isResetDataOnRefresh, isRetrieveViaAjax, isSelfRendered, isSkipInTabOrder, isViewAuthz, notifyCompleted, pushAllToContext, pushObjectToContext, pushToPropertyReplacerContext, setAdditionalComponentsToRefresh, setAdditionalCssClasses, setAlign, setAriaAttributes, setCanCopyOnReadOnly, setCellWidth, setColSpan, setComponentModifiers, setConditionalRefresh, setContainerIdSuffix, setContext, setCssClasses, setCssGridSizes, setDataAttributes, setDisableSessionPersistence, setDisclosedByAction, setEditAuthz, setExcludeIf, setExcludeUnless, setFieldsToSendOnRefresh, setFinalizeMethodAdditionalArguments, setFinalizeMethodInvoker, setFinalizeMethodToCall, setForceSessionPersistence, setHidden, setId, setLibraryCssClasses, setMethodToCallOnRefresh, setOmitFromFormPost, setOnBlurScript, setOnChangeScript, setOnClickScript, setOnCloseScript, setOnDblClickScript, setOnDocumentReadyScript, setOnFocusScript, setOnInputScript, setOnKeyDownScript, setOnKeyPressScript, setOnKeyUpScript, setOnLoadScript, setOnMouseDownScript, setOnMouseMoveScript, setOnMouseOutScript, setOnMouseOverScript, setOnMouseUpScript, setOnSubmitScript, setOnUnloadScript, setOrder, setPhasePathMapping, setPostRenderContent, setPreRenderContent, setProgressiveRender, setProgressiveRenderAndRefresh, setProgressiveRenderViaAJAX, setPropertyReplacers, setReadOnly, setRefreshedByAction, setRefreshTimer, setRefreshWhenChangedPropertyNames, setRender, setRenderedHtmlOutput, setRequired, setResetDataOnRefresh, setRetrieveViaAjax, setRole, setRowSpan, setScriptDataAttributes, setSelfRendered, setSkipInTabOrder, setStyle, setTemplate, setTemplateName, setTemplateOptions, setTemplateOptionsJSString, setTitle, setToolTip, setValign, setViewAuthz, setViewPath, setViewStatus, setWidth, setWrapperCssClasses, setWrapperStyle, skipLifecycleMethods inherited from class org.kuali.rice.krad.datadictionary.uif.UifDictionaryBeanBase
getExpressionGraph, getPropertyExpression, getPropertyExpressions, setExpressionGraph, setPropertyExpressionsMethods inherited from class org.kuali.rice.krad.datadictionary.DictionaryBeanBase
copy, dataDictionaryPostProcessing, getComponentCode, getNamespaceCode, setComponentCode, setNamespaceCodeMethods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.kuali.rice.krad.uif.component.Component
addAriaAttribute, addDataAttribute, addScriptDataAttribute, addStyleClass, addWrapperCssClass, appendToStyle, getAdditionalComponentsToRefresh, getAdditionalComponentsToRefreshJs, getAdditionalCssClasses, getAdditionalTemplates, getAlign, getAriaAttributes, getAriaAttributesAsString, getCanCopyOnReadOnly, getCellWidth, getColSpan, getComponentModifiers, getComponentSecurity, getComponentTypeName, getConditionalRefresh, getConditionalRefreshConditionJs, getConditionalRefreshControlNames, getContext, getCssClasses, getCssGridSizes, getDataAttributes, getEventHandlerScript, getExcludeIf, getExcludeUnless, getFieldsToSendOnRefresh, getFinalizeMethodAdditionalArguments, getFinalizeMethodInvoker, getFinalizeMethodToCall, getLibraryCssClasses, getMethodToCallOnRefresh, getOrder, getPostRenderContent, getPreRenderContent, getProgressiveDisclosureConditionJs, getProgressiveDisclosureControlNames, getProgressiveRender, getPropertyReplacerComponents, getPropertyReplacers, getReadOnly, getRefreshTimer, getRefreshWhenChangedPropertyNames, getRenderedHtmlOutput, getRequired, getRole, getRowSpan, getScriptDataAttributes, getScriptDataAttributesJs, getSimpleDataAttributes, getStyle, getStyleClassesAsString, getTemplate, getTemplateName, getTemplateOptions, getTemplateOptionsJSString, getTitle, getToolTip, getValign, getWidth, getWrapperCssClasses, getWrapperStyle, isDisableSessionPersistence, isDisclosedByAction, isForceSessionPersistence, isHidden, isOmitFromFormPost, isProgressiveRenderAndRefresh, isProgressiveRenderViaAJAX, isRefreshedByAction, isRendered, isResetDataOnRefresh, isRetrieveViaAjax, isSelfRendered, setAdditionalComponentsToRefresh, setAdditionalCssClasses, setAlign, setAriaAttributes, setCanCopyOnReadOnly, setCellWidth, setColSpan, setComponentModifiers, setConditionalRefresh, setContext, setCssClasses, setCssGridSizes, setDataAttributes, setDisableSessionPersistence, setDisclosedByAction, setFieldsToSendOnRefresh, setForceSessionPersistence, setHidden, setLibraryCssClasses, setOmitFromFormPost, setOrder, setPostRenderContent, setPreRenderContent, setProgressiveRender, setProgressiveRenderAndRefresh, setProgressiveRenderViaAJAX, setPropertyReplacers, setReadOnly, setRefreshedByAction, setRefreshTimer, setRefreshWhenChangedPropertyNames, setRenderedHtmlOutput, setRequired, setResetDataOnRefresh, setRetrieveViaAjax, setRole, setRowSpan, setScriptDataAttributes, setSelfRendered, setStyle, setTemplate, setTemplateName, setTemplateOptions, setTemplateOptionsJSString, setTitle, setToolTip, setValign, setViewStatus, setWidth, setWrapperCssClasses, setWrapperStyleMethods inherited from interface org.kuali.rice.krad.datadictionary.DictionaryBean
dataDictionaryPostProcessing, getComponentCode, getNamespaceCodeMethods inherited from interface org.kuali.rice.krad.uif.field.Field
getFieldLabel, getFieldSecurity, getLabel, getLabelColSpan, getLabelStyleClasses, getShortLabel, isLabelLeft, isLabelRendered, setFieldLabel, setLabel, setLabelColSpan, setLabelLeft, setLabelRendered, setLabelStyleClasses, setShortLabelMethods inherited from interface org.kuali.rice.krad.uif.util.LifecycleElement
checkMutable, getContainerIdSuffix, getId, getPhasePathMapping, getViewPath, getViewStatus, isFinal, isInitialized, isModelApplied, isMutable, isRender, notifyCompleted, pushAllToContext, pushObjectToContext, setContainerIdSuffix, setId, setPhasePathMapping, setRender, setViewPath, skipLifecycleMethods inherited from interface org.kuali.rice.krad.uif.component.ScriptEventSupport
getOnBlurScript, getOnChangeScript, getOnClickScript, getOnCloseScript, getOnDblClickScript, getOnDocumentReadyScript, getOnFocusScript, getOnInputScript, getOnKeyDownScript, getOnKeyPressScript, getOnKeyUpScript, getOnLoadScript, getOnMouseDownScript, getOnMouseMoveScript, getOnMouseOutScript, getOnMouseOverScript, getOnMouseUpScript, getOnSubmitScript, getOnUnloadScript, setOnBlurScript, setOnChangeScript, setOnClickScript, setOnCloseScript, setOnDblClickScript, setOnDocumentReadyScript, setOnFocusScript, setOnInputScript, setOnKeyDownScript, setOnKeyPressScript, setOnKeyUpScript, setOnLoadScript, setOnMouseDownScript, setOnMouseMoveScript, setOnMouseOutScript, setOnMouseOverScript, setOnMouseUpScript, setOnSubmitScript, setOnUnloadScriptMethods inherited from interface org.kuali.rice.krad.datadictionary.uif.UifDictionaryBean
getExpressionGraph, getPropertyExpression, getPropertyExpressions, setExpressionGraph, setPropertyExpressions
-
Field Details
-
readOnlyDisplayReplacementPropertyName
-
readOnlyDisplaySuffixPropertyName
-
-
Constructor Details
-
DataFieldBase
public DataFieldBase()
-
-
Method Details
-
performInitialization
The following updates are done here:- Invoke performInitialize on component modifiers
Where components can set defaults and setup other necessary state. The initialize method should only be called once per component lifecycle and is invoked within the initialize phase of the view lifecylce.
- Specified by:
performInitializationin interfaceLifecycleElement- Overrides:
performInitializationin classComponentBase- Parameters:
model- - object instance containing the view data- See Also:
-
afterEvaluateExpression
public void afterEvaluateExpression()No-op implementation. Override for custom behavior in subclasses. Invoked by the view lifecycle after expressions are evaluated at the apply model phase.In general, this method is preferred to
LifecycleElement.performApplyModel(Object, LifecycleElement)for populating model data via code, since it is called before client-side state is synchronize.- Specified by:
afterEvaluateExpressionin interfaceComponent- Overrides:
afterEvaluateExpressionin classFieldBase
-
performApplyModel
The following finalization is performed:- Make sure that a label is defined for any data fields. If not then create hidden label using property name.
- If no label for a non data field then just log a warning.
- Evaluate the progressive render condition (if set) and combine with the current render status to set the render status
Where components can perform conditional logic such as dynamically generating new fields or setting field state based on the given data
- Specified by:
performApplyModelin interfaceLifecycleElement- Overrides:
performApplyModelin classFieldBase- Parameters:
model- - Top level object containing the data (could be the form or a top level business object, dto)parent- parent lifecycle element
-
performFinalize
The following finalization is performed:- Set the labelForComponentId to this component id
- Set the label text on the label field from the field's label property
- Set the render property on the label's required message field if this field is marked as required
- progressiveRender and conditionalRefresh variables are processed if set
- If any of the style properties were given, sets the style string on the style property
- Set the skipInTabOrder flag for nested components
Here final preparations can be made based on the updated view state.
- Specified by:
performFinalizein interfaceLifecycleElement- Overrides:
performFinalizein classFieldBase- Parameters:
model- - top level object containing the dataparent- - parent component
-
processReadOnlyListDisplay
This method is called when the list is readOnly as determined in DataField's performFinalize method. This method should be overridden to perform any additional processing to the values before calling generateReadOnlyListDisplayReplacement. The default implementation calls it directly with the originalList.- Parameters:
model- the modeloriginalList- originalList of values
-
generateReadOnlyListDisplayReplacement
Generates the html to be used and sets the readOnlyDisplayReplacement for DataFields that contain lists and do not have their own readOnlyDisplayReplacement defined. The type of html generated is based on the options set on readOnlyListDisplayType and readOnlyListDelimiter.- Parameters:
list- the list to be converted to readOnly html
-
setAlternateAndAdditionalDisplayValue
Sets alternate and additional property value for this field.If
AttributeSecuritypresent in this field, make sure the current user has permission to view the field value. If user doesn't have permission to view the value, mask the value as configured and set it as alternate value for display. If security doesn't exists for this field butalternateDisplayPropertyNamepresent, get its value and format it based on that fields formatting and set for display.For additional display value, if
AttributeSecuritynot present, sets the value ifadditionalDisplayPropertyNamepresent. If not present, check whether this field is aKualiCodeand get the relationship configured in the datadictionary file and set the name additional display value which will be displayed along with the code. If additional display property not present, check whether this field is hasMultiValueControlBase. If yes, get the Label for the value and set it as additional display value.- Parameters:
view- the current view instancemodel- model instance
-
copyFromAttributeDefinition
Defaults the properties of theDataFieldto the corresponding properties of itsAttributeDefinitionretrieved from the dictionary (if such an entry exists). If the field already contains a value for a property, the definitions value is not used.- Specified by:
copyFromAttributeDefinitionin interfaceDataField- Parameters:
attributeDefinition- AttributeDefinition instance the property values should be copied from
-
isInputAllowed
public boolean isInputAllowed()Indicates whether the data field instance allows input, subclasses should override and set to true if input is allowed- Specified by:
isInputAllowedin interfaceDataField- Returns:
- true if input is allowed, false if read only
-
getPropertyName
Name of the property (relative to the parent object) the component binds to- Specified by:
getPropertyNamein interfaceDataBinding- Returns:
- String property name
-
setPropertyName
Setter for the component's property name- Specified by:
setPropertyNamein interfaceDataField- Parameters:
propertyName-
-
getPropertyEditor
Performs formatting of the field value for display and then converting the value back to its expected type from a stringNote property editors exist and are already registered for the basic Java types and the common Kuali types such as [@link KualiDecimal}. Registration with this property is only needed for custom property editors
- Specified by:
getPropertyEditorin interfaceDataField- Returns:
- PropertyEditor property editor instance to use for this field
-
setPropertyEditor
Setter for the custom property editor to use for the field- Specified by:
setPropertyEditorin interfaceDataField- Parameters:
propertyEditor-
-
setPropertyEditorClass
Convenience setter for configuring a property editor by class- Specified by:
setPropertyEditorClassin interfaceDataField- Parameters:
propertyEditorClass-
-
getBindingInfo
Returns theBindingInfoinstance that is configured for the component- Specified by:
getBindingInfoin interfaceDataBinding- Returns:
- BindingInfo
- See Also:
-
setBindingInfo
Setter for the binding info instance- Specified by:
setBindingInfoin interfaceDataBinding- Parameters:
bindingInfo-
-
getName
Returns the full binding path (the path used in the name attribute of the input). This differs from propertyName in that it uses BindingInfo to determine the path. -
getDictionaryAttributeName
Name of the attribute within the data dictionary the attribute field is associated withDuring the initialize phase for the
View, properties for attribute fields are defaulted from a correspondingAttributeDefinitionin the data dictionary. Based on the propertyName and parent object class the framework attempts will determine the attribute definition that is associated with the field and set this property. However this property can also be set in the fields configuration to use another dictionary attribute.The attribute name is used along with the dictionary object entry to find the
AttributeDefinition- Specified by:
getDictionaryAttributeNamein interfaceDataField- Returns:
- attribute name
-
setDictionaryAttributeName
Setter for the dictionary attribute name- Specified by:
setDictionaryAttributeNamein interfaceDataField- Parameters:
dictionaryAttributeName-
-
getDictionaryObjectEntry
Object entry name in the data dictionary the associated attribute is apart ofDuring the initialize phase for the
View, properties for attribute fields are defaulted from a correspondingAttributeDefinitionin the data dictionary. Based on the parent object class the framework will determine the object entry for the associated attribute. However the object entry can be set in the field's configuration to use another object entry for the attributeThe attribute name is used along with the dictionary object entry to find the
AttributeDefinition- Specified by:
getDictionaryObjectEntryin interfaceDataField- Returns:
- String
-
setDictionaryObjectEntry
Setter for the dictionary object entry- Specified by:
setDictionaryObjectEntryin interfaceDataField- Parameters:
dictionaryObjectEntry-
-
getDefaultValue
Default value for the model property the field points toWhen a new
Viewinstance is requested, the corresponding model will be newly created. During this initialization process the value for the model property will be set to the given default value, if it was null. This will only work on properties which can be determined to be null. Therefore a String property with an empty string value will not be ovewritten with the defaultValue set here.In addition, int, boolean, and other primitive types will not use this default value because they inherently have a value in Java (0 for int, false for boolean, etc). To use such types either using a primitive wrapper type (Integer, Boolean, etc) so an unset variable can be determined to be null, or explicitly set the default value on the form/object itself for these types and not through this property.
- Specified by:
getDefaultValuein interfaceDataField- Returns:
- default value
-
setDefaultValue
Setter for the fields default value- Specified by:
setDefaultValuein interfaceDataField- Parameters:
defaultValue-
-
getDefaultValueFinderClass
Gives Class that should be invoked to produce the default value for the field- Specified by:
getDefaultValueFinderClassin interfaceDataField- Returns:
- default value finder class
-
setDefaultValueFinderClass
public void setDefaultValueFinderClass(Class<? extends org.kuali.rice.krad.valuefinder.ValueFinder> defaultValueFinderClass) Setter for the default value finder class- Specified by:
setDefaultValueFinderClassin interfaceDataField- Parameters:
defaultValueFinderClass-
-
getDefaultValues
Array of default values for the model property the field points toWhen a new
Viewinstance is requested, the corresponding model will be newly created. During this initialization process the value for the model property will be set to the given default values (if set)- Specified by:
getDefaultValuesin interfaceDataField- Returns:
- default value
-
setDefaultValues
Setter for the fields default values- Specified by:
setDefaultValuesin interfaceDataField- Parameters:
defaultValues-
-
getForcedValue
For read only DataFields, if forcedValue has a value, the value of it will be used instead of the value received from the propertyName specified for this field; this can be combined with SpringEL to format a property value in some way, for example.- Specified by:
getForcedValuein interfaceDataField- Returns:
- the forced value
-
setForcedValue
- Specified by:
setForcedValuein interfaceDataField- See Also:
-
getHelpSummary
Summary help text for the field- Specified by:
getHelpSummaryin interfaceDataField- Returns:
- summary help text
-
setHelpSummary
Setter for the summary help text- Specified by:
setHelpSummaryin interfaceDataField- Parameters:
helpSummary-
-
getDataFieldSecurity
Data Field Security object that indicates what authorization (permissions) exist for the field- Specified by:
getDataFieldSecurityin interfaceDataField- Returns:
- DataFieldSecurity instance
-
setComponentSecurity
Override to assert aFieldSecurityinstance is set- Specified by:
setComponentSecurityin interfaceComponent- Specified by:
setComponentSecurityin interfaceDataField- Overrides:
setComponentSecurityin classFieldBase- Parameters:
componentSecurity- instance of FieldSecurity
-
initializeComponentSecurity
protected void initializeComponentSecurity()Description copied from class:FieldBaseInitializes (if necessary) the component security instance for the component type- Overrides:
initializeComponentSecurityin classFieldBase- See Also:
-
isAddHiddenWhenReadOnly
public boolean isAddHiddenWhenReadOnly()Indicates the field should be read-only but also a hidden should be generated for the fieldUseful for when a value is just displayed but is needed by script
- Specified by:
isAddHiddenWhenReadOnlyin interfaceDataField- Returns:
- true if field should be readOnly hidden, false if not
-
setAddHiddenWhenReadOnly
public void setAddHiddenWhenReadOnly(boolean addHiddenWhenReadOnly) Setter for the read-only hidden indicator- Specified by:
setAddHiddenWhenReadOnlyin interfaceDataField- Parameters:
addHiddenWhenReadOnly-
-
getInquiry
Inquiry widget for the fieldThe inquiry widget will render a link for the field value when read-only that points to the associated inquiry view for the field. The inquiry can be configured to point to a certain
InquiryView, or the framework will attempt to associate the field with a inquiry based on its metadata (in particular its relationships in the model)- Specified by:
getInquiryin interfaceDataField- Returns:
- Inquiry field inquiry
-
setInquiry
Setter for the inquiry widget- Specified by:
setInquiryin interfaceDataField- Parameters:
inquiry-
-
isEnableAutoInquiry
public boolean isEnableAutoInquiry()Indicates whether inquiries should be automatically set when a relationship for the field's property is foundNote this only applies when the
DataField.getInquiry()widget has not been configured (is null) and is set to true by default- Specified by:
isEnableAutoInquiryin interfaceDataField- Returns:
- true if auto inquiries are enabled, false if not
-
setEnableAutoInquiry
public void setEnableAutoInquiry(boolean enableAutoInquiry) Setter for enabling automatic inquiries- Specified by:
setEnableAutoInquiryin interfaceDataField- Parameters:
enableAutoInquiry-
-
getHelp
Help configuration object for the containerExternal help information can be configured for the container. The
Helpobject can the configuration for rendering a link to that help information. -
setHelp
Setter for the containers help content -
isRenderInfoMessageSpan
public boolean isRenderInfoMessageSpan()When true, render the info message span which contains can contain additional information about the field (used by Field Query functionality)- Specified by:
isRenderInfoMessageSpanin interfaceDataField- Returns:
- true if the span will be rendered, false otherwise
-
setRenderInfoMessageSpan
public void setRenderInfoMessageSpan(boolean renderInfoMessageSpan) - Specified by:
setRenderInfoMessageSpanin interfaceDataField- Parameters:
renderInfoMessageSpan-- See Also:
-
isRenderMarkerIconSpan
public boolean isRenderMarkerIconSpan()When true, render the marker icon span to show icons related to the field (used by CompareFieldCreateModifier on maintenance documetnts to mark editted fields)- Specified by:
isRenderMarkerIconSpanin interfaceDataField- Returns:
- true if the the marker icon span will be rendered, false otherwise
-
setRenderMarkerIconSpan
public void setRenderMarkerIconSpan(boolean renderMarkerIconSpan) - Specified by:
setRenderMarkerIconSpanin interfaceDataField- Parameters:
renderMarkerIconSpan-- See Also:
-
setTooltipOfComponent
Setter for the component's tooltip.This is used by the helper to set the help content to the tooltip.
- Specified by:
setTooltipOfComponentin interfaceHelpable- Parameters:
tooltip- Tooltip with the help for the container
-
getHelpTitle
Help title which is used for the HTML title attribute of the help icon- Specified by:
getHelpTitlein interfaceHelpable- Returns:
- Help title for the container
-
getReadOnlyDisplaySuffixPropertyName
Returns the additional display attribute name to be displayed when the field is readonly- Specified by:
getReadOnlyDisplaySuffixPropertyNamein interfaceDataField- Returns:
- additional display attribute name
-
setReadOnlyDisplaySuffixPropertyName
Additional display attribute name, which will be displayed next to the actual field value when the field is readonly with hyphen in between like PropertyValue - AdditionalPropertyValue- Specified by:
setReadOnlyDisplaySuffixPropertyNamein interfaceDataField- Parameters:
readOnlyDisplaySuffixPropertyName- name of the additional display property
-
getReadOnlyDisplayReplacementPropertyName
Returns the alternate display attribute name to be displayed when the field is readonly.- Specified by:
getReadOnlyDisplayReplacementPropertyNamein interfaceDataField- Returns:
- alternate Display Property Name
-
setReadOnlyDisplayReplacementPropertyName
public void setReadOnlyDisplayReplacementPropertyName(String readOnlyDisplayReplacementPropertyName) Sets the alternate display attribute name to be displayed when the field is readonly. This properties value will be displayed instead of actual fields value when the field is readonly.- Specified by:
setReadOnlyDisplayReplacementPropertyNamein interfaceDataField- Parameters:
readOnlyDisplayReplacementPropertyName- alternate display property name
-
getReadOnlyDisplayReplacement
Returns the alternate display value- Specified by:
getReadOnlyDisplayReplacementin interfaceDataField- Returns:
- the alternate display value set for this field
-
setReadOnlyDisplayReplacement
Setter for the alternative display value- Specified by:
setReadOnlyDisplayReplacementin interfaceDataField- Parameters:
value-
-
getReadOnlyDisplaySuffix
Returns the additional display value.- Specified by:
getReadOnlyDisplaySuffixin interfaceDataField- Returns:
- the additional display value set for this field
-
setReadOnlyDisplaySuffix
Setter for the additional display value- Specified by:
setReadOnlyDisplaySuffixin interfaceDataField- Parameters:
value-
-
getReadOnlyListDisplayType
Gets the readOnlyListDisplayType.When this is not set, the list will default to the delimited list display with a default of comma and space (", ") - if readOnlyListDelimiter is not set as well. The type can be set as the following:
- "DELIMITED" - list will be output with delimiters between each item defined by readOnlyListDelimiter
- "BREAK" - list will be output with breaks between each item
- "OL" - list will be output in ordered list format (numbered)
- "UL" - list will be output in unordered list format (bulleted)
- Specified by:
getReadOnlyListDisplayTypein interfaceDataField- Returns:
- the display type to use
-
setReadOnlyListDisplayType
Set the readOnlyListDisplayType- Specified by:
setReadOnlyListDisplayTypein interfaceDataField- Parameters:
readOnlyListDisplayType-
-
getReadOnlyListDelimiter
The readOnlyListDelimiter is used to set the delimiter used when "DELIMITED" type is set for readOnlyListDisplayType- Specified by:
getReadOnlyListDelimiterin interfaceDataField- Returns:
- the delimiter to use in readOnly list output with "DELIMITED" type set
-
setReadOnlyListDelimiter
Set the readOnlyListDelimiter- Specified by:
setReadOnlyListDelimiterin interfaceDataField- Parameters:
readOnlyListDelimiter-
-
isApplyMask
public boolean isApplyMask()Indicates whether the value for the field should be masked (or partially masked) on displayIf set to true, the field value will be masked by applying the configured
DataField.getMaskFormatter()If a KIM permission exists that should be checked to determine whether the value should be masked or not, this value should not be set but instead the mask or partialMask property on
Component.getComponentSecurity()should be set to true. This indicates there is a mask permission that should be consulted. If the user does not have the permission, this flag will be set to true by the framework and the value masked using the mask formatter configured on the security object- Specified by:
isApplyMaskin interfaceDataField- Returns:
- true if the field value should be masked, false if not
-
setApplyMask
public void setApplyMask(boolean applyMask) Setter for the apply value mask flag- Specified by:
setApplyMaskin interfaceDataField- Parameters:
applyMask-
-
getMaskFormatter
MaskFormatter instance that will be used to mask the field value whenDataField.isApplyMask()is trueNote in cases where the mask is applied due to security (KIM permissions), the mask or partial mask formatter configured on
Component.getComponentSecurity()will be used instead of this mask formatter- Specified by:
getMaskFormatterin interfaceDataField- Returns:
- MaskFormatter instance
-
setMaskFormatter
Setter for the MaskFormatter instance to apply when the value is masked- Specified by:
setMaskFormatterin interfaceDataField- Parameters:
maskFormatter-
-
getAdditionalHiddenPropertyNames
Allows specifying hidden property names without having to specify as a field in the group config (that might impact layout)- Specified by:
getAdditionalHiddenPropertyNamesin interfaceDataField- Returns:
- hidden property names
-
setAdditionalHiddenPropertyNames
Setter for the hidden property names- Specified by:
setAdditionalHiddenPropertyNamesin interfaceDataField- Parameters:
additionalHiddenPropertyNames-
-
getPropertyNamesForAdditionalDisplay
List of property names whose values should be displayed read-only under this fieldIn the attribute field template for each information property name given its values is outputted read-only. Informational property values can also be updated dynamically with the use of field attribute query
Simple property names can be given if the property has the same binding parent as this field, in which case the binding path will be adjusted by the framework. If the property names starts with org.kuali.rice.krad.uif.UifConstants#NO_BIND_ADJUST_PREFIX, no binding prefix will be added.
- Specified by:
getPropertyNamesForAdditionalDisplayin interfaceDataField- Returns:
- informational property names
-
setPropertyNamesForAdditionalDisplay
Setter for the list of informational property names- Specified by:
setPropertyNamesForAdditionalDisplayin interfaceDataField- Parameters:
propertyNamesForAdditionalDisplay-
-
isEscapeHtmlInPropertyValue
public boolean isEscapeHtmlInPropertyValue()Returns true if HTML escape allowed for this field- Specified by:
isEscapeHtmlInPropertyValuein interfaceDataField- Returns:
- true if escaping allowed
-
setEscapeHtmlInPropertyValue
public void setEscapeHtmlInPropertyValue(boolean escapeHtmlInPropertyValue) Sets HTML escaping for this property value. HTML escaping will be handled in alternate and additional fields also.- Specified by:
setEscapeHtmlInPropertyValuein interfaceDataField
-
isMultiLineReadOnlyDisplay
public boolean isMultiLineReadOnlyDisplay()Returns true if this field is of typeTextAreaControl.Used to preserve text formatting in a textarea when the view is readOnly by enclosing the text in a </pre> tag.
- Specified by:
isMultiLineReadOnlyDisplayin interfaceDataField- Returns:
- true if the field is of type
TextAreaControl
-
setMultiLineReadOnlyDisplay
public void setMultiLineReadOnlyDisplay(boolean multiLineReadOnlyDisplay) Setter for multiLineReadOnlyDisplay- Specified by:
setMultiLineReadOnlyDisplayin interfaceDataField- Parameters:
multiLineReadOnlyDisplay-
-
hasSecureValue
public boolean hasSecureValue()Indicates whether the value for the field is secure.A value will be secured if masking has been applied (by configuration or a failed KIM permission) or the field has been marked as hidden due to a required KIM permission check failing.
- Specified by:
hasSecureValuein interfaceDataField- Returns:
- true if value is secure, false if not
-
isRenderFieldset
public boolean isRenderFieldset()- Specified by:
isRenderFieldsetin interfaceDataField
-
getSortAs
Sets the sort type if this field is used within a collectionThe default sort type is the Java class of the property being referenced. Since a String property may actually contain numeric or date values only this property can be used to better set the sort type.
-
setSortAs
-
completeValidation
Validates different requirements of component compiling a series of reports detailing information on errors found in the component. Used by the RiceDictionaryValidator.- Specified by:
completeValidationin interfaceComponent- Specified by:
completeValidationin interfaceDataField- Overrides:
completeValidationin classComponentBase- Parameters:
tracer- Record of component's location- See Also:
-
hasAutoInquiryRelationship
protected boolean hasAutoInquiryRelationship()Determines whether or not to create an automatic inquiry widget for this field within the current lifecycle.- Returns:
- True if an automatic inquiry widget should be created for this field on the current lifecycle.
-