addons/hr/hr.py

   1 # -*- coding: utf-8 -*-
   2 ##############################################################################
   3 #
   4 #    OpenERP, Open Source Management Solution
   5 #    Copyright (C) 2004-2010 Tiny SPRL (<http://tiny.be>).
   6 #
   7 #    This program is free software: you can redistribute it and/or modify
   8 #    it under the terms of the GNU Affero General Public License as
   9 #    published by the Free Software Foundation, either version 3 of the
  10 #    License, or (at your option) any later version.
  11 #
  12 #    This program is distributed in the hope that it will be useful,
  13 #    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 #    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 #    GNU Affero General Public License for more details.
  16 #
  17 #    You should have received a copy of the GNU Affero General Public License
  18 #    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19 #
  20 ##############################################################################
  21
  22 import logging
  23
  24 from openerp import SUPERUSER_ID
  25 from openerp import tools
  26 from openerp.modules.module import get_module_resource
  27 from openerp.osv import fields, osv
  28 from openerp.tools.translate import _
  29
  30 _logger = logging.getLogger(__name__)
  31
  32
  33 class hr_employee_category(osv.Model):
  34
  35     def name_get(self, cr, uid, ids, context=None):
  36         if not ids:
  37             return []
  38         reads = self.read(cr, uid, ids, ['name','parent_id'], context=context)
  39         res = []
  40         for record in reads:
  41             name = record['name']
  42             if record['parent_id']:
  43                 name = record['parent_id'][1]+' / '+name
  44             res.append((record['id'], name))
  45         return res
  46
  47     def _name_get_fnc(self, cr, uid, ids, prop, unknow_none, context=None):
  48         res = self.name_get(cr, uid, ids, context=context)
  49         return dict(res)
  50
  51     _name = "hr.employee.category"
  52     _description = "Employee Category"
  53     _columns = {
  54         'name': fields.char("Employee Tag", size=64, required=True),
  55         'complete_name': fields.function(_name_get_fnc, type="char", string='Name'),
  56         'parent_id': fields.many2one('hr.employee.category', 'Parent Employee Tag', select=True),
  57         'child_ids': fields.one2many('hr.employee.category', 'parent_id', 'Child Categories'),
  58         'employee_ids': fields.many2many('hr.employee', 'employee_category_rel', 'category_id', 'emp_id', 'Employees'),
  59     }
  60
  61     def _check_recursion(self, cr, uid, ids, context=None):
  62         level = 100
  63         while len(ids):
  64             cr.execute('select distinct parent_id from hr_employee_category where id IN %s', (tuple(ids), ))
  65             ids = filter(None, map(lambda x:x[0], cr.fetchall()))
  66             if not level:
  67                 return False
  68             level -= 1
  69         return True
  70
  71     _constraints = [
  72         (_check_recursion, 'Error! You cannot create recursive Categories.', ['parent_id'])
  73     ]
  74
  75
  76 class hr_job(osv.Model):
  77
  78     def _get_nbr_employees(self, cr, uid, ids, name, args, context=None):
  79         res = {}
  80         for job in self.browse(cr, uid, ids, context=context):
  81             nb_employees = len(job.employee_ids or [])
  82             res[job.id] = {
  83                 'no_of_employee': nb_employees,
  84                 'expected_employees': nb_employees + job.no_of_recruitment,
  85             }
  86         return res
  87
  88     def _get_job_position(self, cr, uid, ids, context=None):
  89         res = []
  90         for employee in self.pool.get('hr.employee').browse(cr, uid, ids, context=context):
  91             if employee.job_id:
  92                 res.append(employee.job_id.id)
  93         return res
  94
  95     _name = "hr.job"
  96     _description = "Job Position"
  97     _inherit = ['mail.thread', 'ir.needaction_mixin']
  98     _columns = {
  99         'name': fields.char('Job Name', size=128, required=True, select=True),
 100         'expected_employees': fields.function(_get_nbr_employees, string='Total Forecasted Employees',
 101             help='Expected number of employees for this job position after new recruitment.',
 102             store = {
 103                 'hr.job': (lambda self,cr,uid,ids,c=None: ids, ['no_of_recruitment'], 10),
 104                 'hr.employee': (_get_job_position, ['job_id'], 10),
 105             }, type='integer',
 106             multi='_get_nbr_employees'),
 107         'no_of_employee': fields.function(_get_nbr_employees, string="Current Number of Employees",
 108             help='Number of employees currently occupying this job position.',
 109             store = {
 110                 'hr.employee': (_get_job_position, ['job_id'], 10),
 111             }, type='integer',
 112             multi='_get_nbr_employees'),
 113         'no_of_recruitment': fields.integer('Expected New Employees', help='Number of new employees you expect to recruit.'),
 114         'no_of_hired_employee': fields.integer('Hired Employees', help='Number of hired employees for this job position during recruitment phase.'),
 115         'employee_ids': fields.one2many('hr.employee', 'job_id', 'Employees', groups='base.group_user'),
 116         'description': fields.text('Job Description'),
 117         'requirements': fields.text('Requirements'),
 118         'department_id': fields.many2one('hr.department', 'Department'),
 119         'company_id': fields.many2one('res.company', 'Company'),
 120         'state': fields.selection([('open', 'Recruitment Closed'), ('recruit', 'Recruitment in Progress')],
 121                                   string='Status', readonly=True, required=True,
 122                                   track_visibility='always',
 123                                   help="By default 'Closed', set it to 'In Recruitment' if recruitment process is going on for this job position."),
 124         'write_date': fields.datetime('Update Date', readonly=True),
 125     }
 126
 127     _defaults = {
 128         'company_id': lambda self, cr, uid, ctx=None: self.pool.get('res.company')._company_default_get(cr, uid, 'hr.job', context=ctx),
 129         'state': 'open',
 130     }
 131
 132     _sql_constraints = [
 133         ('name_company_uniq', 'unique(name, company_id, department_id)', 'The name of the job position must be unique per department in company!'),
 134         ('hired_employee_check', "CHECK ( no_of_hired_employee <= no_of_recruitment )", "Number of hired employee must be less than expected number of employee in recruitment."),
 135     ]
 136
 137     def set_recruit(self, cr, uid, ids, context=None):
 138         for job in self.browse(cr, uid, ids, context=context):
 139             no_of_recruitment = job.no_of_recruitment == 0 and 1 or job.no_of_recruitment
 140             self.write(cr, uid, [job.id], {'state': 'recruit', 'no_of_recruitment': no_of_recruitment}, context=context)
 141         return True
 142
 143     def set_open(self, cr, uid, ids, context=None):
 144         self.write(cr, uid, ids, {
 145             'state': 'open',
 146             'no_of_recruitment': 0,
 147             'no_of_hired_employee': 0
 148         }, context=context)
 149         return True
 150
 151     def copy(self, cr, uid, id, default=None, context=None):
 152         if default is None:
 153             default = {}
 154         default.update({
 155             'employee_ids': [],
 156             'no_of_recruitment': 0,
 157             'no_of_hired_employee': 0,
 158         })
 159         if 'name' in default:
 160             job = self.browse(cr, uid, id, context=context)
 161             default['name'] = _("%s (copy)") % (job.name)
 162         return super(hr_job, self).copy(cr, uid, id, default=default, context=context)
 163
 164     # ----------------------------------------
 165     # Compatibility methods
 166     # ----------------------------------------
 167     _no_of_employee = _get_nbr_employees  # v7 compatibility
 168     job_open = set_open  # v7 compatibility
 169     job_recruitment = set_recruit  # v7 compatibility
 170
 171
 172 class hr_employee(osv.osv):
 173     _name = "hr.employee"
 174     _description = "Employee"
 175     _order = 'name_related'
 176     _inherits = {'resource.resource': "resource_id"}
 177     _inherit = ['mail.thread']
 178
 179     _mail_post_access = 'read'
 180
 181     def _get_image(self, cr, uid, ids, name, args, context=None):
 182         result = dict.fromkeys(ids, False)
 183         for obj in self.browse(cr, uid, ids, context=context):
 184             result[obj.id] = tools.image_get_resized_images(obj.image)
 185         return result
 186
 187     def _set_image(self, cr, uid, id, name, value, args, context=None):
 188         return self.write(cr, uid, [id], {'image': tools.image_resize_image_big(value)}, context=context)
 189
 190     _columns = {
 191         #we need a related field in order to be able to sort the employee by name
 192         'name_related': fields.related('resource_id', 'name', type='char', string='Name', readonly=True, store=True),
 193         'country_id': fields.many2one('res.country', 'Nationality'),
 194         'birthday': fields.date("Date of Birth"),
 195         'ssnid': fields.char('SSN No', size=32, help='Social Security Number'),
 196         'sinid': fields.char('SIN No', size=32, help="Social Insurance Number"),
 197         'identification_id': fields.char('Identification No', size=32),
 198         'otherid': fields.char('Other Id', size=64),
 199         'gender': fields.selection([('male', 'Male'), ('female', 'Female')], 'Gender'),
 200         'marital': fields.selection([('single', 'Single'), ('married', 'Married'), ('widower', 'Widower'), ('divorced', 'Divorced')], 'Marital Status'),
 201         'department_id': fields.many2one('hr.department', 'Department'),
 202         'address_id': fields.many2one('res.partner', 'Working Address'),
 203         'address_home_id': fields.many2one('res.partner', 'Home Address'),
 204         'bank_account_id': fields.many2one('res.partner.bank', 'Bank Account Number', domain="[('partner_id','=',address_home_id)]", help="Employee bank salary account"),
 205         'work_phone': fields.char('Work Phone', size=32, readonly=False),
 206         'mobile_phone': fields.char('Work Mobile', size=32, readonly=False),
 207         'work_email': fields.char('Work Email', size=240),
 208         'work_location': fields.char('Office Location', size=32),
 209         'notes': fields.text('Notes'),
 210         'parent_id': fields.many2one('hr.employee', 'Manager'),
 211         'category_ids': fields.many2many('hr.employee.category', 'employee_category_rel', 'emp_id', 'category_id', 'Tags'),
 212         'child_ids': fields.one2many('hr.employee', 'parent_id', 'Subordinates'),
 213         'resource_id': fields.many2one('resource.resource', 'Resource', ondelete='cascade', required=True),
 214         'coach_id': fields.many2one('hr.employee', 'Coach'),
 215         'job_id': fields.many2one('hr.job', 'Job Title'),
 216         # image: all image fields are base64 encoded and PIL-supported
 217         'image': fields.binary("Photo",
 218             help="This field holds the image used as photo for the employee, limited to 1024x1024px."),
 219         'image_medium': fields.function(_get_image, fnct_inv=_set_image,
 220             string="Medium-sized photo", type="binary", multi="_get_image",
 221             store = {
 222                 'hr.employee': (lambda self, cr, uid, ids, c={}: ids, ['image'], 10),
 223             },
 224             help="Medium-sized photo of the employee. It is automatically "\
 225                  "resized as a 128x128px image, with aspect ratio preserved. "\
 226                  "Use this field in form views or some kanban views."),
 227         'image_small': fields.function(_get_image, fnct_inv=_set_image,
 228             string="Smal-sized photo", type="binary", multi="_get_image",
 229             store = {
 230                 'hr.employee': (lambda self, cr, uid, ids, c={}: ids, ['image'], 10),
 231             },
 232             help="Small-sized photo of the employee. It is automatically "\
 233                  "resized as a 64x64px image, with aspect ratio preserved. "\
 234                  "Use this field anywhere a small image is required."),
 235         'passport_id': fields.char('Passport No', size=64),
 236         'color': fields.integer('Color Index'),
 237         'city': fields.related('address_id', 'city', type='char', string='City'),
 238         'login': fields.related('user_id', 'login', type='char', string='Login', readonly=1),
 239         'last_login': fields.related('user_id', 'date', type='datetime', string='Latest Connection', readonly=1),
 240     }
 241
 242     def _get_default_image(self, cr, uid, context=None):
 243         image_path = get_module_resource('hr', 'static/src/img', 'default_image.png')
 244         return tools.image_resize_image_big(open(image_path, 'rb').read().encode('base64'))
 245
 246     defaults = {
 247         'active': 1,
 248         'image': _get_default_image,
 249         'color': 0,
 250     }
 251
 252     def _broadcast_welcome(self, cr, uid, employee_id, context=None):
 253         """ Broadcast the welcome message to all users in the employee company. """
 254         employee = self.browse(cr, uid, employee_id, context=context)
 255         partner_ids = []
 256         _model, group_id = self.pool['ir.model.data'].get_object_reference(cr, uid, 'base', 'group_user')
 257         if employee.user_id:
 258             company_id = employee.user_id.company_id.id
 259         elif employee.company_id:
 260             company_id = employee.company_id.id
 261         elif employee.job_id:
 262             company_id = employee.job_id.company_id.id
 263         elif employee.department_id:
 264             company_id = employee.department_id.company_id.id
 265         else:
 266             company_id = self.pool['res.company']._company_default_get(cr, uid, 'hr.employee', context=context)
 267         res_users = self.pool['res.users']
 268         user_ids = res_users.search(
 269             cr, SUPERUSER_ID, [
 270                 ('company_id', '=', company_id),
 271                 ('groups_id', 'in', group_id)
 272             ], context=context)
 273         partner_ids = list(set(u.partner_id.id for u in res_users.browse(cr, SUPERUSER_ID, user_ids, context=context)))
 274         self.message_post(
 275             cr, uid, [employee_id],
 276             body=_('Welcome to %s! Please help him/her take the first steps with OpenERP!') % (employee.name),
 277             partner_ids=partner_ids,
 278             subtype='mail.mt_comment', context=context
 279         )
 280         return True
 281
 282     def create(self, cr, uid, data, context=None):
 283         if context is None:
 284             context = {}
 285         if context.get("mail_broadcast"):
 286             context['mail_create_nolog'] = True
 287
 288         employee_id = super(hr_employee, self).create(cr, uid, data, context=context)
 289
 290         if context.get("mail_broadcast"):
 291             self._broadcast_welcome(cr, uid, employee_id, context=context)
 292         return employee_id
 293
 294     def unlink(self, cr, uid, ids, context=None):
 295         resource_ids = []
 296         for employee in self.browse(cr, uid, ids, context=context):
 297             resource_ids.append(employee.resource_id.id)
 298         return self.pool.get('resource.resource').unlink(cr, uid, resource_ids, context=context)
 299
 300     def onchange_address_id(self, cr, uid, ids, address, context=None):
 301         if address:
 302             address = self.pool.get('res.partner').browse(cr, uid, address, context=context)
 303             return {'value': {'work_phone': address.phone, 'mobile_phone': address.mobile}}
 304         return {'value': {}}
 305
 306     def onchange_company(self, cr, uid, ids, company, context=None):
 307         address_id = False
 308         if company:
 309             company_id = self.pool.get('res.company').browse(cr, uid, company, context=context)
 310             address = self.pool.get('res.partner').address_get(cr, uid, [company_id.partner_id.id], ['default'])
 311             address_id = address and address['default'] or False
 312         return {'value': {'address_id': address_id}}
 313
 314     def onchange_department_id(self, cr, uid, ids, department_id, context=None):
 315         value = {'parent_id': False}
 316         if department_id:
 317             department = self.pool.get('hr.department').browse(cr, uid, department_id)
 318             value['parent_id'] = department.manager_id.id
 319         return {'value': value}
 320
 321     def onchange_user(self, cr, uid, ids, user_id, context=None):
 322         work_email = False
 323         if user_id:
 324             work_email = self.pool.get('res.users').browse(cr, uid, user_id, context=context).email
 325         return {'value': {'work_email': work_email}}
 326
 327     def action_follow(self, cr, uid, ids, context=None):
 328         """ Wrapper because message_subscribe_users take a user_ids=None
 329             that receive the context without the wrapper. """
 330         return self.message_subscribe_users(cr, uid, ids, context=context)
 331
 332     def action_unfollow(self, cr, uid, ids, context=None):
 333         """ Wrapper because message_unsubscribe_users take a user_ids=None
 334             that receive the context without the wrapper. """
 335         return self.message_unsubscribe_users(cr, uid, ids, context=context)
 336
 337     def get_suggested_thread(self, cr, uid, removed_suggested_threads=None, context=None):
 338         """Show the suggestion of employees if display_employees_suggestions if the
 339         user perference allows it. """
 340         user = self.pool.get('res.users').browse(cr, uid, uid, context)
 341         if not user.display_employees_suggestions:
 342             return []
 343         else:
 344             return super(hr_employee, self).get_suggested_thread(cr, uid, removed_suggested_threads, context)
 345
 346     def _message_get_auto_subscribe_fields(self, cr, uid, updated_fields, auto_follow_fields=['user_id'], context=None):
 347         """ Overwrite of the original method to always follow user_id field,
 348         even when not track_visibility so that a user will follow it's employee
 349         """
 350         user_field_lst = []
 351         for name, column_info in self._all_columns.items():
 352             if name in auto_follow_fields and name in updated_fields and column_info.column._obj == 'res.users':
 353                 user_field_lst.append(name)
 354         return user_field_lst
 355
 356     def _check_recursion(self, cr, uid, ids, context=None):
 357         level = 100
 358         while len(ids):
 359             cr.execute('SELECT DISTINCT parent_id FROM hr_employee WHERE id IN %s AND parent_id!=id',(tuple(ids),))
 360             ids = filter(None, map(lambda x:x[0], cr.fetchall()))
 361             if not level:
 362                 return False
 363             level -= 1
 364         return True
 365
 366     _constraints = [
 367         (_check_recursion, 'Error! You cannot create recursive hierarchy of Employee(s).', ['parent_id']),
 368     ]
 369
 370
 371 class hr_department(osv.osv):
 372
 373     def _dept_name_get_fnc(self, cr, uid, ids, prop, unknow_none, context=None):
 374         res = self.name_get(cr, uid, ids, context=context)
 375         return dict(res)
 376
 377     _name = "hr.department"
 378     _columns = {
 379         'name': fields.char('Department Name', size=64, required=True),
 380         'complete_name': fields.function(_dept_name_get_fnc, type="char", string='Name'),
 381         'company_id': fields.many2one('res.company', 'Company', select=True, required=False),
 382         'parent_id': fields.many2one('hr.department', 'Parent Department', select=True),
 383         'child_ids': fields.one2many('hr.department', 'parent_id', 'Child Departments'),
 384         'manager_id': fields.many2one('hr.employee', 'Manager'),
 385         'member_ids': fields.one2many('hr.employee', 'department_id', 'Members', readonly=True),
 386         'jobs_ids': fields.one2many('hr.job', 'department_id', 'Jobs'),
 387         'note': fields.text('Note'),
 388     }
 389
 390     _defaults = {
 391         'company_id': lambda self, cr, uid, c: self.pool.get('res.company')._company_default_get(cr, uid, 'hr.department', context=c),
 392     }
 393
 394     def _check_recursion(self, cr, uid, ids, context=None):
 395         if context is None:
 396             context = {}
 397         level = 100
 398         while len(ids):
 399             cr.execute('select distinct parent_id from hr_department where id IN %s',(tuple(ids),))
 400             ids = filter(None, map(lambda x:x[0], cr.fetchall()))
 401             if not level:
 402                 return False
 403             level -= 1
 404         return True
 405
 406     _constraints = [
 407         (_check_recursion, 'Error! You cannot create recursive departments.', ['parent_id'])
 408     ]
 409
 410     def name_get(self, cr, uid, ids, context=None):
 411         if context is None:
 412             context = {}
 413         if not ids:
 414             return []
 415         reads = self.read(cr, uid, ids, ['name','parent_id'], context=context)
 416         res = []
 417         for record in reads:
 418             name = record['name']
 419             if record['parent_id']:
 420                 name = record['parent_id'][1]+' / '+name
 421             res.append((record['id'], name))
 422         return res
 423
 424     def copy(self, cr, uid, ids, default=None, context=None):
 425         if default is None:
 426             default = {}
 427         default = default.copy()
 428         default['member_ids'] = []
 429         return super(hr_department, self).copy(cr, uid, ids, default, context=context)
 430
 431
 432 class res_users(osv.osv):
 433     _name = 'res.users'
 434     _inherit = 'res.users'
 435
 436     _columns = {
 437         'employee_ids': fields.one2many('hr.employee', 'user_id', 'Related employees'),
 438     }
 439
 440
 441 # vim:expandtab:smartindent:tabstop=4:softtabstop=4:shiftwidth=4: