############################################################################## # # Copyright (c) 2002, 2005 Nexedi SARL and Contributors. All Rights Reserved. # Jean-Paul Smets-Solanes <jp@nexedi.com> # Romain Courteaud <romain@nexedi.com> # # WARNING: This program as such is intended to be used by professional # programmers who take the whole responsability of assessing all potential # consequences resulting from its eventual inadequacies and bugs # End users who are looking for a ready-to-use solution with commercial # garantees and support are strongly adviced to contract a Free Software # Service Company # # This program is Free Software; you can redistribute it and/or # modify it under the terms of the GNU General Public License # as published by the Free Software Foundation; either version 2 # of the License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. # ############################################################################## from math import log from warnings import warn from AccessControl import ClassSecurityInfo from DateTime import DateTime from Products.ERP5Type import Permissions, PropertySheet, Constraint, Interface from Products.ERP5Type.XMLMatrix import XMLMatrix from Products.ERP5Type.Base import Base from Products.ERP5.Variated import Variated from Products.ERP5.Core.Resource import Resource as CoreResource from Products.CMFCore.WorkflowCore import WorkflowMethod from Products.CMFCategory.Renderer import Renderer from Products.CMFCore.utils import getToolByName from zLOG import LOG, WARNING class Resource(XMLMatrix, CoreResource, Variated): """ A Resource """ meta_type = 'ERP5 Resource' portal_type = 'Resource' add_permission = Permissions.AddPortalContent isPortalContent = 1 isRADContent = 1 # Declarative security security = ClassSecurityInfo() security.declareObjectProtected(Permissions.AccessContentsInformation) # Declarative interfaces __implements__ = ( Interface.Variated, ) # Declarative properties property_sheets = ( PropertySheet.Base , PropertySheet.XMLObject , PropertySheet.CategoryCore , PropertySheet.DublinCore , PropertySheet.Price , PropertySheet.Resource , PropertySheet.Reference , PropertySheet.FlowCapacity , PropertySheet.VariationRange , PropertySheet.DefaultSupply ) # Is it OK now ? # The same method is at about 3 different places # Some genericity is needed security.declareProtected(Permissions.AccessContentsInformation, 'getVariationRangeCategoryItemList') def getVariationRangeCategoryItemList(self, base_category_list=(), base=1, root=1, display_id='title', display_base_category=1, current_category=None, **kw): """ Returns possible variations resource.getVariationRangeCategoryItemList => [(display, value)] ## Variation API (exemple) ## Base categories defined: - colour - morphology - size Categories defined: - colour/blue - colour/red - size/Man - size/Woman Resource 'resource' created with variation_base_category_list: (colour, morphology, size) resource.getVariationRangeCategoryList variation | individual variation | result ____________________________________________________________________________________ | | (colour/blue, colour/red, size/Man, size/Woman) size/Man | | (colour/blue, colour/red, size/Man, size/Woman) colour/blue | | (colour/blue, colour/red, size/Man, size/Woman) | colour/1 | (colour/1, size/Man, size/Woman) | morphology/2 | (colour/blue, colour/red, size/Man, size/Woman, morphology/2) """ result = [] if base_category_list is (): base_category_list = self.getVariationBaseCategoryList() elif type(base_category_list) is type('a'): base_category_list = (base_category_list,) other_base_category_dict = dict([(i,1) for i in base_category_list]) other_variations = self.searchFolder( \ portal_type=self.getPortalVariationTypeList(), sort_on=[('title','ascending')]) other_variations = [x.getObject() for x in other_variations] other_variations = [x for x in other_variations if x is not None] for object in other_variations: for base_category in object.getVariationBaseCategoryList(): if (base_category_list is ()) or \ (base_category in base_category_list): other_base_category_dict[base_category] = 0 # XXX now, call Renderer a lot of time. # Better implementation needed result.extend(Renderer( base_category=base_category, display_base_category=display_base_category, display_none_category=0, base=base, current_category=current_category, display_id=display_id).\ render([object])) other_base_category_item_list = filter(lambda x: x[1]==1, other_base_category_dict.items()) other_base_category_list = map(lambda x: x[0], other_base_category_item_list) # Get category variation if len(other_base_category_list) != 0: result += Variated.getVariationRangeCategoryItemList( self, base_category_list=other_base_category_list, base=base, display_base_category=display_base_category, **kw) # Return result return result security.declareProtected(Permissions.AccessContentsInformation, 'getVariationCategoryItemList') def getVariationCategoryItemList(self, base_category_list=(), omit_individual_variation=1, base=1, current_category=None, display_base_category=1, display_id='title', **kw): """ Returns variations of the resource. If omit_individual_variation==1, does not return individual variation. Else, returns them. Display is on left. => [(display, value)] *old parameters: base=1, current_category=None, display_id='getTitle' (default value getTitleOrId) """ result = Variated.getVariationCategoryItemList(self, base_category_list=base_category_list, display_base_category=display_base_category, base=base, **kw) if not omit_individual_variation: other_variations = self.searchFolder( portal_type=self.getPortalVariationTypeList()) other_variations = map(lambda x: x.getObject(), other_variations) other_variations = filter(lambda x: x is not None, other_variations) for object in other_variations: for base_category in object.getVariationBaseCategoryList(): if (base_category_list is ()) or \ (base_category in base_category_list): # XXX append object, relative_url ? # XXX now, call Renderer a lot of time. # Better implementation needed result.extend(Renderer( base_category=base_category, display_base_category=display_base_category, display_none_category=0, base=base, current_category=current_category, display_id=display_id, **kw).\ render([object])) return result security.declareProtected(Permissions.AccessContentsInformation, 'getVariationCategoryList') def getVariationCategoryList(self, default=[], base_category_list=(), omit_individual_variation=1, **kw): """ Returns variations of the resource. If omit_individual_variation==1, does not return individual variation. Else, returns them. ## Variation API (exemple) ## Base categories defined: - colour - morphology - size Categories defined: - colour/blue - colour/red - size/Man - size/Woman Resource 'resource' created with variation_base_category_list: (colour, morphology, size) resource.getVariationCategoryList variation | individual variation | result _____________________________________________________ | | () size/Man | | (size/Man, ) colour/blue | | (colour/blue, ) | colour/1 | (colour/1, ) | morphology/2 | (morphology/2, ) """ vcil = self.getVariationCategoryItemList( base_category_list=base_category_list, omit_individual_variation=omit_individual_variation,**kw) return map(lambda x: x[1], vcil) # Unit conversion security.declareProtected(Permissions.AccessContentsInformation, 'convertQuantity') def convertQuantity(self, quantity, from_unit, to_unit): return quantity # This patch is temporary and allows to circumvent name conflict in ZSQLCatalog process for Coramy security.declareProtected(Permissions.AccessContentsInformation, 'getDefaultDestinationAmountBis') def getDefaultDestinationAmountBis(self, unit=None, variation=None, REQUEST=None): try: return self.getDestinationReference() except AttributeError: return None # This patch is temporary and allows to circumvent name conflict in ZSQLCatalog process for Coramy security.declareProtected(Permissions.AccessContentsInformation, 'getDefaultSourceAmountBis') def getDefaultSourceAmountBis(self, unit=None, variation=None, REQUEST=None): try: return self.getSourceReference() except AttributeError: return None # This patch allows variations to find a resource security.declareProtected(Permissions.AccessContentsInformation, 'getDefaultResourceValue') def getDefaultResourceValue(self): return self #################################################### # Stock Management #################################################### security.declareProtected(Permissions.AccessContentsInformation, 'getInventory') def getInventory(self, **kw): """ Returns inventory """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getInventory(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getCurrentInventory') def getCurrentInventory(self, **kw): """ Returns current inventory """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getCurrentInventory(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getAvailableInventory') def getAvailableInventory(self, **kw): """ Returns available inventory (current inventory - deliverable) """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getAvailableInventory(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getFutureInventory') def getFutureInventory(self, **kw): """ Returns inventory at infinite """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getFutureInventory(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getInventoryList') def getInventoryList(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getInventoryList(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getCurrentInventoryList') def getCurrentInventoryList(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getCurrentInventoryList(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getAvailableInventoryList') def getAvailableInventoryList(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getAvailableInventoryList(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getFutureInventoryList') def getFutureInventoryList(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getFutureInventoryList(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getInventoryStat') def getInventoryStat(self, **kw): """ Returns statistics of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getInventoryStat(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getCurrentInventoryStat') def getCurrentInventoryStat(self, **kw): """ Returns statistics of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getCurrentInventoryStat(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getAvailableInventoryStat') def getAvailableInventoryStat(self, **kw): """ Returns statistics of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getAvailableInventoryStat(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getFutureInventoryStat') def getFutureInventoryStat(self, **kw): """ Returns statistics of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getFutureInventoryStat(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getInventoryChart') def getInventoryChart(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getInventoryChart(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getCurrentInventoryChart') def getCurrentInventoryChart(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getCurrentInventoryChart(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getFutureInventoryChart') def getFutureInventoryChart(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getFutureInventoryChart(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getInventoryHistoryList') def getInventoryHistoryList(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getInventoryHistoryList(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getInventoryHistoryChart') def getInventoryHistoryChart(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getInventoryHistoryChart(**kw) # XXX FIXME # Method getCurrentMovementHistoryList, # getAvailableMovementHistoryList, getFutureMovementHistoryList # can be added security.declareProtected(Permissions.AccessContentsInformation, 'getMovementHistoryList') def getMovementHistoryList(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getMovementHistoryList(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getMovementHistoryStat') def getMovementHistoryStat(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getMovementHistoryStat(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getNextNegativeInventoryDate') def getNextNegativeInventoryDate(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getNextNegativeInventoryDate(**kw) # Asset Price API security.declareProtected(Permissions.AccessContentsInformation, 'getInventoryAssetPrice') def getInventoryAssetPrice(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getInventoryAssetPrice(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getCurrentInventoryAssetPrice') def getCurrentInventoryAssetPrice(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getCurrentInventoryAssetPrice(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getAvailableInventoryAssetPrice') def getAvailableInventoryAssetPrice(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getAvailableInventoryAssetPrice(**kw) security.declareProtected(Permissions.AccessContentsInformation, 'getFutureInventoryAssetPrice') def getFutureInventoryAssetPrice(self, **kw): """ Returns list of inventory grouped by section or site """ kw['resource_uid'] = self.getUid() portal_simulation = getToolByName(self, 'portal_simulation') return portal_simulation.getFutureInventoryAssetPrice(**kw) # Industrial price API security.declareProtected(Permissions.AccessContentsInformation, 'getIndustrialPrice') def getIndustrialPrice(self, context=None, REQUEST=None, **kw): """ Returns industrial price """ context = self.asContext(context=context, REQUEST=REQUEST, **kw) result = self._getIndustrialPrice(context) return result def _getIndustrialPrice(self, context): # Default value is None return None # Predicate handling security.declareProtected(Permissions.AccessContentsInformation, 'asPredicate') def asPredicate(self): """ Returns a temporary Predicate based on the Resource properties """ from Products.ERP5 import newTempPredicateGroup as newTempPredicate p = newTempPredicate(self.getId(), uid = self.getUid()) p.setMembershipCriterionBaseCategoryList(('resource',)) p.setMembershipCriterionCategoryList(('resource/%s' % self.getRelativeUrl(),)) return p def _pricingSortMethod(self, a, b): # Simple method : the one that defines a destination wins parent = a.getParentValue() if parent.getPortalType().endswith(' Line'): parent = parent.getParentValue() if parent.getDestination(): return -1 # a has a destination and wins return 1 # a has no destination ans loses security.declareProtected(Permissions.AccessContentsInformation, '_getPriceParameterDict') def _getPriceParameterDict(self, context=None, REQUEST=None, **kw): """ Get all pricing parameters from Predicate. """ # Search all categories context new_category_list = [] if context is not None: new_category_list += context.getCategoryList() #XXX This should be 'category_list' instead of 'categories' to respect # the naming convention. Must take care of side effects when fixing if kw.has_key('categories'): new_category_list.extend(kw['categories']) del kw['categories'] resource_category = 'resource/' + self.getRelativeUrl() if not resource_category in new_category_list: new_category_list += (resource_category, ) # Generate the predicate mapped value # to get some price values. domain_tool = getToolByName(self,'portal_domains') portal_type_list = self.getPortalSupplyPathTypeList() # Generate the fake context tmp_context = self.asContext(context=context, categories=new_category_list, REQUEST=REQUEST, **kw) tmp_kw = kw.copy() if 'sort_method' not in tmp_kw: tmp_kw['sort_method'] = self._pricingSortMethod mapped_value = domain_tool.generateMultivaluedMappedValue( tmp_context, portal_type=portal_type_list, has_cell_content=0, **tmp_kw) # Get price parameters price_parameter_dict = { 'base_price': None, 'additional_price': [], 'surcharge_ratio': [], 'discount_ratio': [], 'exclusive_discount_ratio': None, 'variable_additional_price': [], 'non_discountable_additional_price': [], } if mapped_value is None: return price_parameter_dict for price_parameter_name in price_parameter_dict.keys(): price_parameter_value = \ mapped_value.getProperty(price_parameter_name) if price_parameter_value not in [None, '']: try: price_parameter_dict[price_parameter_name].extend( price_parameter_value) except AttributeError: if price_parameter_dict[price_parameter_name] is None: if price_parameter_name == 'exclusive_discount_ratio': price_parameter_dict[price_parameter_name] = \ max(price_parameter_value) else: price_parameter_dict[price_parameter_name] = \ price_parameter_value[0] return price_parameter_dict security.declareProtected(Permissions.AccessContentsInformation, '_getPricingVariable') def _getPricingVariable(self, context=None): """ Return the value of the property used to calculate variable pricing This basically calls a script like Product_getPricingVariable """ method = None if context is not None: method = context._getTypeBasedMethod('getPricingVariable') if method is None or context is None: method = self._getTypeBasedMethod('getPricingVariable') if method is None: return 0.0 return float(method()) security.declareProtected(Permissions.AccessContentsInformation, 'getPrice') def getPrice(self, default=None, context=None, REQUEST=None, **kw): """ Return the unit price of a resource in a specific context. """ # see Movement.getPrice if isinstance(default, Base) and context is None: msg = 'getPrice first argument is supposed to be the default value'\ ' accessor, the context should be passed as with the context='\ ' keyword argument' warn(msg, DeprecationWarning) LOG('ERP5', WARNING, msg) context = default default = None price_parameter_dict = self._getPriceParameterDict( context=context, REQUEST=REQUEST, **kw) # Calculate the unit price unit_base_price = None # Calculate # ((base_price + SUM(additional_price) + # variable_value * SUM(variable_additional_price)) * # (1 - MIN(1, MAX(SUM(discount_ratio) , exclusive_discount_ratio ))) + # SUM(non_discountable_additional_price)) * # (1 + SUM(surcharge_ratio)) # Or, as (nearly) one single line : # ((bp + S(ap) + v * S(vap)) # * (1 - m(1, M(S(dr), edr))) # + S(ndap)) # * (1 + S(sr)) # Variable value is dynamically configurable through a python script. # It can be anything, depending on business requirements. # It can be seen as a way to define a pricing model that not only # depends on discrete variations, but also on a continuous property # of the object base_price = price_parameter_dict['base_price'] if base_price in [None, '']: # XXX Compatibility # base_price must not be defined on resource base_price = self.getBasePrice() if base_price not in [None, '']: unit_base_price = base_price # Sum additional price for additional_price in price_parameter_dict['additional_price']: unit_base_price += additional_price # Sum variable additional price variable_value = self._getPricingVariable(context=context) for variable_additional_price in \ price_parameter_dict['variable_additional_price']: unit_base_price += variable_additional_price * variable_value # Discount sum_discount_ratio = 0 for discount_ratio in price_parameter_dict['discount_ratio']: sum_discount_ratio += discount_ratio exclusive_discount_ratio = \ price_parameter_dict['exclusive_discount_ratio'] d_ratio = 0 d_ratio = max(d_ratio, sum_discount_ratio) if exclusive_discount_ratio not in [None, '']: d_ratio = max(d_ratio, exclusive_discount_ratio) if d_ratio != 0: d_ratio = 1 - min(1, d_ratio) unit_base_price = unit_base_price * d_ratio # Sum non discountable additional price for non_discountable_additional_price in\ price_parameter_dict['non_discountable_additional_price']: unit_base_price += non_discountable_additional_price # Surcharge ratio sum_surcharge_ratio = 1 for surcharge_ratio in price_parameter_dict['surcharge_ratio']: sum_surcharge_ratio += surcharge_ratio unit_base_price = unit_base_price * sum_surcharge_ratio # Divide by the priced quantity if unit_base_price is not None: priced_quantity = self.getPricedQuantity() unit_base_price = unit_base_price / priced_quantity # Return result return unit_base_price security.declareProtected(Permissions.AccessContentsInformation, 'getQuantityPrecision') def getQuantityPrecision(self): """Return the floating point precision of a quantity. """ try: return int(round(- log(self.getBaseUnitQuantity(), 10),0)) except TypeError: return 0 return 0