## $Id: department.py 15968 2020-01-30 22:47:56Z henrik $
##
## Copyright (C) 2011 Uli Fouquet & Henrik Bettermann
## 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
##
"""University departments.
"""
import grok
import zope.location.location
from zope.event import notify
from zope.catalog.interfaces import ICatalog
from zope.component.interfaces import IFactory
from zope.interface import implementedBy
from zope.component import getUtility
from zope.schema import getFields
from waeup.kofa.university.faculty import longtitle
from waeup.kofa.university.coursescontainer import CoursesContainer
from waeup.kofa.university.certificatescontainer import CertificatesContainer
from waeup.kofa.utils.batching import VirtualExportJobContainer
from waeup.kofa.interfaces import IKofaUtils, IKofaPluggable
from waeup.kofa.university.interfaces import IDepartment
[docs]class VirtualDepartmentExportJobContainer(VirtualExportJobContainer):
"""A virtual export job container for departments.
"""
[docs]class Department(grok.Container):
"""A university department.
"""
grok.implements(IDepartment)
local_roles = [
'waeup.local.ApplicationsManager',
'waeup.local.DepartmentOfficer',
'waeup.local.DepartmentManager',
'waeup.local.ClearanceOfficer',
'waeup.local.UGClearanceOfficer',
'waeup.local.PGClearanceOfficer',
'waeup.local.ReportsOfficer',
'waeup.local.CourseAdviser100',
'waeup.local.CourseAdviser200',
'waeup.local.CourseAdviser300',
'waeup.local.CourseAdviser400',
'waeup.local.CourseAdviser500',
'waeup.local.CourseAdviser600',
'waeup.local.CourseAdviser700',
'waeup.local.CourseAdviser800',
'waeup.local.LocalStudentsManager',
'waeup.local.Lecturer',
]
[docs] def __init__(self,
title=u'Unnamed Department',
title_prefix=u'department',
code=u"NA",
officer_1=None,
officer_2=None,
officer_3=None,
officer_4=None,
**kw):
super(Department, self).__init__(**kw)
self.title = title
self.title_prefix = title_prefix
self.officer_1 = officer_1
self.officer_2 = officer_2
self.officer_3 = officer_3
self.officer_4 = officer_4
self.code = code
self.courses = CoursesContainer()
self.courses.__parent__ = self
self.courses.__name__ = 'courses'
self.certificates = CertificatesContainer()
self.certificates.__parent__ = self
self.certificates.__name__ = 'certificates'
self.score_editing_disabled = False
[docs] def traverse(self, name):
"""Deliver appropriate containers, if someone wants to go to courses,
certificates or exports.
"""
if name == 'courses':
return self.courses
elif name == 'certificates':
return self.certificates
elif name == 'exports':
# create a virtual exports container and return it
container = VirtualDepartmentExportJobContainer()
zope.location.location.located(container, self, 'exports')
return container
return None
@property
def longtitle(self):
return longtitle(self)
[docs] def moveDepartment(self, facname, depname):
""" Move department to new department named depname in
faculty named facname.
"""
self.moved = True
newfac = grok.getSite()['faculties'][facname]
oldcode = self.code
oldfac = self.__parent__
newfac[depname] = self
del oldfac[oldcode]
newfac[depname].code = depname
#self.__parent__._p_changed = True
cat = getUtility(ICatalog, name='students_catalog')
results = cat.searchResults(depcode=(oldcode, oldcode))
for student in results:
notify(grok.ObjectModifiedEvent(student))
student.__parent__.logger.info(
'%s - Department moved' % student.__name__)
return
[docs]class DepartmentFactory(grok.GlobalUtility):
"""A factory for department containers.
"""
grok.implements(IFactory)
grok.name(u'waeup.Department')
title = u"Create a new department.",
description = u"This factory instantiates new department instances."
[docs] def __call__(self, *args, **kw):
return Department(*args, **kw)
[docs] def getInterfaces(self):
"""Get interfaces of objects provided by this factory.
"""
return implementedBy(Department)
[docs]class DepartmentsPlugin(grok.GlobalUtility):
"""A plugin that updates departments.
"""
grok.implements(IKofaPluggable)
grok.name('departments')
deprecated_attributes = []
[docs] def setup(self, site, name, logger):
return
[docs] def update(self, site, name, logger):
items = getFields(IDepartment).items()
for faculty in site['faculties'].values():
for department in faculty.values():
# Add new attributes
for i in items:
if not hasattr(department,i[0]):
setattr(department,i[0],i[1].missing_value)
logger.info(
'DepartmentsPlugin: %s attribute %s added.' % (
department.code,i[0]))
# Remove deprecated attributes
for i in self.deprecated_attributes:
try:
delattr(department,i)
logger.info(
'DepartmentsPlugin: %s attribute %s deleted.' % (
department.code,i))
except AttributeError:
pass
return