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}