RuleTool.py 4.02 KB
Newer Older
Jean-Paul Smets's avatar
Jean-Paul Smets committed
1 2 3
##############################################################################
#
# Copyright (c) 2002 Nexedi SARL and Contributors. All Rights Reserved.
Jean-Paul Smets's avatar
Jean-Paul Smets committed
4
#                    Jean-Paul Smets-Solanes <jp@nexedi.com>
Jean-Paul Smets's avatar
Jean-Paul Smets committed
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
#
# 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.
#
##############################################################################

29
from Products.ERP5Type.Tool.BaseTool import BaseTool
Jean-Paul Smets's avatar
Jean-Paul Smets committed
30
from AccessControl import ClassSecurityInfo
31
from Products.ERP5Type.Globals import InitializeClass, DTMLFile
Jean-Paul Smets's avatar
Jean-Paul Smets committed
32
from Products.ERP5Type import Permissions
33
from Products.CMFCore.utils import getToolByName
Jean-Paul Smets's avatar
Jean-Paul Smets committed
34 35 36

from Products.ERP5 import _dtmldir

37
class RuleTool(BaseTool):
Jean-Paul Smets's avatar
Jean-Paul Smets committed
38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77
    """
    The RulesTool implements portal object
    transformation policies.

    An object transformation template is defined by
    a domain and a transformation pattent:

    The domain is defined as:

    - the meta_type it applies to

    - the portal_type it applies to

    - the conditions of application (category membership, value range,
      security, function, etc.)

    The transformation template is defined as:

    - a tree of portal_types starting on the object itself

    - default values for each node of the tree, incl. the root itself

    When a transformation is triggered, it will check the existence of
    each node and eventually update values

    Transformations are very similar to XSLT in the XML world.

    Examples of applications:

    - generate accounting movements from a stock movement

    - generate a birthday event from a person

    ERP5 main application : generate submovements from movements
    according to templates. Allows to parametrize modules
    such as payroll.

    """
    id = 'portal_rules'
    meta_type = 'ERP5 Rule Tool'
78
    portal_type = 'Rule Tool'
79 80 81
    allowed_types = ( 'ERP5 Order Rule', 'ERP5 Transformation Rule',
                      'ERP5 Zero Stock Rule', 'ERP5 Delivery Rule',
                      'ERP5 Amortisation Rule')
Jean-Paul Smets's avatar
Jean-Paul Smets committed
82 83 84 85 86 87 88

    # Declarative Security
    security = ClassSecurityInfo()

    security.declareProtected( Permissions.ManagePortal, 'manage_overview' )
    manage_overview = DTMLFile( 'explainRuleTool', _dtmldir )

89
    security.declareProtected(Permissions.AccessContentsInformation,
90
                              'searchRuleList')
91
    def searchRuleList(self, movement, tested_base_category_list=None, **kw):
92 93 94 95 96 97 98
      """
      this method searches for rules, as predicates against movement

      - the rule must be in "validated" state
      - the rule must be of a known portal type
      - Predicate criterions can be used (like start_date_range_min)
      """
99
      domain_tool = getToolByName(self.getPortalObject(), "portal_domains")
100

101 102 103
      if tested_base_category_list is None:
        tested_base_category_list = []

104 105 106 107 108 109
      rule_list = domain_tool.searchPredicateList(context=movement,
          tested_base_category_list=tested_base_category_list,
          portal_type=self.getPortalRuleTypeList(),
          validation_state="validated", **kw) #XXX "validated" is hardcoded

      return rule_list
Jean-Paul Smets's avatar
Jean-Paul Smets committed
110 111

InitializeClass(RuleTool)