org.kuali.rice.kns.workflow.attribute
Class DataDictionarySearchableAttribute

java.lang.Object
  org.kuali.rice.kns.workflow.attribute.DataDictionarySearchableAttribute

All Implemented Interfaces:

SearchableAttribute

public class DataDictionarySearchableAttribute
extends Object
implements SearchableAttribute

Field Summary

static String

DATA_TYPE_BOOLEAN

Constructor Summary

DataDictionarySearchableAttribute()

Method Summary

protected List<Row>	createFieldRowsForBusinessObject(Class<? extends BusinessObject> businessObjectClass) Creates a list of search fields, one for each primary key of the maintained business object
protected List<Row>	createFieldRowsForWorkflowAttributes(WorkflowAttributes attrs)
List<DocumentAttribute>	extractDocumentAttributes(ExtensionDefinition extensionDefinition, DocumentWithContent documentWithContent) Extracts and returns document attributes for the given document in order to allow indexing of those values for association with the document and use in document searches.
protected List<DocumentAttribute>	findAllDocumentAttributesForGlobalBusinessObject(GlobalBusinessObject globalBO)
protected DocumentAttribute	generateSearchableAttributeFromChange(PersistableBusinessObject changeToPersist)
String	generateSearchContent(ExtensionDefinition extensionDefinition, String documentTypeName, WorkflowAttributeDefinition attributeDefinition) Allows for generation of custom XML for this searchable attribute.
protected Class<? extends BusinessObject>	getBusinessObjectClass(String documentTypeName) Returns the class of the object being maintained by the given maintenance document type name
protected Class<? extends Maintainable>	getMaintainableClass(String documentTypeName) Returns the maintainable of the object being maintained by the given maintenance document type name
List<RemotableAttributeField>	getSearchFields(ExtensionDefinition extensionDefinition, String documentTypeName) Returns a list of RemotableAttributeField objects which define which searchable attribute criteria fields should be included in the criteria section of the document search user interface for this searchable attribute.
protected List<Row>	getSearchingRows(String documentTypeName) Produces legacy KNS rows to use for search attributes.
protected List<DocumentAttribute>	parsePrimaryKeyValuesFromDocument(Class<? extends BusinessObject> businessObjectClass, MaintenanceDocument document)
protected DocumentAttribute	parseSearchableAttributeValueForPrimaryKey(String propertyName, Class<? extends BusinessObject> businessObjectClass, MaintenanceDocument document) Creates a searchable attribute value for the given property name out of the document XML
protected GlobalBusinessObject	retrieveGlobalBusinessObject(String documentNumber, Class<? extends BusinessObject> businessObjectClass)
protected MaintenanceDocumentEntry	retrieveMaintenanceDocumentEntry(String documentTypeName) Retrieves the maintenance document entry for the given document type name
protected void	retrieveValidationErrorsFromGlobalVariables(List<RemotableAttributeError> validationErrors) Retrieves validation errors from GlobalVariables MessageMap and appends to the given list of RemotableAttributeError
List<RemotableAttributeError>	validateDocumentAttributeCriteria(ExtensionDefinition extensionDefinition, DocumentSearchCriteria documentSearchCriteria) Performs custom validation of document attribute values that come from this searchable attribute whenever a document search is performed against a document type which uses this searchable attribute.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DATA_TYPE_BOOLEAN

public static final String DATA_TYPE_BOOLEAN

See Also:

Constant Field Values

Constructor Detail

DataDictionarySearchableAttribute

public DataDictionarySearchableAttribute()

Method Detail

generateSearchContent

public String generateSearchContent(ExtensionDefinition extensionDefinition,
                                    String documentTypeName,
                                    WorkflowAttributeDefinition attributeDefinition)

Description copied from interface: SearchableAttribute

Allows for generation of custom XML for this searchable attribute. The trigger for invocation of custom XML generation happens via the workflow API whenever a document action is taken and a request is submitted to update document XML based on searchable attribute definitions (see DocumentContentUpdate). This XML is ultimately included as part of the document's content.

It is intended that this XML can be used by the extractDocumentAttributes method in order to pull values out for indexing, though this method is free to use any source available to it for extracting data for indexing alongside a document.

A null or blank value may be returned from this method to indicate that no XML was generated.

Specified by:

generateSearchContent in interface SearchableAttribute

Parameters:

extensionDefinition - the extension definition which was used to locate and load this searchable attribute implementation

documentTypeName - the name of the document type for which this method is being invoked

attributeDefinition - contains parameters and properties that can be used to inform generation of the XML, these are supplied by the user of the workflow API when the document's searchable XML content is requested to be updated

Returns:

a String containing valid XML that should be included in the searchable attribute XML section of the document's XML content

extractDocumentAttributes

public List<DocumentAttribute> extractDocumentAttributes(ExtensionDefinition extensionDefinition,
                                                         DocumentWithContent documentWithContent)

Description copied from interface: SearchableAttribute

Extracts and returns document attributes for the given document in order to allow indexing of those values for association with the document and use in document searches. The document and it's XML content is passed to this method as that is a common source of data for indexing purposes, though implementations are free to pull data for indexing from any readily accessible source.

There are a finite set of DocumentAttribute implementations which can be returned and interpreted correctly. Client application's should not create custom extensions of the DocumentAttribute abstract class but should preferably use the DocumentAttributeFactory to construct strongly-typed document attribute instances for indexing.

Specified by:

extractDocumentAttributes in interface SearchableAttribute

Parameters:

extensionDefinition - the extension definition which was used to locate and load this searchable attribute implementation

documentWithContent - the workflow document and it's XML content

Returns:

a list of document attribute values that should be indexed for the given document, or a null or empty list if no attributes should be indexed

See Also:

DocumentAttributeFactory

getSearchFields

public List<RemotableAttributeField> getSearchFields(ExtensionDefinition extensionDefinition,
                                                     String documentTypeName)

Description copied from interface: SearchableAttribute

Returns a list of RemotableAttributeField objects which define which searchable attribute criteria fields should be included in the criteria section of the document search user interface for this searchable attribute.

Specified by:

getSearchFields in interface SearchableAttribute

Parameters:

extensionDefinition - the extension definition which was used to locate and load this searchable attribute implementation

documentTypeName - the name of the document type for which this method is being invoked

Returns:

a list of remotable attribute fields which define the search fields that should be included in the document search criteria, or a null or empty list if no criteria should be included for this searchable attribute

getSearchingRows

protected List<Row> getSearchingRows(String documentTypeName)

Produces legacy KNS rows to use for search attributes. This method was left intact to help ease conversion until KNS is replaced with KRAD.

validateDocumentAttributeCriteria

public List<RemotableAttributeError> validateDocumentAttributeCriteria(ExtensionDefinition extensionDefinition,
                                                                       DocumentSearchCriteria documentSearchCriteria)

Description copied from interface: SearchableAttribute

Performs custom validation of document attribute values that come from this searchable attribute whenever a document search is performed against a document type which uses this searchable attribute. This hook allows for any desired validation of this searchable attributes custom document attribute values to be performed prior to the execution of the document search.

The entire DocumentSearchCriteria is passed to this method, though it's intended that implementing code will pull out the document attribute values on the criteria which are managed by this searchable attribute and perform any desired validation. However, there are certainly no restrictions on this method that would prevent it from performing validations outside of this scope and in relation to other portions of the criteria, though this is certainly not the intent of this validation hook.

Note that this method is invoked when performing a document search from the user interface as well as via the WorkflowDocumentService api.

Specified by:

validateDocumentAttributeCriteria in interface SearchableAttribute

Parameters:

extensionDefinition - the extension definition which was used to locate and load this searchable attribute implementation

documentSearchCriteria - the criteria that was submitted to the document search and against which validation is requested

Returns:

a list of attribute errors containing and validation failure errors messages for the relevant document attributes, if this returns a null or empty list it means that validation was successful

retrieveValidationErrorsFromGlobalVariables

protected void retrieveValidationErrorsFromGlobalVariables(List<RemotableAttributeError> validationErrors)

Retrieves validation errors from GlobalVariables MessageMap and appends to the given list of RemotableAttributeError

Parameters:

validationErrors - list to append validation errors

createFieldRowsForWorkflowAttributes

protected List<Row> createFieldRowsForWorkflowAttributes(WorkflowAttributes attrs)

parsePrimaryKeyValuesFromDocument

protected List<DocumentAttribute> parsePrimaryKeyValuesFromDocument(Class<? extends BusinessObject> businessObjectClass,
                                                                    MaintenanceDocument document)

parseSearchableAttributeValueForPrimaryKey

protected DocumentAttribute parseSearchableAttributeValueForPrimaryKey(String propertyName,
                                                                       Class<? extends BusinessObject> businessObjectClass,
                                                                       MaintenanceDocument document)

Creates a searchable attribute value for the given property name out of the document XML

Parameters:

propertyName - the name of the property to return

businessObjectClass - the class of the business object maintained

document - the document XML

Returns:

a generated SearchableAttributeValue, or null if a value could not be created

getBusinessObjectClass

protected Class<? extends BusinessObject> getBusinessObjectClass(String documentTypeName)

Returns the class of the object being maintained by the given maintenance document type name

Parameters:

documentTypeName - the name of the document type to look up the maintained business object for

Returns:

the class of the maintained business object

getMaintainableClass

protected Class<? extends Maintainable> getMaintainableClass(String documentTypeName)

Returns the maintainable of the object being maintained by the given maintenance document type name

Parameters:

documentTypeName - the name of the document type to look up the maintained business object for

Returns:

the Maintainable of the maintained business object

retrieveMaintenanceDocumentEntry

protected MaintenanceDocumentEntry retrieveMaintenanceDocumentEntry(String documentTypeName)

Retrieves the maintenance document entry for the given document type name

Parameters:

documentTypeName - the document type name to look up the data dictionary document entry for

Returns:

the corresponding data dictionary entry for a maintenance document

retrieveGlobalBusinessObject

protected GlobalBusinessObject retrieveGlobalBusinessObject(String documentNumber,
                                                            Class<? extends BusinessObject> businessObjectClass)

findAllDocumentAttributesForGlobalBusinessObject

protected List<DocumentAttribute> findAllDocumentAttributesForGlobalBusinessObject(GlobalBusinessObject globalBO)

generateSearchableAttributeFromChange

protected DocumentAttribute generateSearchableAttributeFromChange(PersistableBusinessObject changeToPersist)

createFieldRowsForBusinessObject

protected List<Row> createFieldRowsForBusinessObject(Class<? extends BusinessObject> businessObjectClass)

Creates a list of search fields, one for each primary key of the maintained business object

Parameters:

businessObjectClass - the class of the maintained business object

Returns:

a List of KEW search fields