/*

  * Copyright 2011 The Kuali Foundation

  *

  * Licensed under the Educational Community License, Version 1.0 (the "License");

  * you may not use this file except in compliance with the License.

  * You may obtain a copy of the License at

  *

  * http://www.opensource.org/licenses/ecl1.php

  *

  * Unless required by applicable law or agreed to in writing, software

  * distributed under the License is distributed on an "AS IS" BASIS,

  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  * See the License for the specific language governing permissions and

  * limitations under the License.

  */

 package org.kuali.rice.kns.uif.service.impl;

 import java.security.GeneralSecurityException;

 import java.sql.Date;

 import java.util.ArrayList;

 import java.util.Collection;

 import java.util.Collections;

 import java.util.HashMap;

 import java.util.HashSet;

 import java.util.Iterator;

 import java.util.List;

 import java.util.Map;

 import java.util.Properties;

 import java.util.Set;

 import org.apache.commons.beanutils.PropertyUtils;

 import org.apache.commons.lang.BooleanUtils;

 import org.apache.commons.lang.StringUtils;

 import org.kuali.rice.core.api.encryption.EncryptionService;

 import org.kuali.rice.core.api.services.CoreApiServiceLocator;

 import org.kuali.rice.core.util.RiceKeyConstants;

 import org.kuali.rice.core.util.type.TypeUtils;

 import org.kuali.rice.core.web.format.DateFormatter;

 import org.kuali.rice.core.web.format.Formatter;

 import org.kuali.rice.kim.bo.Person;

 import org.kuali.rice.kns.authorization.BusinessObjectRestrictions;

 import org.kuali.rice.kns.bo.ExternalizableBusinessObject;

 import org.kuali.rice.kns.datadictionary.BusinessObjectEntry;

 import org.kuali.rice.kns.datadictionary.RelationshipDefinition;

 import org.kuali.rice.kns.exception.ValidationException;

 import org.kuali.rice.kns.lookup.HtmlData;

 import org.kuali.rice.kns.lookup.HtmlData.AnchorHtmlData;

 import org.kuali.rice.kns.lookup.LookupUtils;

 import org.kuali.rice.kns.service.BusinessObjectAuthorizationService;

 import org.kuali.rice.kns.service.BusinessObjectDictionaryService;

 import org.kuali.rice.kns.service.DataObjectMetaDataService;

 import org.kuali.rice.kns.service.KNSServiceLocator;

 import org.kuali.rice.kns.service.KNSServiceLocatorWeb;

 import org.kuali.rice.kns.service.LookupService;

 import org.kuali.rice.kns.service.MaintenanceDocumentDictionaryService;

 import org.kuali.rice.kns.service.ModuleService;

 import org.kuali.rice.kns.service.PersistenceStructureService;

 import org.kuali.rice.kns.uif.UifConstants;

 import org.kuali.rice.kns.uif.UifParameters;

 import org.kuali.rice.kns.uif.container.LookupView;

 import org.kuali.rice.kns.uif.container.View;

 import org.kuali.rice.kns.uif.core.Component;

 import org.kuali.rice.kns.uif.field.AttributeField;

 import org.kuali.rice.kns.uif.field.GeneratedField;

 import org.kuali.rice.kns.uif.field.LookupCriteriaAttributeField;

 import org.kuali.rice.kns.uif.service.LookupViewHelperService;

 import org.kuali.rice.kns.util.BeanPropertyComparator;

 import org.kuali.rice.kns.util.ExternalizableBusinessObjectUtils;

 import org.kuali.rice.kns.util.GlobalVariables;

 import org.kuali.rice.kns.util.KNSConstants;

 import org.kuali.rice.kns.util.ObjectUtils;

 import org.kuali.rice.kns.util.UrlFactory;

 import org.kuali.rice.kns.web.spring.controller.MaintenanceDocumentController;

 import org.springframework.web.util.HtmlUtils;

 /**

  * @author Kuali Rice Team (rice.collab@kuali.org)

  */

 public class LookupViewHelperServiceImpl extends ViewHelperServiceImpl implements LookupViewHelperService {

         protected static final org.apache.log4j.Logger LOG = org.apache.log4j.Logger.getLogger(LookupViewHelperServiceImpl.class);

         public static final String TITLE_RETURN_URL_PREPENDTEXT_PROPERTY = "title.return.url.value.prependtext";

         public static final String TITLE_ACTION_URL_PREPENDTEXT_PROPERTY = "title.action.url.value.prependtext";

         public static final String ACTION_URLS_CHILDREN_SEPARATOR = " | ";

         public static final String ACTION_URLS_CHILDREN_STARTER = " [";

         public static final String ACTION_URLS_CHILDREN_END = "]";

         public static final String ACTION_URLS_SEPARATOR = "  ";

         public static final String ACTION_URLS_EMPTY = " ";

         private transient LookupService lookupService;

         // TODO delyea - investigate if encryptionService is even needed due to new spring binding

         private transient EncryptionService encryptionService;

         private transient BusinessObjectDictionaryService businessObjectDictionaryService;

         private transient DataObjectMetaDataService dataObjectMetaDataService;

         private transient MaintenanceDocumentDictionaryService maintenanceDocumentDictionaryService;

         private transient BusinessObjectAuthorizationService businessObjectAuthorizationService;

         private transient PersistenceStructureService persistenceStructureService;

         protected Class<?> dataObjectClass;

         protected String returnLocation;

         protected String returnFormKey;

         protected String docNum;

         protected String referencesToRefresh;

         protected boolean searchUsingOnlyPrimaryKeyValues = false;

         protected boolean hideReturnLink = false;

         protected Map<String, String> fieldConversions;

         protected Map parameters;

         protected List<String> readOnlyFieldsList;

         protected boolean atLeastOneRowReturnable = false;

     protected boolean atLeastOneRowHasActions = false;

     private boolean suppressActions = false;

     private boolean showMaintenanceLinks = false;

         protected List<String> defaultSortAttributeNames;

         // TODO delyea: where to take into account the sort ascending value (old KNS appeared to ignore?)

         protected boolean sortAscending;

         /**

          * Default Constructor

          * 

          */

         public LookupViewHelperServiceImpl() {

                 super();

         }

         /**

      * @see org.kuali.rice.kns.uif.service.impl.ViewHelperServiceImpl#populateViewFromRequestParameters(org.kuali.rice.kns.uif.container.View, java.util.Map)

      */

     @Override

     public void populateViewFromRequestParameters(View view, Map<String, String> parameters) {

             super.populateViewFromRequestParameters(view, parameters);

             setParameters(parameters);

     }

         /**

          * Initialization of Lookupable requires that the business object class be set for the {@link #initializeAttributeFieldFromDataDictionary(View, AttributeField)} method

          * 

          * @see org.kuali.rice.kns.uif.service.impl.ViewHelperServiceImpl#performInitialization(org.kuali.rice.kns.uif.container.View)

          */

         @Override

         public void performInitialization(View view) {

                 if (!LookupView.class.isAssignableFrom(view.getClass())) {

                         throw new IllegalArgumentException("View class '" + view.getClass() + " is not assignable from the '" + LookupView.class + "'");

                 }

                 LookupView lookupView = (LookupView) view;

                 initializeLookupViewHelperService(lookupView);

                 super.performInitialization(view);

         }

         protected void initializeLookupViewHelperService(LookupView lookupView) {

                 setDefaultSortAttributeNames(lookupView.getDefaultSortAttributeNames());

                 setSortAscending(lookupView.isSortAscending());

                 setDataObjectClass(lookupView.getDataObjectClassName());

         }

         /**

          * After initial Data Dictionary initialization of an {@link AttributeField} , the binding path will need to be changed if the initial 'binding object path' is set to

          * {@link UifConstants.LookupModelPropertyNames#CRITERIA_FIELDS}. The exact 'binding path' that needs to be set will be to convert a nested property path to one that allows for mapping to a

          * {@link Map} object.

          * 

          * eg: If the existing 'binding object path' is set to 'criteriaMap' and the 'binding name' is 'subAccount' then the default 'binding path' will be 'criteriaMap.subAccount'. In the case of lookups

          * we need the 'binding path' to be set to 'criteriaMap[subAccount]'.

          * 

          * @see org.kuali.rice.kns.uif.service.impl.ViewHelperServiceImpl#initializeAttributeFieldFromDataDictionary(org.kuali.rice.kns.uif.container.View, org.kuali.rice.kns.uif.field.AttributeField)

          */

         @Override

         protected void initializeAttributeFieldFromDataDictionary(View view, AttributeField field) {

                 super.initializeAttributeFieldFromDataDictionary(view, field);

 //                if (StringUtils.equals(UifPropertyPaths.CRITERIA_FIELDS, field.getBindingInfo().getBindingObjectPath())) {

 //                        field.getBindingInfo().setBindingPath(field.getBindingInfo().getBindingObjectPath() + "[" + field.getBindingInfo().getBindingName() + "]");

 //                }

         }

         /**

          * When the dictionary model class is retrieved for an AttributeField where the BindingObjectPath is equal to the {@link org.kuali.rice.kns.web.spring.form.LookupForm} criteria fields object...

          * the BusinessObjectClass needs to be returned to fetch the proper data dictionary entry.

          * 

          * @see org.kuali.rice.kns.uif.service.impl.ViewHelperServiceImpl#getDictionaryModelClass(org.kuali.rice.kns.uif.container.View, org.kuali.rice.kns.uif.field.AttributeField)

          */

 //        @Override

 //        protected Class<?> getDictionaryModelClass(View view, AttributeField field) {

 //                // if the field binding object path matches the map name on the

 //                // LookupForm model then use BO class rather than looking up dictionary

 //                // model class

 //                if (StringUtils.equals(UifPropertyPaths.CRITERIA_FIELDS, field.getBindingInfo().getBindingObjectPath())) {

 //                        return getDataObjectClass();

 //                }

 //                

 //                return ViewModelUtils.getPropertyType(view, field.getBindingInfo().getBindingObjectPath());

 //        }

         /**

          * @see org.kuali.rice.kns.uif.service.LookupViewHelperService#validateSearchParameters(java.util.List, java.util.Map)

          */

         public void validateSearchParameters(List<? extends Component> criteriaComponents, Map<String, String> fieldValues) {

                 if (!getViewDictionaryService().isLookupable(getDataObjectClass())) {

                         throw new RuntimeException("Lookup not defined for data object " + getDataObjectClass());

                 }

                 for (Component component : criteriaComponents) {

                 if (AttributeField.class.isAssignableFrom(component.getClass())) {

                         AttributeField attributeField = (AttributeField) component;

                                 if (fieldValues.containsKey(attributeField.getPropertyName())) {

                                         String attributeValue = fieldValues.get(attributeField.getPropertyName());

                                         // check for required if field does not have value

                                         if (StringUtils.isBlank(attributeValue)) {

                                                 if (BooleanUtils.isTrue(attributeField.getRequired())) {

                                                         GlobalVariables.getMessageMap().putError(attributeField.getPropertyName(), RiceKeyConstants.ERROR_REQUIRED, attributeField.getLabel());

                                                 }

                                         }

                                         validateSearchParameterWildcardAndOperators(attributeField, attributeValue);

                                 }

                 }

         }

                 if (GlobalVariables.getMessageMap().hasErrors()) {

                         throw new ValidationException("errors in search criteria");

                 }

         }

         protected void validateSearchParameterWildcardAndOperators(AttributeField attributeField, String attributeValue) {

                 if (StringUtils.isBlank(attributeValue))

                         return;

                 // make sure a wildcard/operator is in the value

                 boolean found = false;

                 for (int i = 0; i < KNSConstants.QUERY_CHARACTERS.length; i++) {

                         String queryCharacter = KNSConstants.QUERY_CHARACTERS[i];

                         if (attributeValue.contains(queryCharacter)) {

                                 found = true;

                         }

                 }

                 if (!found)

                         return;

                 String attributeLabel = getDataDictionaryService().getAttributeLabel(getDataObjectClass(), attributeField.getPropertyName());

                 if ( (LookupCriteriaAttributeField.class.isAssignableFrom(attributeField.getClass())) &&

                          (((LookupCriteriaAttributeField) attributeField).isTreatWildcardsAndOperatorsAsLiteral())

                         ) {

                         Object dataObjectExample = null;

                         try {

                                 dataObjectExample = getDataObjectClass().newInstance();

                         } catch (Exception e) {

                                 LOG.error("Exception caught instantiating " + getDataObjectClass().getName(), e);

                                 throw new RuntimeException("Cannot instantiate " + getDataObjectClass().getName(), e);

                         }

                         Class<?> propertyType = ObjectUtils.getPropertyType(dataObjectExample, attributeField.getPropertyName(), getPersistenceStructureService());

                         if (TypeUtils.isIntegralClass(propertyType) || TypeUtils.isDecimalClass(propertyType) || TypeUtils.isTemporalClass(propertyType)) {

                                 GlobalVariables.getMessageMap().putError(attributeField.getPropertyName(), RiceKeyConstants.ERROR_WILDCARDS_AND_OPERATORS_NOT_ALLOWED_ON_FIELD, attributeLabel);

                         }

                         if (TypeUtils.isStringClass(propertyType)) {

                                 GlobalVariables.getMessageMap().putInfo(attributeField.getPropertyName(), RiceKeyConstants.INFO_WILDCARDS_AND_OPERATORS_TREATED_LITERALLY, attributeLabel);

                         }

                 } else {

                         if (getBusinessObjectAuthorizationService().attributeValueNeedsToBeEncryptedOnFormsAndLinks(getDataObjectClass(), attributeField.getPropertyName())) {

                                 if (!attributeValue.endsWith(EncryptionService.ENCRYPTION_POST_PREFIX)) {

                                         // encrypted values usually come from the DB, so we don't

                                         // need to filter for wildcards

                                         // wildcards are not allowed on restricted fields, because

                                         // they are typically encrypted, and wildcard searches

                                         // cannot be performed without

                                         // decrypting every row, which is currently not supported by

                                         // KNS

                                         GlobalVariables.getMessageMap().putError(attributeField.getPropertyName(), RiceKeyConstants.ERROR_SECURE_FIELD, attributeLabel);

                                 }

                         }

                 }

         }

         /**

          * @see org.kuali.rice.kns.uif.service.LookupViewHelperService#performClear(java.util.Map)

          */

         public Map<String, String> performClear(Map<String, String> fieldsForLookup) {

                 Map<String, String> newFieldsForLookup = new HashMap<String, String>();

                 if (fieldsForLookup != null) {

                         for (Map.Entry<String, String> entry : fieldsForLookup.entrySet()) {

                                 // check here to see if this field is a criteria element on the form

                                 newFieldsForLookup.put(entry.getKey(), entry.getValue());

                         }

                 }

                 return newFieldsForLookup;

         }

         /**

          * @see org.kuali.rice.kns.uif.service.LookupViewHelperService#performSearch(java.util.Map, boolean)

          */

         public Collection<?> performSearch(Map<String, String> criteriaFieldsForLookup, boolean bounded) {

                 Collection<?> displayList;

                 preprocessDateFields(criteriaFieldsForLookup);

                 // TODO delyea: switch the bounded flag to be unbounded to match underlying method calls in getSearchResultsWithBounding()

                 displayList = getSearchResultsWithBounding(LookupUtils.forceUppercase(getDataObjectClass(), criteriaFieldsForLookup), !bounded);

                 // TODO delyea - is this the best way to set that the entire set has a returnable row?

                 List<String> pkNames = getDataObjectMetaDataService().listPrimaryKeyFieldNames(getDataObjectClass());

                 Person user = GlobalVariables.getUserSession().getPerson();

                 for (Object object : displayList) {

                 if (isResultReturnable(object)) {

                         setAtLeastOneRowReturnable(true);

                 }

                 BusinessObjectRestrictions dataObjectRestrictions = getBusinessObjectAuthorizationService().getLookupResultRestrictions(object, user);

                 String actionUrls = getActionUrls(object, pkNames, dataObjectRestrictions);

                         if (StringUtils.isNotBlank(HtmlUtils.htmlUnescape(actionUrls).replace('\u00A0', '\u0020'))) {

                                 setAtLeastOneRowHasActions(true);

                         }

                         if (isAtLeastOneRowReturnable() && isAtLeastOneRowHasActions()) {

                                 break;

                         }

         }

                 return displayList;

         }

         /**

          * changes from/to dates into the range operators the lookupable dao expects ("..",">" etc) this method modifies the passed in map and returns a list containing only the modified fields

          * 

          * @param lookupFormFields

          */

         protected Map<String, String> preprocessDateFields(Map<String, String> lookupFormFields) {

                 Map<String, String> fieldsToUpdate = new HashMap<String, String>();

                 Set<String> fieldsForLookup = lookupFormFields.keySet();

                 for (String propName : fieldsForLookup) {

                         if (propName.startsWith(KNSConstants.LOOKUP_RANGE_LOWER_BOUND_PROPERTY_PREFIX)) {

                                 String from_DateValue = lookupFormFields.get(propName);

                                 String dateFieldName = StringUtils.remove(propName, KNSConstants.LOOKUP_RANGE_LOWER_BOUND_PROPERTY_PREFIX);

                                 String to_DateValue = lookupFormFields.get(dateFieldName);

                                 String newPropValue = to_DateValue;// maybe clean above with

                                 // ObjectUtils.clean(propertyValue)

                                 if (StringUtils.isNotEmpty(from_DateValue) && StringUtils.isNotEmpty(to_DateValue)) {

                                         newPropValue = from_DateValue + KNSConstants.BETWEEN_OPERATOR + to_DateValue;

                                 } else if (StringUtils.isNotEmpty(from_DateValue) && StringUtils.isEmpty(to_DateValue)) {

                                         newPropValue = ">=" + from_DateValue;

                                 } else if (StringUtils.isNotEmpty(to_DateValue) && StringUtils.isEmpty(from_DateValue)) {

                                         newPropValue = "<=" + to_DateValue;

                                 } // could optionally continue on else here

                                 fieldsToUpdate.put(dateFieldName, newPropValue);

                         }

                 }

                 // update lookup values from found date values to update

                 Set<String> keysToUpdate = fieldsToUpdate.keySet();

                 for (String updateKey : keysToUpdate) {

                         lookupFormFields.put(updateKey, fieldsToUpdate.get(updateKey));

                 }

                 return fieldsToUpdate;

         }

         protected List<?> getSearchResultsWithBounding(Map<String, String> fieldValues, boolean unbounded) {

                 // remove hidden fields

                 LookupUtils.removeHiddenCriteriaFields(getDataObjectClass(), fieldValues);

                 searchUsingOnlyPrimaryKeyValues = getLookupService().allPrimaryKeyValuesPresentAndNotWildcard(getDataObjectClass(), fieldValues);

                 setReturnLocation(fieldValues.get(UifParameters.RETURN_LOCATION));

                 setReturnFormKey(fieldValues.get(UifParameters.RETURN_FORM_KEY));

                 setReferencesToRefresh(fieldValues.get(KNSConstants.REFERENCES_TO_REFRESH));

                 List<?> searchResults;

                 Map<String, String> nonBlankFieldValues = new HashMap<String, String>();

                 for (String fieldName : fieldValues.keySet()) {

                         String fieldValue = fieldValues.get(fieldName);

                         if (StringUtils.isNotBlank(fieldValue)) {

                                 if (fieldValue.endsWith(EncryptionService.ENCRYPTION_POST_PREFIX)) {

                                         String encryptedValue = StringUtils.removeEnd(fieldValue, EncryptionService.ENCRYPTION_POST_PREFIX);

                                         try {

                                                 fieldValue = getEncryptionService().decrypt(encryptedValue);

                                         } catch (GeneralSecurityException e) {

                                                 LOG.error("Error decrypting value for business object class " + getDataObjectClass() + " attribute " + fieldName, e);

                                                 throw new RuntimeException("Error decrypting value for business object class " + getDataObjectClass() + " attribute " + fieldName, e);

                                         }

                                 }

                                 nonBlankFieldValues.put(fieldName, fieldValue);

                         }

                 }

                 // If this class is an EBO, just call the module service to get the

                 // results

                 if (ExternalizableBusinessObject.class.isAssignableFrom(getDataObjectClass())) {

                         ModuleService eboModuleService = KNSServiceLocatorWeb.getKualiModuleService().getResponsibleModuleService(getDataObjectClass());

                         BusinessObjectEntry ddEntry = eboModuleService.getExternalizableBusinessObjectDictionaryEntry(getDataObjectClass());

                         Map<String, String> filteredFieldValues = new HashMap<String, String>();

                         for (String fieldName : nonBlankFieldValues.keySet()) {

                                 if (ddEntry.getAttributeNames().contains(fieldName)) {

                                         filteredFieldValues.put(fieldName, nonBlankFieldValues.get(fieldName));

                                 }

                         }

                         searchResults = eboModuleService.getExternalizableBusinessObjectsListForLookup((Class<? extends ExternalizableBusinessObject>) getDataObjectClass(), (Map) filteredFieldValues, unbounded);

                         // if any of the properties refer to an embedded EBO, call the EBO

                         // lookups first and apply to the local lookup

                 } else if (hasExternalBusinessObjectProperty(getDataObjectClass(), nonBlankFieldValues)) {

                         if (LOG.isDebugEnabled()) {

                                 LOG.debug("has EBO reference: " + getDataObjectClass());

                                 LOG.debug("properties: " + nonBlankFieldValues);

                         }

                         // remove the EBO criteria

                         Map<String, String> nonEboFieldValues = removeExternalizableBusinessObjectFieldValues(getDataObjectClass(), nonBlankFieldValues);

                         if (LOG.isDebugEnabled()) {

                                 LOG.debug("Non EBO properties removed: " + nonEboFieldValues);

                         }

                         // get the list of EBO properties attached to this object

                         List<String> eboPropertyNames = getExternalizableBusinessObjectProperties(getDataObjectClass(), nonBlankFieldValues);

                         if (LOG.isDebugEnabled()) {

                                 LOG.debug("EBO properties: " + eboPropertyNames);

                         }

                         // loop over those properties

                         for (String eboPropertyName : eboPropertyNames) {

                                 // extract the properties as known to the EBO

                                 Map<String, String> eboFieldValues = getExternalizableBusinessObjectFieldValues(eboPropertyName, nonBlankFieldValues);

                                 if (LOG.isDebugEnabled()) {

                                         LOG.debug("EBO properties for master EBO property: " + eboPropertyName);

                                         LOG.debug("properties: " + eboFieldValues);

                                 }

                                 // run search against attached EBO's module service

                                 ModuleService eboModuleService = KNSServiceLocatorWeb.getKualiModuleService().getResponsibleModuleService(getExternalizableBusinessObjectClass(getDataObjectClass(), eboPropertyName));

                                 // KULRICE-4401 made eboResults an empty list and only filled if

                                 // service is found.

                                 List<?> eboResults = Collections.emptyList();

                                 if (eboModuleService != null) {

                                         eboResults = eboModuleService.getExternalizableBusinessObjectsListForLookup(getExternalizableBusinessObjectClass(getDataObjectClass(), eboPropertyName), (Map) eboFieldValues,

                                                 unbounded);

                                 } else {

                                         LOG.debug("EBO ModuleService is null: " + eboPropertyName);

                                 }

                                 // get the mapping/relationship between the EBO object and it's

                                 // parent object

                                 // use that to adjust the fieldValues

                                 // get the parent property type

                                 Class<?> eboParentClass;

                                 String eboParentPropertyName;

                                 if (ObjectUtils.isNestedAttribute(eboPropertyName)) {

                                         eboParentPropertyName = StringUtils.substringBeforeLast(eboPropertyName, ".");

                                         try {

                                                 eboParentClass = PropertyUtils.getPropertyType(getDataObjectClass().newInstance(), eboParentPropertyName);

                                         } catch (Exception ex) {

                                                 throw new RuntimeException("Unable to create an instance of the business object class: " + getDataObjectClass().getName(), ex);

                                         }

                                 } else {

                                         eboParentClass = getDataObjectClass();

                                         eboParentPropertyName = null;

                                 }

                                 if (LOG.isDebugEnabled()) {

                                         LOG.debug("determined EBO parent class/property name: " + eboParentClass + "/" + eboParentPropertyName);

                                 }

                                 // look that up in the DD (BOMDS)

                                 // find the appropriate relationship

                                 // CHECK THIS: what if eboPropertyName is a nested attribute -

                                 // need to strip off the eboParentPropertyName if not null

                                 RelationshipDefinition rd = getDataObjectMetaDataService().getDictionaryRelationship(eboParentClass, eboPropertyName);

                                 if (LOG.isDebugEnabled()) {

                                         LOG.debug("Obtained RelationshipDefinition for " + eboPropertyName);

                                         LOG.debug(rd);

                                 }

                                 // copy the needed properties (primary only) to the field values KULRICE-4446 do so only if the relationship definition exists

                                 // NOTE: this will work only for single-field PK unless the ORM

                                 // layer is directly involved

                                 // (can't make (field1,field2) in ( (v1,v2),(v3,v4) ) style

                                 // queries in the lookup framework

                                 if (ObjectUtils.isNotNull(rd)) {

                                         if (rd.getPrimitiveAttributes().size() > 1) {

                                                 throw new RuntimeException("EBO Links don't work for relationships with multiple-field primary keys.");

                                         }

                                         String boProperty = rd.getPrimitiveAttributes().get(0).getSourceName();

                                         String eboProperty = rd.getPrimitiveAttributes().get(0).getTargetName();

                                         StringBuffer boPropertyValue = new StringBuffer();

                                         // loop over the results, making a string that the lookup

                                         // DAO will convert into an

                                         // SQL "IN" clause

                                         for (Object ebo : eboResults) {

                                                 if (boPropertyValue.length() != 0) {

                                                         boPropertyValue.append("|");

                                                 }

                                                 try {

                                                         boPropertyValue.append(PropertyUtils.getProperty(ebo, eboProperty).toString());

                                                 } catch (Exception ex) {

                                                         LOG.warn("Unable to get value for " + eboProperty + " on " + ebo);

                                                 }

                                         }

                                         if (eboParentPropertyName == null) {

                                                 // non-nested property containing the EBO

                                                 nonEboFieldValues.put(boProperty, boPropertyValue.toString());

                                         } else {

                                                 // property nested within the main searched-for BO that

                                                 // contains the EBO

                                                 nonEboFieldValues.put(eboParentPropertyName + "." + boProperty, boPropertyValue.toString());

                                         }

                                 }

                         }

                         if (LOG.isDebugEnabled()) {

                                 LOG.debug("Passing these results into the lookup service: " + nonEboFieldValues);

                         }

                         // add those results as criteria

                         // run the normal search (but with the EBO critieria added)

                         searchResults = (List<?>) getLookupService().findCollectionBySearchHelper(getDataObjectClass(), nonEboFieldValues, unbounded);

                 } else {

                         searchResults = (List<?>) getLookupService().findCollectionBySearchHelper(getDataObjectClass(), nonBlankFieldValues, unbounded);

                 }

                 if (searchResults == null) {

                         searchResults = new ArrayList<Object>();

                 }

                 // sort list if default sort column given

                 List<String> defaultSortColumns = getDefaultSortAttributeNames();

                 if ((defaultSortColumns != null) && (defaultSortColumns.size() > 0)) {

                         Collections.sort(searchResults, new BeanPropertyComparator(defaultSortColumns, true));

                 }

                 return searchResults;

         }

         /**

          * Checks whether any of the fieldValues being passed refer to a property within an ExternalizableBusinessObject.

          */

         protected boolean hasExternalBusinessObjectProperty(Class<?> boClass, Map<String, String> fieldValues) {

                 try {

                         Object sampleBo = boClass.newInstance();

                         for (String key : fieldValues.keySet()) {

                                 if (isExternalBusinessObjectProperty(sampleBo, key)) {

                                         return true;

                                 }

                         }

                 } catch (Exception ex) {

                         LOG.debug("Unable to check " + boClass + " for EBO properties.", ex);

                 }

                 return false;

         }

         /**

          * Check whether the given property represents a property within an EBO starting with the sampleBo object given. This is used to determine if a criteria needs to be applied to the EBO first,

          * before sending to the normal lookup DAO.

          */

         protected boolean isExternalBusinessObjectProperty(Object sampleBo, String propertyName) {

                 try {

                         if (propertyName.indexOf(".") > 0 && !StringUtils.contains(propertyName, "add.")) {

                                 Class<?> propertyClass = PropertyUtils.getPropertyType(sampleBo, StringUtils.substringBeforeLast(propertyName, "."));

                                 if (propertyClass != null) {

                                         return ExternalizableBusinessObjectUtils.isExternalizableBusinessObjectInterface(propertyClass);

                                 }

                                 if (LOG.isDebugEnabled()) {

                                         LOG.debug("unable to get class for " + StringUtils.substringBeforeLast(propertyName, ".") + " on " + sampleBo.getClass().getName());

                                 }

                         }

                 } catch (Exception e) {

                         LOG.debug("Unable to determine type of property for " + sampleBo.getClass().getName() + "/" + propertyName, e);

                 }

                 return false;

         }

         /**

          * Returns a map stripped of any properties which refer to ExternalizableBusinessObjects. These values may not be passed into the lookup service, since the objects they refer to are not in the

          * local database.

          */

         protected Map<String, String> removeExternalizableBusinessObjectFieldValues(Class<?> boClass, Map<String, String> fieldValues) {

                 Map<String, String> eboFieldValues = new HashMap<String, String>();

                 try {

                         Object sampleBo = boClass.newInstance();

                         for (String key : fieldValues.keySet()) {

                                 if (!isExternalBusinessObjectProperty(sampleBo, key)) {

                                         eboFieldValues.put(key, fieldValues.get(key));

                                 }

                         }

                 } catch (Exception ex) {

                         LOG.debug("Unable to check " + boClass + " for EBO properties.", ex);

                 }

                 return eboFieldValues;

         }

         /**

          * Return the EBO fieldValue entries explicitly for the given eboPropertyName. (I.e., any properties with the given property name as a prefix.

          */

         protected Map<String, String> getExternalizableBusinessObjectFieldValues(String eboPropertyName, Map<String, String> fieldValues) {

                 Map<String, String> eboFieldValues = new HashMap<String, String>();

                 for (String key : fieldValues.keySet()) {

                         if (key.startsWith(eboPropertyName + ".")) {

                                 eboFieldValues.put(StringUtils.substringAfterLast(key, "."), fieldValues.get(key));

                         }

                 }

                 return eboFieldValues;

         }

         /**

          * Get the complete list of all properties referenced in the fieldValues that are ExternalizableBusinessObjects.

          * 

          * This is a list of the EBO object references themselves, not of the properties within them.

          */

         protected List<String> getExternalizableBusinessObjectProperties(Class<?> boClass, Map<String, String> fieldValues) {

                 Set<String> eboPropertyNames = new HashSet<String>();

                 try {

                         Object sampleBo = boClass.newInstance();

                         for (String key : fieldValues.keySet()) {

                                 if (isExternalBusinessObjectProperty(sampleBo, key)) {

                                         eboPropertyNames.add(StringUtils.substringBeforeLast(key, "."));

                                 }

                         }

                 } catch (Exception ex) {

                         LOG.debug("Unable to check " + boClass + " for EBO properties.", ex);

                 }

                 return new ArrayList<String>(eboPropertyNames);

         }

         /**

          * Given an property on the main BO class, return the defined type of the ExternalizableBusinessObject. This will be used by other code to determine the correct module service to call for the

          * lookup.

          * 

          * @param boClass

          * @param propertyName

          * @return

          */

         protected Class<? extends ExternalizableBusinessObject> getExternalizableBusinessObjectClass(Class<?> boClass, String propertyName) {

                 try {

                         return PropertyUtils.getPropertyType(boClass.newInstance(), StringUtils.substringBeforeLast(propertyName, "."));

                 } catch (Exception e) {

                         LOG.debug("Unable to determine type of property for " + boClass.getName() + "/" + propertyName, e);

                 }

                 return null;

         }

         /**

          * Returns the maintenance document type associated with the business object class or null if one does not exist.

          * 

          * @return String representing the maintenance document type name

          */

         protected String getMaintenanceDocumentTypeName() {

                 MaintenanceDocumentDictionaryService dd = getMaintenanceDocumentDictionaryService();

                 String maintDocTypeName = dd.getDocumentTypeName(getDataObjectClass());

                 return maintDocTypeName;

         }

         /**

          * Determines if underlying lookup bo has associated maintenance document that allows new or copy maintenance actions.

          * 

          * @return true if bo has maint doc that allows new or copy actions

          */

         protected boolean allowsMaintenanceNewOrCopyAction() {

                 boolean allowsNewOrCopy = false;

                 String maintDocTypeName = getMaintenanceDocumentTypeName();

                 if (StringUtils.isNotBlank(maintDocTypeName)) {

                         allowsNewOrCopy = getBusinessObjectAuthorizationService().canCreate(getDataObjectClass(), GlobalVariables.getUserSession().getPerson(), maintDocTypeName);

                 }

                 return allowsNewOrCopy;

         }

         protected boolean allowsMaintenanceEditAction(Object dataObject) {

                 boolean allowsEdit = false;

                 String maintDocTypeName = getMaintenanceDocumentTypeName();

                 if (StringUtils.isNotBlank(maintDocTypeName)) {

                         allowsEdit = getBusinessObjectAuthorizationService().canMaintain(dataObject, GlobalVariables.getUserSession().getPerson(), maintDocTypeName);

                 }

                 return allowsEdit;

         }

         protected boolean allowsMaintenanceDeleteAction(Object dataObject) {

                 boolean allowsMaintain = false;

                 boolean allowsDelete = false;

                 String maintDocTypeName = getMaintenanceDocumentTypeName();

                 if (StringUtils.isNotBlank(maintDocTypeName)) {

                         allowsMaintain = getBusinessObjectAuthorizationService().canMaintain(dataObject, GlobalVariables.getUserSession().getPerson(), maintDocTypeName);

                 }

                 allowsDelete = KNSServiceLocatorWeb.getMaintenanceDocumentDictionaryService().getAllowsRecordDeletion(getDataObjectClass());

                 return allowsDelete && allowsMaintain;

         }

         /**

          * @see org.kuali.rice.kns.uif.service.LookupViewHelperService#getCreateNewUrl(org.kuali.rice.kns.uif.field.GeneratedField)

          */

         public String getCreateNewUrl(GeneratedField generatedField) {

                 String url = "";

                 if (allowsMaintenanceNewOrCopyAction()) {

                         Properties props = new Properties();

                         // TODO delyea - DOCUMENT THE FOLLOWING CHANGES (next 5 lines)

                         // props.put(KNSConstants.DISPATCH_REQUEST_PARAMETER, KNSConstants.MAINTENANCE_NEW_METHOD_TO_CALL);

                         // props.put(KNSConstants.BUSINESS_OBJECT_CLASS_ATTRIBUTE, getDataObjectClass().getName());

                         props.put(KNSConstants.DISPATCH_REQUEST_PARAMETER, MaintenanceDocumentController.METHOD_TO_CALL_NEW);

                         props.put(UifParameters.DATA_OBJECT_CLASS_NAME, getDataObjectClass().getName());

                         props.put(UifParameters.VIEW_TYPE_NAME, UifConstants.ViewType.MAINTENANCE);

                         // TODO delyea - DOCUMENT THE FOLLOWING CHANGES (next 2 lines)

                         // url = UrlFactory.parameterizeUrl(KNSConstants.MAINTENANCE_ACTION, props);

                         url = UrlFactory.parameterizeUrl(MaintenanceDocumentController.REQUEST_MAPPING_MAINTENANCE, props);

                         url = "<a id=\"" + generatedField.getId() + "\" href=\"" + url + "\"><img src=\"images/tinybutton-createnew.gif\" alt=\"create new\" width=\"70\" height=\"15\"/></a>";

                 }

                 return url;

         }

         /**

          * @see org.kuali.rice.kns.uif.service.LookupViewHelperService#getActionUrlsFromField(org.kuali.rice.kns.uif.field.GeneratedField)

          */

         public String getActionUrlsFromField(GeneratedField generatedField) {

                 Object bo = getLineObjectFromField(generatedField);

                 if (bo == null) {

                         return ACTION_URLS_EMPTY;

                 }

                 String actionUrls = getActionUrls(bo, getDataObjectMetaDataService().listPrimaryKeyFieldNames(getDataObjectClass()), getBusinessObjectAuthorizationService().getLookupResultRestrictions(

                         bo, GlobalVariables.getUserSession().getPerson()));

                 return (StringUtils.isNotBlank(actionUrls)) ? actionUrls : ACTION_URLS_EMPTY;

         }

         protected Object getLineObjectFromField(GeneratedField generatedField) {

                 Object bo = generatedField.getContext().get(UifConstants.ContextVariableNames.LINE);

                 if (bo == null) {

                         LOG.error("***************************************************************");

                         LOG.error("**** THERE IS NO BO TO PROCESS - THIS SHOULD NEVER HAPPEN *****");

                         LOG.error("***************************************************************");

                         return null;

                 }

                 return bo;

         }

         /**

          * This method is called by performLookup method to generate action urls. It calls the method getCustomActionUrls to get html data, calls getMaintenanceUrl to get the actual html tag, and returns

          * a formatted/concatenated string of action urls.

          * 

          * @see org.kuali.rice.kns.lookup.LookupableHelperService#getActionUrls(org.kuali.rice.kns.bo.BusinessObject)

          */

         protected String getActionUrls(Object dataObject, List<String> pkNames, BusinessObjectRestrictions dataObjectRestrictions) {

                 StringBuffer actions = new StringBuffer();

                 List<HtmlData> htmlDataList = getCustomActionUrls(dataObject, pkNames);

                 for (HtmlData htmlData : htmlDataList) {

                         actions.append(getMaintenanceUrl(dataObject, htmlData, pkNames, dataObjectRestrictions));

                         if (htmlData.getChildUrlDataList() != null) {

                                 if (htmlData.getChildUrlDataList().size() > 0) {

                                         actions.append(ACTION_URLS_CHILDREN_STARTER);

                                         for (HtmlData childURLData : htmlData.getChildUrlDataList()) {

                                                 actions.append(getMaintenanceUrl(dataObject, childURLData, pkNames, dataObjectRestrictions));

                                                 actions.append(ACTION_URLS_CHILDREN_SEPARATOR);

                                         }

                                         if (actions.toString().endsWith(ACTION_URLS_CHILDREN_SEPARATOR))

                                                 actions.delete(actions.length() - ACTION_URLS_CHILDREN_SEPARATOR.length(), actions.length());

                                         actions.append(ACTION_URLS_CHILDREN_END);

                                 }

                         }

                         actions.append(ACTION_URLS_SEPARATOR);

                 }

                 if (actions.toString().endsWith(ACTION_URLS_SEPARATOR))

                         actions.delete(actions.length() - ACTION_URLS_SEPARATOR.length(), actions.length());

                 return actions.toString();

         }

         /**

          * Child classes should override this method if they want to return some other action urls.

          * 

          * @returns This default implementation returns links to edit and copy maintenance action for the current maintenance record if the business object class has an associated maintenance document.

          *          Also checks value of allowsNewOrCopy in maintenance document xml before rendering the copy link.

          */

         protected List<HtmlData> getCustomActionUrls(Object dataObject, List<String> pkNames) {

                 List<HtmlData> htmlDataList = new ArrayList<HtmlData>();

                 // TODO delyea - DOCUMENT THE FOLLOWING CHANGES FROM KNSConstants to UifConstants

                 // TODO delyea - sgibson just hacked in the link text, probably should come

                 //               from somewhere

                 if (allowsMaintenanceEditAction(dataObject)) {

                         // htmlDataList.add(getUrlData(dataObject, KNSConstants.MAINTENANCE_EDIT_METHOD_TO_CALL, pkNames));

                         htmlDataList.add(getUrlData(dataObject, MaintenanceDocumentController.METHOD_TO_CALL_EDIT, "edit", pkNames));

                 }

                 if (allowsMaintenanceNewOrCopyAction()) {

                         // htmlDataList.add(getUrlData(dataObject, KNSConstants.MAINTENANCE_COPY_METHOD_TO_CALL, pkNames));

                         htmlDataList.add(getUrlData(dataObject, MaintenanceDocumentController.METHOD_TO_CALL_COPY, "copy", pkNames));

                 }

                 if (allowsMaintenanceDeleteAction(dataObject)) {

                         // htmlDataList.add(getUrlData(dataObject, KNSConstants.MAINTENANCE_DELETE_METHOD_TO_CALL, pkNames));

                         htmlDataList.add(getUrlData(dataObject, MaintenanceDocumentController.METHOD_TO_CALL_DELETE, "delete", pkNames));

                 }

                 return htmlDataList;

         }

         /**

          * 

          * This method calls its overloaded method with displayText as methodToCall

          * 

          * @param dataObject

          * @param methodToCall

          * @param pkNames

          * @return

          */

         protected AnchorHtmlData getUrlData(Object dataObject, String methodToCall, List<String> pkNames) {

                 return getUrlData(dataObject, methodToCall, methodToCall, pkNames);

         }

         /**

          * This method constructs an AnchorHtmlData. This method can be overriden by child classes if they want to construct the html data in a different way. Foe example, if they want different type of

          * html tag, like input/image.

          * 

          * @param dataObject

          * @param methodToCall

          * @param displayText

          * @param pkNames

          * @return

          */

         protected AnchorHtmlData getUrlData(Object dataObject, String methodToCall, String displayText, List<String> pkNames) {

                 String href = getActionUrlHref(dataObject, methodToCall, pkNames);

                 // String title = StringUtils.isBlank(href)?"":getActionUrlTitleText(dataObject, displayText, pkNames);

                 AnchorHtmlData anchorHtmlData = new AnchorHtmlData(href, methodToCall, displayText);

                 return anchorHtmlData;

         }

         /**

          * 

          * This method generates and returns href for the given parameters. This method can be overridden by child classes if they have to generate href differently. For example, refer to

          * IntendedIncumbentLookupableHelperServiceImpl

          * 

          * @param dataObject

          * @param methodToCall

          * @param pkNames

          * @return

          */

         protected String getActionUrlHref(Object dataObject, String methodToCall, List<String> pkNames) {

                 Properties props = new Properties();

                 props.put(KNSConstants.DISPATCH_REQUEST_PARAMETER, methodToCall);

                 props.putAll(getParametersFromPrimaryKey(dataObject, pkNames));

                 if (StringUtils.isNotBlank(getReturnLocation())) {

                         props.put(KNSConstants.RETURN_LOCATION_PARAMETER, getReturnLocation());

                 }

                 // TODO delyea - DOCUMENT THE FOLLOWING CHANGES (next 3 lines)

                 // props.put(KNSConstants.BUSINESS_OBJECT_CLASS_ATTRIBUTE, dataObject.getClass().getName());

                 props.put(UifParameters.DATA_OBJECT_CLASS_NAME, dataObject.getClass().getName());

                 props.put(UifParameters.VIEW_TYPE_NAME, UifConstants.ViewType.MAINTENANCE);

                 // TODO delyea - DOCUMENT THE FOLLOWING CHANGES (next 2 lines)

                 // return UrlFactory.parameterizeUrl(KNSConstants.MAINTENANCE_ACTION, props);

                 return UrlFactory.parameterizeUrl(MaintenanceDocumentController.REQUEST_MAPPING_MAINTENANCE, props);

         }

         protected Properties getParametersFromPrimaryKey(Object dataObject, List<String> pkNames) {

                 Properties props = new Properties();

                 for (Iterator<String> iter = pkNames.iterator(); iter.hasNext();) {

                         String fieldNm = iter.next();

                         Object fieldVal = ObjectUtils.getPropertyValue(dataObject, fieldNm);

                         if (fieldVal == null) {

                                 fieldVal = KNSConstants.EMPTY_STRING;

                         }

                         if (fieldVal instanceof java.sql.Date) {

                                 String formattedString = "";

                                 if (Formatter.findFormatter(fieldVal.getClass()) != null) {

                                         Formatter formatter = Formatter.getFormatter(fieldVal.getClass());

                                         formattedString = (String) formatter.format(fieldVal);

                                         fieldVal = formattedString;

                                 }

                         }

                         // Encrypt value if it is a secure field

                         if (getBusinessObjectAuthorizationService().attributeValueNeedsToBeEncryptedOnFormsAndLinks(dataObject.getClass(), fieldNm)) {

                                 try {

                                         fieldVal = getEncryptionService().encrypt(fieldVal) + EncryptionService.ENCRYPTION_POST_PREFIX;

                                 } catch (GeneralSecurityException e) {

                                         LOG.error("Exception while trying to encrypted value for inquiry framework.", e);

                                         throw new RuntimeException(e);

                                 }

                         }

                         props.put(fieldNm, fieldVal.toString());

                 }

                 return props;

         }

         /**

          * Build a maintenance url.

          * 

          * @param bo

          *            - business object representing the record for maint.

          * @param methodToCall

          *            - maintenance action

          * @return

          */

         protected String getMaintenanceUrl(Object dataObject, HtmlData htmlData, List<String> pkNames, BusinessObjectRestrictions dataObjectRestrictions) {

                 htmlData.setTitle(getActionUrlTitleText(dataObject, htmlData.getDisplayText(), pkNames, dataObjectRestrictions));

                 return htmlData.constructCompleteHtmlTag();

         }

         /**

          * 

          * This method generates and returns title text for action urls. Child classes can override this if they want to generate the title text differently. For example, refer to

          * BatchJobStatusLookupableHelperServiceImpl

          * 

          * @param dataObject

          * @param displayText

          * @param pkNames

          * @return

          */

         protected String getActionUrlTitleText(Object dataObject, String displayText, List<String> pkNames, BusinessObjectRestrictions dataObjectRestrictions) {

                 String prependTitleText = displayText + " " + getDataDictionaryService().getDataDictionary().getDataObjectEntry(getDataObjectClass().getName()).getObjectLabel() + " "

                         + KNSServiceLocator.getKualiConfigurationService().getPropertyString(TITLE_ACTION_URL_PREPENDTEXT_PROPERTY);

                 return HtmlData.getTitleText(prependTitleText, dataObject, pkNames, dataObjectRestrictions);

         }

 //        final protected HtmlData getReturnUrl(Object dataObject, Map<String,String> fieldConversions, String lookupImpl, List returnKeys, BusinessObjectRestrictions businessObjectRestrictions) {

 //                String href = getReturnHrefUsingObject(dataObject, fieldConversions, lookupImpl, returnKeys);

 //                String returnUrlAnchorLabel = KNSServiceLocator.getKualiConfigurationService().getPropertyString(TITLE_RETURN_URL_PREPENDTEXT_PROPERTY);

 //                AnchorHtmlData anchor = new AnchorHtmlData(href, HtmlData.getTitleText(returnUrlAnchorLabel, dataObject, returnKeys, businessObjectRestrictions));

 //                anchor.setDisplayText(returnUrlAnchorLabel);

 //                return anchor;

 //        }

 //        final protected String getReturnHrefUsingObject(Object dataObject, Map<String,String> fieldConversions, String lookupImpl, List returnKeys) {

 //                if (StringUtils.isNotBlank(getReturnLocation())) {

 //                        return UrlFactory.parameterizeUrl(getReturnLocation(), getReturnUrlParameters(dataObject, fieldConversions, lookupImpl, returnKeys));

 //                }

 //                return "";

 //        }

         /**

          * Returns the HTML code for a URL that will return the individual row

          * 

          * @see org.kuali.rice.kns.uif.service.LookupViewHelperService#getReturnUrlForResults(org.kuali.rice.kns.uif.field.GeneratedField)

          * 

          * @param generatedField

          * @return

          */

         public String getReturnUrlForResults(GeneratedField generatedField) {

                 Object dataObject = getLineObjectFromField(generatedField);

                 // return a non-breaking space if the object is null or if the row is not returnable 

                 if ( (dataObject == null) || (!isResultReturnable(dataObject)) ) {

                         return ACTION_URLS_EMPTY;

                 }

                 HtmlData temp = getReturnUrl(dataObject, generatedField.getContext(), getReturnKeys(), getBusinessObjectAuthorizationService().getLookupResultRestrictions(dataObject,

                         GlobalVariables.getUserSession().getPerson()));

                 String url = temp.constructCompleteHtmlTag(); 

                 return (StringUtils.isNotBlank(url)) ? url : ACTION_URLS_EMPTY;

         }

         protected HtmlData getReturnUrl(Object dataObject, Map<String, Object> context, List<String> returnKeys, BusinessObjectRestrictions businessObjectRestrictions) {

                 View lookupView = (View) context.get(UifConstants.ContextVariableNames.VIEW);

                 Properties props = getReturnUrlParameters(dataObject, getFieldConversions(), lookupView.getViewHelperServiceClassName().getName(), returnKeys);

                 // TODO delyea - Multiple value returns are not yet implemented

                 // if(StringUtils.isEmpty(lookupForm.getHtmlDataType()) || HtmlData.ANCHOR_HTML_DATA_TYPE.equals(lookupForm.getHtmlDataType())) {

                 return getReturnAnchorHtmlData(dataObject, props, context, returnKeys, businessObjectRestrictions, lookupView.getReturnTarget());

                 // } else {

                 // return getReturnInputHtmlData(businessObject, props, context, returnKeys, businessObjectRestrictions);

                 // }

         }

         /**

          * TODO delyea - Multiple value returns are not yet implemented

          * @deprecated - Multiple value returns are not yet implemented in KRAD

          */

         protected HtmlData getReturnInputHtmlData(Object dataObject, Properties props, Map<String, Object> context, List<String> returnKeys, BusinessObjectRestrictions businessObjectRestrictions) {

                 // String returnUrlAnchorLabel = KNSServiceLocator.getKualiConfigurationService().getPropertyString(TITLE_RETURN_URL_PREPENDTEXT_PROPERTY);

                 // String name = KNSConstants.MULTIPLE_VALUE_LOOKUP_SELECTED_OBJ_ID_PARAM_PREFIX+lookupForm.getLookupObjectId();

                 // InputHtmlData input = new InputHtmlData(name, InputHtmlData.CHECKBOX_INPUT_TYPE);

                 // input.setTitle(HtmlData.getTitleText(returnUrlAnchorLabel, dataObject, returnKeys, businessObjectRestrictions));

                 // if(((MultipleValueLookupForm)lookupForm).getCompositeObjectIdMap()==null ||

                 // ((MultipleValueLookupForm)lookupForm).getCompositeObjectIdMap().get(

                 // ((PersistableBusinessObject)businessObject).getObjectId())==null){

                 // input.setChecked("");

                 // } else{

                 // input.setChecked(InputHtmlData.CHECKBOX_CHECKED_VALUE);

                 // }

                 // input.setValue(InputHtmlData.CHECKBOX_CHECKED_VALUE);

                 // return input;

                 return null;

         }

         protected HtmlData getReturnAnchorHtmlData(Object dataObject, Properties props, Map<String, Object> context, List<String> returnKeys, BusinessObjectRestrictions businessObjectRestrictions, String returnTarget) {

                 String returnUrlAnchorLabel = KNSServiceLocator.getKualiConfigurationService().getPropertyString(TITLE_RETURN_URL_PREPENDTEXT_PROPERTY);

                 AnchorHtmlData anchor = new AnchorHtmlData(getReturnHrefUsingParameters(props, context, returnKeys), HtmlData.getTitleText(returnUrlAnchorLabel, dataObject, returnKeys,

                         businessObjectRestrictions));

                 anchor.setDisplayText(returnUrlAnchorLabel);

                 if (returnTarget != null) {

                         anchor.setTarget(returnTarget);

                         if (!returnTarget.equals("_self")

                                         && !returnTarget.equals("_parent")) {

                                 // Build up script to set the value(s) on the form and close

                                 // the fancybox. In order to trigger validation : get focus and then loose(blur()) focus.

                                 // Prevent default onclick for the anchor.

                                 StringBuilder script = new StringBuilder();

                                 for (Object key : getFieldConversions().keySet()) {

                                         if (props.containsKey(getFieldConversions().get(key))) {

                                                 Object fieldName = getFieldConversions().get(key)

                                                                 .replace("'", "\\'");

                                                 Object value = props

                                                                 .get(getFieldConversions().get(key));

                                                 script = script

                                                                 .append("var returnField = parent.$('#iframeportlet').contents().find("

                                                                                 + "'[name=""

                                                                                 + fieldName

                                                                                 + ""]');"

                                                                                 + "returnField.val('"

                                                                                 + value

                                                                                 + "');"

                                                                                 + "returnField.focus();returnField.blur();returnField.focus();");

                                         }

                                 }

                                 anchor.setOnclick(script.append("parent.$.fancybox.close();return false").toString());

                         }

                 }

                 return anchor;

         }

         protected String getReturnHrefUsingParameters(Properties props, Map<String, Object> context, List returnKeys) {

                 if (StringUtils.isNotBlank(getReturnLocation())) {

                         String href = UrlFactory.parameterizeUrl(getReturnLocation(), props);

                         return addToReturnHref(href, context);

                 }

                 return "";

         }

         protected String addToReturnHref(String href, Map<String, Object> context) {

                 StringBuffer buffer = new StringBuffer(href);

                  // TODO delyea - Figure out how to impelement Anchors in new UIF

 //                String lookupAnchor = "";

 //                if (StringUtils.isNotEmpty(anchor)) {

 //                        lookupAnchor = anchor;

 //                }

 //                buffer.append("&anchor=" + lookupAnchor + "&docNum=" + (StringUtils.isEmpty(getDocNum()) ? "" : getDocNum()));

                 buffer.append("&" + UifParameters.DOC_NUM + "=" + (StringUtils.isEmpty(getDocNum()) ? "" : getDocNum()));

                 return buffer.toString();

         }

         protected Properties getReturnUrlParameters(Object dataObject, Map<String,String> fieldConversionValues, String lookupImpl, List<String> returnKeys) {

                 Properties props = new Properties();

                 props.put(KNSConstants.DISPATCH_REQUEST_PARAMETER, KNSConstants.RETURN_METHOD_TO_CALL);

                 if (getReturnFormKey() != null) {

                         props.put(UifParameters.FORM_KEY, getReturnFormKey());

                 }

                 if (lookupImpl != null) {

                         props.put(KNSConstants.REFRESH_CALLER, lookupImpl);

                 }

                 if (getDocNum() != null) {

                         props.put(UifParameters.DOC_NUM, getDocNum());

                 }

                 if (getReferencesToRefresh() != null) {

                         props.put(KNSConstants.REFERENCES_TO_REFRESH, getReferencesToRefresh());

                 }

                 Iterator<String> returnKeysIt = returnKeys.iterator();

                 while (returnKeysIt.hasNext()) {

                         String fieldNm = returnKeysIt.next();

                         Object fieldVal = ObjectUtils.getPropertyValue(dataObject, fieldNm);

                         if (fieldVal == null) {

                                 fieldVal = StringUtils.EMPTY;

                         }

                         if (getBusinessObjectAuthorizationService().attributeValueNeedsToBeEncryptedOnFormsAndLinks(getDataObjectClass(), fieldNm)) {

                                 try {

                                         fieldVal = getEncryptionService().encrypt(fieldVal) + EncryptionService.ENCRYPTION_POST_PREFIX;

                                 } catch (GeneralSecurityException e) {

                                         LOG.error("Exception while trying to encrypted value for inquiry framework.", e);

                                         throw new RuntimeException(e);

                                 }

                         }

                         // need to format date in url

                         if (fieldVal instanceof Date) {

                                 DateFormatter dateFormatter = new DateFormatter();

                                 fieldVal = dateFormatter.format(fieldVal);

                         }

                         if (fieldConversionValues.containsKey(fieldNm)) {

                                 fieldNm = fieldConversionValues.get(fieldNm);

                         }

                         props.put(fieldNm, fieldVal.toString());

                 }

                 return props;

         }

         /**

          * @return a List of the names of fields which are marked in data dictionary as return fields.

          */

         protected List<String> getReturnKeys() {

                 List<String> returnKeys;

                 if (fieldConversions != null && !fieldConversions.isEmpty()) {

                         returnKeys = new ArrayList<String>(fieldConversions.keySet());

                 } else {

                         returnKeys = getDataObjectMetaDataService().listPrimaryKeyFieldNames(getDataObjectClass());

                 }

                 return returnKeys;

         }

     /**

      * Determines whether a given data object that's returned as one of the lookup's results is considered returnable, which means that for

      * single-value lookups, a "return value" link may be rendered, and for multiple value lookups, a checkbox is rendered.

      *

      * Note that this can be part of an authorization mechanism, but not the complete authorization mechanism.  The component that invoked the lookup/

      * lookup caller (e.g. document, nesting lookup, etc.) needs to check that the object that was passed to it was returnable as well because there

      * are ways around this method (e.g. crafting a custom return URL).

      *

      * @param dataObject an object from the search result set

      * @return true if the row is returnable and false if it is not

      */

         protected boolean isResultReturnable(Object dataObject) {

                 return true;

         }

         /**

          * @see org.kuali.rice.kns.uif.service.LookupViewHelperService#getConditionallyReadOnlyPropertyNames()

          */

         public Set<String> getConditionallyReadOnlyPropertyNames() {

                 return new HashSet<String>();

         }

         /**

          * @see org.kuali.rice.kns.uif.service.LookupViewHelperService#getConditionallyRequiredPropertyNames()

          */

         public Set<String> getConditionallyRequiredPropertyNames() {

                 return new HashSet<String>();

         }

         /**

          * @see org.kuali.rice.kns.uif.service.LookupViewHelperService#getConditionallyHiddenPropertyNames()

          */

         public Set<String> getConditionallyHiddenPropertyNames() {

                 return new HashSet<String>();

         }

         /**

      * @return the atLeastOneRowReturnable

      */

     public boolean isAtLeastOneRowReturnable() {

             return this.atLeastOneRowReturnable;

     }

     /**

      * @param atLeastOneRowReturnable the atLeastOneRowReturnable to set

      */

     public void setAtLeastOneRowReturnable(boolean atLeastOneRowReturnable) {

             this.atLeastOneRowReturnable = atLeastOneRowReturnable;

     }

         /**

      * @return the atLeastOneRowHasActions

      */

     public boolean isAtLeastOneRowHasActions() {

             return this.atLeastOneRowHasActions;

     }

         /**

      * @param atLeastOneRowHasActions the atLeastOneRowHasActions to set

      */

     public void setAtLeastOneRowHasActions(boolean atLeastOneRowHasActions) {

             this.atLeastOneRowHasActions = atLeastOneRowHasActions;

     }

         /**

      * @return the suppressActions

      */

     public boolean isSuppressActions() {

             return this.suppressActions;

     }

         /**

      * @param suppressActions the suppressActions to set

      */

     public void setSuppressActions(boolean suppressActions) {

             this.suppressActions = suppressActions;

     }

     /**

      * Gets the showMaintenanceLinks attribute.

      * @return Returns the showMaintenanceLinks.

      */

     public boolean isShowMaintenanceLinks() {

         return showMaintenanceLinks;

     }

     /**

      * Sets the showMaintenanceLinks attribute value.

      * @param showMaintenanceLinks The showMaintenanceLinks to set.

      */

     public void setShowMaintenanceLinks(boolean showMaintenanceLinks) {

         this.showMaintenanceLinks = showMaintenanceLinks;

     }

         /**

          * @return the dataObjectClass

          */

         public Class<?> getDataObjectClass() {

                 return this.dataObjectClass;

         }

         /**

          * @param dataObjectClass

          *            the dataObjectClass to set

          */

         public void setDataObjectClass(Class<?> dataObjectClass) {

                 this.dataObjectClass = dataObjectClass;

         }

         /**

          * @return the returnLocation

          */

         public String getReturnLocation() {

                 return this.returnLocation;

         }

         /**

          * @param returnLocation

          *            the returnLocation to set

          */

         public void setReturnLocation(String returnLocation) {

                 this.returnLocation = returnLocation;

         }

         /**

      * @return the hideReturnLink

      */

     public boolean isHideReturnLink() {

             return this.hideReturnLink;

     }

         /**

      * @param hideReturnLink the hideReturnLink to set

      */

     public void setHideReturnLink(boolean hideReturnLink) {

             this.hideReturnLink = hideReturnLink;

     }

         /**

          * @return the docNum

          */

         public String getDocNum() {

                 return this.docNum;

         }

         /**

          * @param docNum

          *            the docNum to set

          */

         public void setDocNum(String docNum) {

                 this.docNum = docNum;

         }

         /**

          * @return the referencesToRefresh

          */

         public String getReferencesToRefresh() {

                 return this.referencesToRefresh;

         }

         /**

          * @param referencesToRefresh

          *            the referencesToRefresh to set

          */

         public void setReferencesToRefresh(String referencesToRefresh) {

                 this.referencesToRefresh = referencesToRefresh;

         }

         /**

          * @return the fieldConversions

          */