001/* 002 * Copyright 2008 The Kuali Foundation 003 * 004 * Licensed under the Educational Community License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.opensource.org/licenses/ecl2.php 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 013 * See the License for the specific language governing permissions and 014 * limitations under the License. 015 */ 016package org.kuali.ole.module.purap.document.validation.impl; 017 018import org.apache.commons.lang.StringUtils; 019import org.kuali.ole.integration.cab.CapitalAssetBuilderModuleService; 020import org.kuali.ole.module.purap.PurapConstants; 021import org.kuali.ole.module.purap.PurapKeyConstants; 022import org.kuali.ole.module.purap.PurapPropertyConstants; 023import org.kuali.ole.module.purap.businessobject.PurApItem; 024import org.kuali.ole.module.purap.businessobject.PurchasingItemBase; 025import org.kuali.ole.module.purap.document.PurchasingDocument; 026import org.kuali.ole.sys.OLEKeyConstants; 027import org.kuali.ole.sys.document.validation.event.AttributedDocumentEvent; 028import org.kuali.ole.vnd.businessobject.CommodityCode; 029import org.kuali.rice.krad.service.BusinessObjectService; 030import org.kuali.rice.krad.util.GlobalVariables; 031 032import java.util.HashMap; 033import java.util.Map; 034 035public class PurchasingNewIndividualItemValidation extends PurchasingAccountsPayableNewIndividualItemValidation { 036 037 private BusinessObjectService businessObjectService; 038 private CapitalAssetBuilderModuleService capitalAssetBuilderModuleService; 039 private PurchasingUnitOfMeasureValidation unitOfMeasureValidation; 040 private PurchasingItemUnitPriceValidation itemUnitPriceValidation; 041 private PurchasingItemDescriptionValidation itemDescriptionValidation; 042 private PurchasingItemQuantityValidation itemQuantityValidation; 043 private PurchasingBelowTheLineItemNoUnitCostValidation belowTheLineItemNoUnitCostValidation; 044 045 public boolean validate(AttributedDocumentEvent event) { 046 boolean valid = true; 047 valid &= super.validate(event); 048 String recurringPaymentTypeCode = ((PurchasingDocument) event.getDocument()).getRecurringPaymentTypeCode(); 049 //Capital asset validations are only done on line items (not additional charge items). 050 if (!getItemForValidation().getItemType().isAdditionalChargeIndicator()) { 051 valid &= capitalAssetBuilderModuleService.validateItemCapitalAssetWithErrors(recurringPaymentTypeCode, getItemForValidation(), false); 052 } 053 unitOfMeasureValidation.setItemForValidation(getItemForValidation()); 054 valid &= unitOfMeasureValidation.validate(event); 055 056 if (getItemForValidation().getItemType().isLineItemIndicator()) { 057 itemUnitPriceValidation.setItemForValidation(getItemForValidation()); 058 valid &= itemUnitPriceValidation.validate(event); 059 060 itemDescriptionValidation.setItemForValidation(getItemForValidation()); 061 valid &= itemDescriptionValidation.validate(event); 062 063 itemQuantityValidation.setItemForValidation(getItemForValidation()); 064 valid &= itemQuantityValidation.validate(event); 065 066 valid &= validateCommodityCodes(getItemForValidation(), commodityCodeIsRequired()); 067 } else { 068 // No accounts can be entered on below-the-line items that have no unit cost. 069 belowTheLineItemNoUnitCostValidation.setItemForValidation(getItemForValidation()); 070 valid &= belowTheLineItemNoUnitCostValidation.validate(event); 071 } 072 return valid; 073 } 074 075 protected boolean commodityCodeIsRequired() { 076 return false; 077 } 078 079 /** 080 * Validates that the document contains at least one item. 081 * 082 * @param purDocument the purchasing document to be validated 083 * @return boolean false if the document does not contain at least one item. 084 */ 085 public boolean validateContainsAtLeastOneItem(PurchasingDocument purDocument) { 086 boolean valid = false; 087 for (PurApItem item : purDocument.getItems()) { 088 if (!((PurchasingItemBase) item).isEmpty() && item.getItemType().isLineItemIndicator()) { 089 090 return true; 091 } 092 } 093 String documentType = getDocumentTypeLabel(purDocument.getDocumentHeader().getWorkflowDocument().getDocumentTypeName()); 094 095 if (!valid) { 096 GlobalVariables.getMessageMap().putError(PurapConstants.ITEM_TAB_ERROR_PROPERTY, PurapKeyConstants.ERROR_ITEM_REQUIRED, documentType); 097 } 098 099 return valid; 100 } 101 102 /** 103 * Validates whether the commodity code existed on the item, and if existed, whether the 104 * commodity code on the item existed in the database, and if so, whether the commodity 105 * code is active. Display error if any of these 3 conditions are not met. 106 * 107 * @param item The PurApItem containing the commodity code to be validated. 108 * @return boolean false if the validation fails and true otherwise. 109 */ 110 protected boolean validateCommodityCodes(PurApItem item, boolean commodityCodeRequired) { 111 boolean valid = true; 112 String identifierString = item.getItemIdentifierString(); 113 PurchasingItemBase purItem = (PurchasingItemBase) item; 114 115 //This validation is only needed if the commodityCodeRequired system parameter is true 116 if (commodityCodeRequired && StringUtils.isBlank(purItem.getPurchasingCommodityCode())) { 117 //This is the case where the commodity code is required but the item does not currently contain the commodity code. 118 valid = false; 119 String attributeLabel = getDataDictionaryService().getDataDictionary().getBusinessObjectEntry(CommodityCode.class.getName()). 120 getAttributeDefinition(PurapPropertyConstants.ITEM_COMMODITY_CODE).getLabel(); 121 GlobalVariables.getMessageMap().putError(PurapPropertyConstants.ITEM_COMMODITY_CODE, OLEKeyConstants.ERROR_REQUIRED, attributeLabel + " in " + identifierString); 122 } else if (StringUtils.isNotBlank(purItem.getPurchasingCommodityCode())) { 123 //Find out whether the commodity code has existed in the database 124 Map<String, String> fieldValues = new HashMap<String, String>(); 125 fieldValues.put(PurapPropertyConstants.ITEM_COMMODITY_CODE, purItem.getPurchasingCommodityCode()); 126 if (businessObjectService.countMatching(CommodityCode.class, fieldValues) != 1) { 127 //This is the case where the commodity code on the item does not exist in the database. 128 valid = false; 129 GlobalVariables.getMessageMap().putError(PurapPropertyConstants.ITEM_COMMODITY_CODE, PurapKeyConstants.PUR_COMMODITY_CODE_INVALID, " in " + identifierString); 130 } else { 131 valid &= validateThatCommodityCodeIsActive(item); 132 } 133 } 134 135 return valid; 136 } 137 138 protected boolean validateThatCommodityCodeIsActive(PurApItem item) { 139 item.refreshReferenceObject(PurapPropertyConstants.COMMODITY_CODE); 140 if (!((PurchasingItemBase) item).getCommodityCode().isActive()) { 141 //This is the case where the commodity code on the item is not active. 142 GlobalVariables.getMessageMap().putError(PurapPropertyConstants.ITEM_COMMODITY_CODE, PurapKeyConstants.PUR_COMMODITY_CODE_INACTIVE, " in " + item.getItemIdentifierString()); 143 return false; 144 } 145 return true; 146 } 147 148 public BusinessObjectService getBusinessObjectService() { 149 return businessObjectService; 150 } 151 152 public void setBusinessObjectService(BusinessObjectService businessObjectService) { 153 this.businessObjectService = businessObjectService; 154 } 155 156 public CapitalAssetBuilderModuleService getCapitalAssetBuilderModuleService() { 157 return capitalAssetBuilderModuleService; 158 } 159 160 public void setCapitalAssetBuilderModuleService(CapitalAssetBuilderModuleService capitalAssetBuilderModuleService) { 161 this.capitalAssetBuilderModuleService = capitalAssetBuilderModuleService; 162 } 163 164 public PurchasingUnitOfMeasureValidation getUnitOfMeasureValidation() { 165 return unitOfMeasureValidation; 166 } 167 168 public void setUnitOfMeasureValidation(PurchasingUnitOfMeasureValidation unitOfMeasureValidation) { 169 this.unitOfMeasureValidation = unitOfMeasureValidation; 170 } 171 172 public PurchasingItemUnitPriceValidation getItemUnitPriceValidation() { 173 return itemUnitPriceValidation; 174 } 175 176 public void setItemUnitPriceValidation(PurchasingItemUnitPriceValidation itemUnitPriceValidation) { 177 this.itemUnitPriceValidation = itemUnitPriceValidation; 178 } 179 180 public PurchasingItemDescriptionValidation getItemDescriptionValidation() { 181 return itemDescriptionValidation; 182 } 183 184 public void setItemDescriptionValidation(PurchasingItemDescriptionValidation itemDescriptionValidation) { 185 this.itemDescriptionValidation = itemDescriptionValidation; 186 } 187 188 public PurchasingItemQuantityValidation getItemQuantityValidation() { 189 return itemQuantityValidation; 190 } 191 192 public void setItemQuantityValidation(PurchasingItemQuantityValidation itemQuantityValidation) { 193 this.itemQuantityValidation = itemQuantityValidation; 194 } 195 196 public PurchasingBelowTheLineItemNoUnitCostValidation getBelowTheLineItemNoUnitCostValidation() { 197 return belowTheLineItemNoUnitCostValidation; 198 } 199 200 public void setBelowTheLineItemNoUnitCostValidation(PurchasingBelowTheLineItemNoUnitCostValidation belowTheLineItemNoUnitCostValidation) { 201 this.belowTheLineItemNoUnitCostValidation = belowTheLineItemNoUnitCostValidation; 202 } 203 204 205}