1 # -*- coding: utf-8 -*-
2 ##############################################################################
4 # OpenERP, Open Source Management Solution
5 # Copyright (C) 2004-2010 Tiny SPRL (<http://tiny.be>).
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.
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.
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/>.
20 ##############################################################################
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 _
30 _logger = logging.getLogger(__name__)
33 class hr_employee_category(osv.Model):
35 def name_get(self, cr, uid, ids, context=None):
38 reads = self.read(cr, uid, ids, ['name','parent_id'], context=context)
42 if record['parent_id']:
43 name = record['parent_id'][1]+' / '+name
44 res.append((record['id'], name))
47 def _name_get_fnc(self, cr, uid, ids, prop, unknow_none, context=None):
48 res = self.name_get(cr, uid, ids, context=context)
51 _name = "hr.employee.category"
52 _description = "Employee Category"
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'),
61 def _check_recursion(self, cr, uid, ids, context=None):
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()))
72 (_check_recursion, 'Error! You cannot create recursive Categories.', ['parent_id'])
76 class hr_job(osv.Model):
78 def _get_nbr_employees(self, cr, uid, ids, name, args, context=None):
80 for job in self.browse(cr, uid, ids, context=context):
81 nb_employees = len(job.employee_ids or [])
83 'no_of_employee': nb_employees,
84 'expected_employees': nb_employees + job.no_of_recruitment,
88 def _get_job_position(self, cr, uid, ids, context=None):
90 for employee in self.pool.get('hr.employee').browse(cr, uid, ids, context=context):
92 res.append(employee.job_id.id)
96 _description = "Job Position"
97 _inherit = ['mail.thread', 'ir.needaction_mixin']
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.',
103 'hr.job': (lambda self,cr,uid,ids,c=None: ids, ['no_of_recruitment'], 10),
104 'hr.employee': (_get_job_position, ['job_id'], 10),
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.',
110 'hr.employee': (_get_job_position, ['job_id'], 10),
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),
128 'company_id': lambda self, cr, uid, ctx=None: self.pool.get('res.company')._company_default_get(cr, uid, 'hr.job', context=ctx),
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."),
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)
143 def set_open(self, cr, uid, ids, context=None):
144 self.write(cr, uid, ids, {
146 'no_of_recruitment': 0,
147 'no_of_hired_employee': 0
151 def copy(self, cr, uid, id, default=None, context=None):
156 'no_of_recruitment': 0,
157 'no_of_hired_employee': 0,
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)
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
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']
179 _mail_post_access = 'read'
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)
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)
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",
222 'hr.employee': (lambda self, cr, uid, ids, c={}: ids, ['image'], 10),
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",
230 'hr.employee': (lambda self, cr, uid, ids, c={}: ids, ['image'], 10),
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),
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'))
248 'image': _get_default_image,
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)
256 _model, group_id = self.pool['ir.model.data'].get_object_reference(cr, uid, 'base', 'group_user')
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
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(
270 ('company_id', '=', company_id),
271 ('groups_id', 'in', group_id)
273 partner_ids = list(set(u.partner_id.id for u in res_users.browse(cr, SUPERUSER_ID, user_ids, context=context)))
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
282 def create(self, cr, uid, data, context=None):
285 if context.get("mail_broadcast"):
286 context['mail_create_nolog'] = True
288 employee_id = super(hr_employee, self).create(cr, uid, data, context=context)
290 if context.get("mail_broadcast"):
291 self._broadcast_welcome(cr, uid, employee_id, context=context)
294 def unlink(self, cr, uid, ids, context=None):
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)
300 def onchange_address_id(self, cr, uid, ids, address, context=None):
302 address = self.pool.get('res.partner').browse(cr, uid, address, context=context)
303 return {'value': {'work_phone': address.phone, 'mobile_phone': address.mobile}}
306 def onchange_company(self, cr, uid, ids, company, context=None):
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}}
314 def onchange_department_id(self, cr, uid, ids, department_id, context=None):
315 value = {'parent_id': False}
317 department = self.pool.get('hr.department').browse(cr, uid, department_id)
318 value['parent_id'] = department.manager_id.id
319 return {'value': value}
321 def onchange_user(self, cr, uid, ids, user_id, context=None):
324 work_email = self.pool.get('res.users').browse(cr, uid, user_id, context=context).email
325 return {'value': {'work_email': work_email}}
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)
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)
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:
344 return super(hr_employee, self).get_suggested_thread(cr, uid, removed_suggested_threads, context)
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
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
356 def _check_recursion(self, cr, uid, ids, context=None):
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()))
367 (_check_recursion, 'Error! You cannot create recursive hierarchy of Employee(s).', ['parent_id']),
371 class hr_department(osv.osv):
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)
377 _name = "hr.department"
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'),
391 'company_id': lambda self, cr, uid, c: self.pool.get('res.company')._company_default_get(cr, uid, 'hr.department', context=c),
394 def _check_recursion(self, cr, uid, ids, context=None):
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()))
407 (_check_recursion, 'Error! You cannot create recursive departments.', ['parent_id'])
410 def name_get(self, cr, uid, ids, context=None):
415 reads = self.read(cr, uid, ids, ['name','parent_id'], context=context)
418 name = record['name']
419 if record['parent_id']:
420 name = record['parent_id'][1]+' / '+name
421 res.append((record['id'], name))
424 def copy(self, cr, uid, ids, default=None, context=None):
427 default = default.copy()
428 default['member_ids'] = []
429 return super(hr_department, self).copy(cr, uid, ids, default, context=context)
432 class res_users(osv.osv):
434 _inherit = 'res.users'
437 'employee_ids': fields.one2many('hr.employee', 'user_id', 'Related employees'),
441 # vim:expandtab:smartindent:tabstop=4:softtabstop=4:shiftwidth=4: