Context navigation

source: WAeUP_SRP/trunk/WAeUPImport.py @ 3709

Last change on this file since 3709 was 3705, checked in by Henrik Bettermann, 16 years ago
add Uniben profile (was default profile) enable transfer students import
Property svn:keywords set to `Id`
File size: 58.5 KB

Line
1	#-- mode: python; mode: fold --
2	# (C) Copyright 2005 The WAeUP group <http://www.waeup.org>
3	# Author: Joachim Schmitz (js@aixtraware.de)
4	#
5	# This program is free software; you can redistribute it and/or modify
6	# it under the terms of the GNU General Public License version 2 as published
7	# by the Free Software Foundation.
8	#
9	# This program is distributed in the hope that it will be useful,
10	# but WITHOUT ANY WARRANTY; without even the implied warranty of
11	# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12	# GNU General Public License for more details.
13	#
14	# You should have received a copy of the GNU General Public License
15	# along with this program; if not, write to the Free Software
16	# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
17	# 02111-1307, USA.
18	#
19	# $Id: WAeUPImport.py 3705 2008-10-02 09:10:57Z henrik $
20	"""The WAeUP Tool Box.
21	"""
22
23	#from AccessControl import ClassSecurityInfo
24	#from Acquisition import aq_inner
25	#from Acquisition import aq_parent
26	#from Globals import DTMLFile
27	#from Globals import InitializeClass
28	from OFS.SimpleItem import SimpleItem
29	from zExceptions import BadRequest
30
31	#from Products.CMFCore.utils import getToolByName
32	#from Products.CPSSchemas.DataStructure import DataStructure
33	#from Products.CPSSchemas.DataModel import DataModel
34	#from Products.CPSSchemas.StorageAdapter import MappingStorageAdapter
35	from Products.CMFCore.ActionProviderBase import ActionProviderBase
36	#from Products.CMFCore.permissions import View
37	#from Products.ZCatalog.ZCatalog import ZCatalog
38	#from Products.CMFCore.permissions import ModifyPortalContent
39	#from Products.CMFCore.permissions import ManagePortal
40	from Products.CMFCore.utils import UniqueObject
41	#from Products.CMFCore.URLTool import URLTool
42	from Products.CMFCore.utils import getToolByName
43	from Globals import package_home,INSTANCE_HOME
44	from Products.AdvancedQuery import Eq, Between, Le,In
45	import csv,re,os,sys
46	from shutil import copy2
47	import DateTime,time
48	import logging
49	p_home = package_home(globals())
50	i_home = INSTANCE_HOME
51	from utils import makeDigest
52
53	NO_KEY = '----'
54	IGNORE = 'ignore'
55	class WAeUPImport(UniqueObject, SimpleItem, ActionProviderBase): ###(
56	""" WAeUPImport """
57	required_modes = ('create',)
58
59	def __init__(self,waeup_tool): ###(
60	self.students_folder = waeup_tool.portal_url.getPortalObject().campus.students
61	self.member = member = waeup_tool.portal_membership.getAuthenticatedMember()
62	self.import_date = DateTime.DateTime()
63	self.imported_by = str(member)
64	#self.current = DateTime.DateTime().strftime("%d-%m-%y_%H_%M_%S")
65	self.waeup_tool = waeup_tool
66	self.academics_folder = waeup_tool.portal_url.getPortalObject().campus.academics
67	self.schema_tool = getToolByName(waeup_tool, 'portal_schemas')
68	self.layout_tool = getToolByName(waeup_tool, 'portal_layouts')
69	self.portal_workflow = getToolByName(waeup_tool, 'portal_workflow')
70	self.portal_url = getToolByName(waeup_tool, 'portal_url')
71	self.portal_catalog = waeup_tool.portal_catalog
72	self.students_catalog = waeup_tool.students_catalog
73	self.courses_catalog = waeup_tool.courses_catalog
74	self.course_results = waeup_tool.course_results
75	self.applicants_catalog = waeup_tool.applicants_catalog
76	#self.mode = mode
77	# self.import_method = getattr(self, '%s' % mode,None)
78	errors = []
79	# if self.import_method is None:
80	# errors.append('No importer method %s' % mode)
81	self.pending_path = "%s/import/%s.pending" % (i_home,self.plural_name)
82	self.pending_tmp = "%s/import/%s.pending.tmp" % (i_home,self.plural_name)
83	self.pending_backup = "%s/import/%s.pending.old" % (i_home,self.plural_name)
84	self.pending_fn = os.path.split(self.pending_path)[1]
85	self.imported_path = "%s/import/%s.imported" % (i_home,self.plural_name)
86	self.imported_fn = os.path.split(self.imported_path)[1]
87	iname = "import_%s" % self.name
88	self.logger = logging.getLogger('WAeUPImport.%sImport' % self.plural_name.capitalize())
89	self.schema = self.schema_tool._getOb(iname,None)
90	#self.pending_schema = self.schema_tool._getOb("%s_pending" % iname,None)
91	self.layout = self.layout_tool._getOb(iname,None)
92	while True:
93	if self.schema is None:
94	errors.append('no schema %s' % iname)
95	# if self.pending_schema is None:
96	# self.pending_schema = self.schema
97	if self.layout is None:
98	errors.append('no such layout %s' % iname)
99	if errors:
100	break
101	self.data_keys = self.schema.keys()
102	self.csv_keys = self.schema.keys()
103	info = {}
104	info['imported_from'] = ''
105	info['import_record_no'] = 0
106	info['imported_by'] = self.imported_by
107	info['import_date'] = self.import_date.strftime("%d/%m/%y %H:%M:%S")
108	info['error'] = ''
109	self.info = info
110	self.csv_keys.extend(self.info)
111	self.validators = {}
112	for widget in self.layout.keys():
113	self.validators[widget] = self.layout[widget].validate
114	self.required_keys = {}
115	for mode in self.required_modes:
116	self.required_keys[mode] = [self.layout.getIdUnprefixed(id)
117	for id,widget in self.layout.objectItems()
118	if widget.is_required]
119	break
120	self.init_errors = ','.join(errors)
121	###)
122
123	def findStudent(self,mode,student_id=None, matric_no=None, jamb_reg_no=None): ###(
124	student_record = None
125	msg = ''
126	key_used = ''
127	while True:
128	if student_id:
129	key_used = 'student_id'
130	res = self.students_catalog(id = student_id)
131	if not res:
132	msg = "no student with id %s" % student_id
133	break
134	student_record = res[0]
135	if matric_no and student_record.matric_no:
136	if matric_no != student_record.matric_no:
137	msg = "old matric_no %s overwritten with %s" % (student_record.matric_no,matric_no)
138	#logger.info("%s, old matric_no %s overwritten with %s" % (student_record.id,student_record.matric_no,matric_no))
139	if jamb_reg_no and student_record.jamb_reg_no:
140	if jamb_reg_no != student_record.jamb_reg_no:
141	msg = "old reg_no %s overwritten with %s" % (student_record.jamb_reg_no,jamb_reg_no)
142	#logger.info("%s, old reg_no %s overwritten with %s" % (student_record.id,student_record.jamb_reg_no,jamb_reg_no))
143	elif jamb_reg_no:
144	key_used = 'jamb_reg_no'
145	res = self.students_catalog(jamb_reg_no = jamb_reg_no)
146	if res:
147	if mode == 'create':
148	msg = "jamb_reg_no exists"
149	break
150	else:
151	if mode == 'edit':
152	msg = "no student with jamb_reg_no %s" % jamb_reg_no
153	break
154	student_record = res[0]
155	elif matric_no:
156	key_used = 'matric_no'
157	res = self.students_catalog(matric_no = matric_no)
158	if not res:
159	msg = "no student with matric_no %s" % matric_no
160	break
161	student_record = res[0]
162	else:
163	msg = "neither id, matric_no nor reg_no specified"
164	break
165	d = {}
166	d['student_record'] = student_record
167	d['key_used'] = key_used
168	d['msg'] = msg
169	return d
170	###)
171
172	def makeIdLists(self): ###(
173	pending_digests = []
174	pending = []
175	# pending_student_ids = []
176	# pending_matric_nos = []
177	# pending_reg_ns = []
178	if os.path.exists(self.pending_path):
179	datafile = open(self.pending_path,"r")
180	reader = csv.reader(datafile)
181	old_headline = reader.next()
182	#datafile.seek(0)
183	pending_csv_reader = csv.DictReader(datafile,old_headline,)
184	#pending_csv_reader.next() # skip headline
185	for item in pending_csv_reader:
186	digest = makeDigest(item,self.data_keys)
187	if digest not in pending_digests:
188	pending_digests += digest,
189	pending += item,
190	datafile.close()
191	#copy2(self.pending_path,self.pending_backup)
192	return pending, pending_digests
193	###)
194
195	def checkHeadline(self,headline): ###(
196	""" check the headline of a csv file """
197	import_keys = [k.strip() for k in headline if not (k.strip().startswith('ignore')
198	or k.strip() in self.info.keys())]
199	# import_keys = [k.strip() for k in headline if not (k.strip() in self.info.keys())]
200	diff2schema = set(import_keys).difference(set(self.schema.keys()))
201	diff2layout = set(import_keys).difference(set(self.layout.keys()))
202	#if diff2schema and diff2schema != set(['id',]):
203	if diff2schema:
204	return list(diff2schema)
205	return []
206	###)
207
208	def getHeadlineFields(self,headline,values): ###(
209	""" check the headline of a csv file """
210	# import_keys = [k.strip() for k in headline if not (k.strip().startswith('ignore')
211	# or k.strip() in self.info.keys())]
212	import_keys = [k.strip() for k in headline if not (k.strip() in self.info.keys())]
213	info_keys = [k.strip() for k in headline if k.strip() in self.info.keys()]
214	si = set(import_keys)
215	ss = set(self.schema.keys())
216
217	invalid_keys = si - ss
218	keys = []
219	i = 0
220	duplicates = False
221	singels = []
222	msg = ''
223	while True:
224	if len(values) != len(import_keys):
225	if len(values) == len(import_keys) + len(info_keys):
226	msg += "fields from pending file in headline"
227	else:
228	msg += "%d fields in headline but %d values" % (len(import_keys),len(values))
229	break
230	for k in import_keys:
231	if k in singels:
232	keys += (k,'%s' % k,values[i],'(duplicate)'),
233	msg += ("duplicate %s," % k)
234	keys[singels.index(k)] = (k,'%s' % k,values[singels.index(k)],'(duplicate)')
235	elif k in invalid_keys and not k.startswith(IGNORE):
236	keys += (k,NO_KEY,values[i],'(invalid)'),
237	else:
238	keys += (k,k,values[i],''),
239	i += 1
240	singels += k,
241	break
242	return msg,keys
243	###)
244	###)
245
246	class ApplicationImport(WAeUPImport):###(
247	name = "application"
248	plural_name = "%ss" % name
249	commit_after = 1000
250
251	def create(self,mapping):###(
252	reg_no = mapping.get('reg_no')
253	msg = ''
254	while True:
255	try:
256	self.applicants_catalog.addRecord(**mapping)
257	except ValueError:
258	msg = "applicant record with reg_no %s already exists" % reg_no
259	break
260	return reg_no,msg,mapping
261	###)
262
263	def edit(self,mapping):###(
264	reg_no = mapping.get('reg_no')
265	status = mapping.get('status')
266	msg = ''
267	while True:
268	res = self.applicants_catalog(reg_no = reg_no)
269	if len(res):
270	if res[0].status == 'created' and status != 'created':
271	msg = "student object with id %s for %s already created, status cannot be changed" % (res[0].student_id, reg_no)
272	elif status == 'created' and res[0].status != 'created':
273	msg = "student object for %s has not yet been created, status cannot be set to 'created'" % (reg_no)
274	else:
275	self.applicants_catalog.modifyRecord(**mapping)
276	else:
277	msg = "applicant record with reg_no %s does not exist" % reg_no
278	break
279	return reg_no,msg,mapping
280	###)
281
282	###)
283
284	class CertificateImport(WAeUPImport):###(
285	name = "certificate"
286	plural_name = "%ss" % name
287	commit_after = 100000
288
289	def create(self,mapping):###(
290	if getattr(self,'_v_certificate_list',None) is None:
291	self._v_certificate_list = []
292	if getattr(self,'_v_department_certificates',None) is None:
293	departments = self.portal_catalog(portal_type = "Department")
294	self._v_department_certificates = {}
295	for department in departments:
296	certificates_container = getattr(department.getObject(),"certificates",None)
297	self._v_department_certificates[department.getId] = {'container': certificates_container,
298	'certificates': certificates_container.objectIds(),
299	}
300	department_id = mapping['department_code']
301	msg = ''
302	certificate_id = mapping.get('code')
303	while True:
304	department_certificates = self._v_department_certificates.get(department_id,None)
305	if department_certificates is None:
306	msg = "No Department with ID: %s" % department_id
307	break
308	certificates_container = department_certificates['container']
309	certificates = department_certificates['certificates']
310	if certificate_id in self._v_certificate_list:
311	msg = "Duplicate Certificate ID: %s" % department_id
312	break
313	if certificate_id in certificates:
314	msg = "Duplicate Certificate ID: %s" % department_id
315	break
316	try:
317	certificates_container.invokeFactory('Certificate', certificate_id)
318	except BadRequest,E:
319	msg = "%s" % E
320	break
321	self._v_certificate_list.append(certificate_id)
322	certificate = getattr(certificates_container,certificate_id)
323	certificate.getContent().edit(mapping=mapping)
324	break
325	return certificate_id,msg,mapping
326	###)
327
328	def edit(self,mapping):###(
329	certificate_id = mapping.get('code')
330	res = self.portal_catalog(id=certificate_id)
331	msg = ''
332	while True:
333	if not res:
334	msg = "no certificate with id: %s" % certificate_id
335	break
336	c = res[0].getObject()
337	c.getContent().edit(mapping=mapping)
338	break
339	return certificate_id,msg,mapping
340	###)
341	###)
342
343	class CourseImport(WAeUPImport):###(
344	name = "course"
345	plural_name = "%ss" % name
346	commit_after = 1000
347
348	def create(self,mapping):###(
349	if getattr(self,'_v_course_list',None) is None:
350	self._v_course_list = []
351	if getattr(self,'_v_department_courses',None) is None:
352	departments = self.portal_catalog(portal_type = "Department")
353	self._v_department_courses = {}
354	for department in departments:
355	courses_container = getattr(department.getObject(),"courses",None)
356	if courses_container is not None:
357	self._v_department_courses[department.getId] = {'container': courses_container,
358	'courses': courses_container.objectIds(),
359	}
360	department_id = mapping['department_code']
361	course_id = mapping.get('code','')
362	msg = ''
363	while True:
364	department_courses = self._v_department_courses.get(department_id,None)
365	if department_courses is None:
366	msg = "no department with id: %(department_id)s" % vars()
367	break
368	courses_container = department_courses['container']
369	courses = department_courses['courses']
370	if course_id in self._v_course_list:
371	msg = "duplicate course id: %(course_id)s" % vars()
372	break
373	if course_id in courses:
374	msg = "course %(course_id)s already exists in department %(department_id)s" % vars()
375	break
376	try:
377	courses_container.invokeFactory('Course', course_id)
378	except BadRequest,E:
379	msg = "%s" % E
380	break
381	self._v_course_list.append(course_id)
382	course = getattr(courses_container,course_id)
383	course.getContent().edit(mapping=mapping)
384	break
385	return course_id,msg,mapping
386	###)
387
388	def edit(self,mapping): ###(
389	course_id = mapping.get('code','')
390	course = self.courses_catalog.getRecordByKey(course_id)
391	msg = ''
392	while True:
393	if course is None:
394	msg = "no course with id: %s" % course_id
395	break
396	course_object = getattr(getattr(getattr(getattr(self.academics_folder,course.faculty),
397	course.department),
398	'courses'),
399	course_id)
400	course_object.getContent().edit(mapping=mapping)
401	break
402	return course_id,msg,mapping
403	###)
404	###)
405
406	class CourseResultImport(WAeUPImport):###(
407	""" CourseresultImport """
408	name = "course_result"
409	plural_name = "%ss" % name
410	commit_after = 1000000
411	required_modes = ('create','edit','remove')
412
413	def create(self,mapping):###(
414	students_folder = self.portal_url.getPortalObject().campus.students
415	if getattr(self,'_v_courses',None) is None:
416	res = self.courses_catalog()
417	self._v_courses = {}
418	for brain in res:
419	self._v_courses[brain.code] = brain
420	if getattr(self,'_v_level_created',None) is None:
421	self._v_level_created = []
422	if getattr(self,'_v_student_study_course',None) is None:
423	self._v_student_study_course = {}
424	msg = ''
425	key = ''
426	matric_no = mapping.get('matric_no','')
427	id = mapping.get('id','')
428	while True:
429	course_id = mapping.get('code')
430	if course_id not in self._v_courses.keys():
431	msg = "no course with id: %s" % course_id
432	break
433	result = self.findStudent('create',student_id=id,matric_no=matric_no)
434	msg = result['msg']
435	if msg:
436	break
437	student_record = result['student_record']
438	student_id = mapping['student_id'] = student_record.id
439	level_id = mapping.get('level_id','')
440	code = mapping.get('code','')
441	level_ident = "%(student_id)s_%(level_id)s" % vars()
442	if level_ident not in self._v_level_created:
443	context = self._v_student_study_course.get(student_id,None)
444	if context is None:
445	try:
446	context = getattr(getattr(students_folder,
447	"%(student_id)s" % vars()),
448	'study_course')
449	self._v_student_study_course[student_id] = context
450	except:
451	msg = "could not create level %(level_id)s for %(student_id)s" % vars()
452	break
453	if level_id not in context.objectIds():
454	context.invokeFactory('StudentStudyLevel',"%(level_id)s" % vars())
455	level = getattr(context,"%(level_id)s" % vars())
456	self.portal_workflow.doActionFor(level,'open')
457	session_id = mapping.get('session_id','')
458	if session_id:
459	level.getContent().edit(mapping={'session': "%s" % session_id,})
460	self.portal_workflow.doActionFor(level,'close')
461	self._v_level_created += level_ident,
462	mapping['key'] = key = "%(student_id)s\|%(level_id)s\|%(code)s" % vars()
463	#overwrite semester and credits in create mode
464	for k in ('semester','credits',):
465	mapping[k] = getattr(self._v_courses[course_id],k)
466	try:
467	self.course_results.addRecord(**mapping)
468	except ValueError:
469	msg = "course result already exists: %s" % key
470	break
471	return key,msg,mapping
472	###)
473
474	def edit(self,mapping): ###(
475	msg = ''
476	key = ''
477	matric_no = mapping.get('matric_no','')
478	id = mapping.get('id','')
479	while True:
480	result = self.findStudent('edit',student_id=id,matric_no=matric_no)
481	msg = result['msg']
482	if msg:
483	break
484	student_record = result['student_record']
485	student_id = student_record.id
486	level_id = mapping.get('level_id','')
487	code = mapping.get('code','')
488	#code = mapping['code']
489	mapping['key'] = key = "%(student_id)s\|%(level_id)s\|%(code)s" % vars()
490	if self.course_results.getRecordByKey(key) is None:
491	msg = "no course result with key %(key)s" % vars()
492	break
493	self.course_results.modifyRecord(**mapping)
494	break
495	return key,msg,mapping
496	###)
497
498	def remove(self,mapping):###(
499	key = ''
500	msg = ''
501	matric_no = mapping.get('matric_no','')
502	id = mapping.get('id','')
503	while True:
504	result = self.findStudent('edit',student_id=id,matric_no=matric_no)
505	msg = result['msg']
506	if msg:
507	break
508	student_record = result['student_record']
509	student_id = student_record.id
510	level_id = mapping.get('level_id','')
511	code = mapping.get('code','')
512	key = "%(student_id)s\|%(level_id)s\|%(code)s" % vars()
513	if self.course_results.getRecordByKey(key) is None:
514	msg = "no course result with key %(key)s" % vars()
515	break
516	self.course_results.deleteRecord(key)
517	break
518	return key,msg,mapping
519	###)
520	###)
521
522	class CertificateCourseImport(WAeUPImport):###(
523	name = "certificate_course"
524	plural_name = "%ss" % name
525	commit_after = 100000
526	required_modes = ('create','edit')
527
528	def create(self,mapping):
529	if getattr(self,'_v_courses',None) is None:
530	res = self.courses_catalog()
531	self._v_courses= [course.code for course in res]
532	if getattr(self,'_v_ceritficates',None) is None:
533	res = self.portal_catalog(portal_type = "Certificate")
534	self._v_certificates = {}
535	for cert in res:
536	self._v_certificates[cert.getId] = cert.getObject()
537	msg = ''
538	while True:
539	certificate_course_id = mapping.get('code')
540	if certificate_course_id not in self._v_courses:
541	msg = "no course with id: %s" % certificate_course_id
542	break
543	cert_id = mapping['certificate_code']
544	cert = self._v_certificates.get(cert_id,None)
545	if cert is None:
546	msg = "no certificate with id: %s" % cert_id
547	break
548	level_id = mapping.get('level')
549	level = getattr(cert,level_id,None)
550	if level is None:
551	cert.invokeFactory('StudyLevel', level_id)
552	level = getattr(cert,level_id,None)
553	elif hasattr(level,certificate_course_id):
554	msg = "duplicate certificate course id: %(certificate_course_id)s " % vars()
555	msg += "in %(cert_id)s/ %(level_id)s" % vars()
556	break
557	level.invokeFactory('CertificateCourse', certificate_course_id)
558	c = getattr(level,certificate_course_id)
559	c.getContent().edit(mapping=mapping)
560	break
561	return certificate_course_id,msg,mapping
562	###)
563
564	class DepartmentImport(WAeUPImport):###(
565	name = "department"
566	plural_name = "%ss" % name
567	commit_after = 1000
568
569	def create(self,mapping):###(
570	"create a department in the correct faculty"
571	faculty_id = mapping['faculty_code']
572	msg = ''
573	if getattr(self,'_v_faculties',None) is None:
574	res = self.portal_catalog(portal_type = "Faculty")
575	self._v_faculties = {}
576	for f in res:
577	self._v_faculties[f.getId] = f.getObject()
578	department_id = mapping.get('code','')
579	while True:
580	faculty = self._v_faculties.get(faculty_id,None)
581	if faculty is None:
582	msg = "no faculty with id: %s" % faculty_id
583	break
584	else:
585	d = getattr(faculty,department_id,None)
586	if d is None or d.portal_type == "Faculty":
587	try:
588	faculty.invokeFactory('Department', department_id)
589	except BadRequest,E:
590	msg = "%s" % E
591	break
592	d = getattr(faculty,department_id)
593	d.invokeFactory('CoursesFolder','courses')
594	courses = getattr(d,'courses')
595	dict = {'Title': 'Courses'}
596	courses.getContent().edit(mapping=dict)
597	d.invokeFactory('CertificatesFolder','certificates')
598	certificates = getattr(d,'certificates')
599	dict = {'Title': 'Certificates'}
600	certificates.getContent().edit(mapping=dict)
601	d.getContent().edit(mapping=mapping)
602	break
603	return department_id,msg,mapping
604	###)
605
606	def edit(self,mapping): ###(
607	"edit a department in the correct faculty"
608	academics_folder = self.portal_url.getPortalObject().campus.academics
609	faculty_id = mapping['faculty_code']
610	department_id = mapping.get('code','')
611	msg = ''
612	while True:
613	try:
614	d = getattr(getattr(academics_folder,faculty_id),department_id,None)
615	except KeyError:
616	msg = "department %s or faculty %s wrong" % (department_id,faculty_id)
617	break
618	if d is None or d.portal_type == "Faculty":
619	msg = "department %s not found" % (department_id)
620	break
621	d.getContent().edit(mapping=mapping)
622	break
623	return department_id,msg,mapping
624	###)
625	###)
626
627	class FacultyImport(WAeUPImport):###(
628	name = "faculty"
629	plural_name = "faculties"
630	commit_after = 100
631
632
633	def create(self,mapping): ###(
634	"create a faculty"
635	academics_folder = self.portal_url.getPortalObject().campus.academics
636	faculty_id = mapping.get('code','')
637	msg = ''
638	while True:
639	if faculty_id in academics_folder.objectIds():
640	msg = "faculty with id: %s exists" % faculty_id
641	break
642	try:
643	academics_folder.invokeFactory('Faculty', faculty_id)
644	except BadRequest,E:
645	msg = "%s" % E
646	break
647	f = getattr(academics_folder,faculty_id,None)
648	f.getContent().edit(mapping=mapping)
649	break
650	return faculty_id,msg,mapping
651	###)
652
653	def edit(self,mapping): ###(
654	"edit a faculty"
655	academics_folder = self.portal_url.getPortalObject().campus.academics
656	faculty_id = mapping['code']
657	msg = ''
658	while True:
659	f = getattr(academics_folder,faculty_id,None)
660	if f is None:
661	msg = "faculty with id: %s does not exist" % faculty_id
662	f.getContent().edit(mapping=mapping)
663	break
664	return faculty_id,msg,mapping
665	###)
666	###)
667
668	class StudentImport(WAeUPImport):###(
669	name = "student"
670	plural_name = "%ss" % name
671	commit_after = 100
672
673	field2types_student = { ###(
674	'StudentApplication':
675	{'id': 'application',
676	#'title': 'Application Data',
677	'wf_transition_return': 'close',
678	'wf_transition_admit': 'remain',
679	'fields':
680	('jamb_reg_no',
681	'entry_mode',
682	'entry_session',
683	'jamb_score',
684	'app_email',
685	'jamb_age',
686	'jamb_state',
687	'jamb_lga',
688	'jamb_sex',
689	)
690	},
691	#'StudentPume':
692	# {'id': 'pume',
693	# 'title': 'Pume Data',
694	# 'wf_transition_return': 'close',
695	# 'wf_transition_admit': 'close',
696	# 'fields':
697	# ('pume_score',
698	# )
699	# },
700	'StudentClearance':
701	{'id': 'clearance',
702	#'title': 'Clearance/Eligibility Record',
703	'wf_transition_return': 'close',
704	'wf_transition_admit': 'remain',
705	'fields':
706	('matric_no',
707	'nationality',
708	'lga',
709	'birthday',
710	)
711	},
712	'StudentPersonal':
713	{'id': 'personal',
714	#'title': 'Personal Data',
715	'wf_transition_return': 'open',
716	'wf_transition_admit': 'remain',
717	'fields':
718	('firstname',
719	'middlename',
720	'lastname',
721	'sex',
722	'email',
723	'phone',
724	'perm_address',
725	)
726	},
727	'StudentStudyCourse':
728	{'id': 'study_course',
729	#'title': 'Study Course',
730	'wf_transition_return': 'open',
731	'wf_transition_admit': 'remain',
732	'fields':
733	('study_course',
734	'current_level',
735	'current_session',
736	'current_mode',
737	'current_verdict',
738	'previous_verdict',
739	)
740	},
741	# 'StudentStudyLevel':
742	# {'id': 'current_level',
743	# 'title': '',
744	# 'wf_transition_return': 'open',
745	# 'wf_transition_admit': 'remain',
746	# 'fields':
747	# ('verdict',
748	# 'session',
749	# )
750	# },
751	'PaymentsFolder':
752	{'id': 'payments',
753	#'title': 'Payments',
754	'wf_transition_return': 'open',
755	'wf_transition_admit': 'open',
756	'fields':
757	()
758	},
759	}
760	###)
761
762	def create(self,mapping): ###(
763	"create student records due import"
764	logger = logging.getLogger('WAeUPTool.mass_create_student')
765	students_folder = self.portal_url.getPortalObject().campus.students
766	jamb_reg_no = mapping.get('jamb_reg_no',None)
767	matric_no = mapping.get('matric_no',None)
768	entry_mode = mapping.get('entry_mode',None)
769	msg = ''
770	student_id = mapping.get('id',None)
771	while True:
772	if student_id:
773	msg = "student_id must not be specified in create mode"
774	break
775	if jamb_reg_no and not entry_mode == 'transfer':
776	res = self.students_catalog(jamb_reg_no = jamb_reg_no)
777	if res:
778	msg = "jamb_reg_no already assigned to student %s" % res[0].id
779	break
780	if matric_no:
781	res = self.students_catalog(matric_no = matric_no)
782	if res:
783	msg = "matric_no already assigned to student %s" % res[0].id
784	break
785	if not matric_no and not jamb_reg_no:
786	msg = "jamb_reg_no or matric_no must be specified"
787	break
788	student_id = self.waeup_tool.generateStudentId('?')
789	students_folder.invokeFactory('Student', student_id)
790	student_obj = getattr(students_folder,student_id)
791	f2t = self.field2types_student
792	d = {}
793	transition = mapping.get('reg_transition','admit')
794	if transition not in ('admit','return'):
795	msg = "no valid transition provided"
796	break
797	for pt in f2t.keys():
798	student_obj.invokeFactory(pt,f2t[pt]['id'])
799	sub_obj = getattr(student_obj,f2t[pt]['id'])
800	sub_doc = sub_obj.getContent()
801	#d['Title'] = f2t[pt]['title']
802	for field in f2t[pt]['fields']:
803	d[field] = mapping.get(field,'')
804
805	if pt == "StudentApplication":
806	#d['jamb_sex'] = 'M'
807	#if mapping.get('sex'):
808	# d['jamb_sex'] = 'F'
809	d['jamb_firstname'] = mapping.get('firstname',None)
810	d['jamb_middlename'] = mapping.get('middlename',None)
811	d['jamb_lastname'] = mapping.get('lastname',None)
812
813	# if pt == "StudyCourse":
814	# for von,zu in (('entry_mode','current_mode'),
815	# ('entry_session','current_session')):
816	# if mapping.get(zu,None) is None and mapping.get(von,None) is not None:
817	# d[zu] = mapping[von]
818	sub_doc.edit(mapping = d)
819
820	#import pdb;pdb.set_trace()
821	new_state = f2t[pt]['wf_transition_%(transition)s' % vars()]
822	if new_state != "remain":
823	self.portal_workflow.doActionFor(sub_obj,new_state,dest_container=sub_obj)
824	self.portal_workflow.doActionFor(student_obj,transition)
825	student_obj.manage_setLocalRoles(student_id, ['Owner',])
826	mapping['id'] = student_id
827	break
828	return student_id,msg,mapping
829	###)
830
831	def edit(self,mapping): ###(
832	"edit student records due import"
833	wftool = self.portal_workflow
834	logger = logging.getLogger('WAeUPTool.mass_edit_student')
835	students_folder = self.portal_url.getPortalObject().campus.students
836	student_id = mapping.get('id',None)
837	jamb_reg_no = mapping.get('jamb_reg_no',None)
838	matric_no = mapping.get('matric_no',None)
839	editable_keys = mapping.keys()
840	msg = ''
841	while True:
842	if student_id:
843	res = self.students_catalog(id = student_id)
844	if not res:
845	msg = "no student with id %s" % student_id
846	break
847	student_record = res[0]
848	if matric_no and student_record.matric_no:
849	if matric_no != student_record.matric_no and not matric_no == 'transferred':
850	res = self.students_catalog(matric_no = matric_no)
851	if res:
852	msg = "matric_no already assigned to student %s" % res[0].id
853	break
854	msg = "old matric_no %s overwritten with %s" % (student_record.matric_no,matric_no)
855	#logger.info("%s, old matric_no %s overwritten with %s" % (student_record.id,student_record.matric_no,matric_no))
856	if jamb_reg_no and student_record.jamb_reg_no:
857	if jamb_reg_no != student_record.jamb_reg_no:
858	res = self.students_catalog(jamb_reg_no = jamb_reg_no)
859	if res:
860	msg = "jamb_reg_no already assigned to student %s" % res[0].id
861	break
862	msg = "old jamb_reg_no %s overwritten with %s" % (student_record.jamb_reg_no,jamb_reg_no)
863	#logger.info("%s, old reg_no %s overwritten with %s" % (student_record.id,student_record.jamb_reg_no,jamb_reg_no))
864	elif jamb_reg_no:
865	res = self.students_catalog(jamb_reg_no = jamb_reg_no)
866	if not res:
867	msg = "no student with jamb_reg_no %s" % jamb_reg_no
868	break
869	student_record = res[0]
870	editable_keys.remove('jamb_reg_no')
871	elif matric_no:
872	res = self.students_catalog(matric_no = matric_no)
873	if not res:
874	msg = "no student with matric_no %s" % matric_no
875	break
876	student_record = res[0]
877	editable_keys.remove('matric_no')
878	## included only to change wf state from admitted to returning
879	#if student_record.review_state not in ('admitted','objection_raised'):
880	# return '%s' % student_record.id ,"student is not in state admitted or objection_raised"
881	## end inclusion
882	student_id = student_record.id
883	student_obj = getattr(students_folder,student_id)
884	f2t = self.field2types_student
885	d = {}
886	any_change = False
887	#special treatment for StudentStudyLevel
888	d['verdict'] = mapping.get('current_verdict','')
889	d['session'] = mapping.get('current_session','')
890	current_level = mapping.get('current_level','')
891	while d['session'] and d['verdict'] and current_level:
892	sub_obj = getattr(student_obj,'study_course',None)
893	if sub_obj is None:
894	break
895	level_obj = getattr(sub_obj,current_level,None)
896	if level_obj is None:
897	break
898	any_change = True
899	level_obj.getContent().edit(mapping = d)
900	try:
901	wftool.doActionFor(level_obj,'close')
902	except:
903	pass
904	break
905	for pt in f2t.keys():
906	#if pt == "StudentApplication":
907	# d['jamb_sex'] = 'M'
908	# if mapping.get('sex'):
909	# d['jamb_sex'] = 'F'
910	intersect = set(f2t[pt]['fields']).intersection(set(editable_keys))
911	if intersect and pt not in ('StudentStudyLevel',):
912	object_id = f2t[pt]['id']
913	sub_obj = getattr(student_obj,object_id,None)
914	if sub_obj is None:
915	try:
916	student_obj.invokeFactory(pt,object_id)
917	except:
918	continue
919	sub_obj = getattr(student_obj,object_id)
920	#if f2t[pt]['title'] != '':
921	# d['Title'] = f2t[pt]['title']
922	sub_doc = sub_obj.getContent()
923	for field in intersect:
924	changed = False
925	if getattr(sub_doc,field,None) != mapping.get(field,''):
926	any_change = True
927	changed = True
928	d[field] = mapping.get(field,'')
929	if changed:
930	sub_doc.edit(mapping = d)
931	## included only to change wf state from admitted to returning
932	# if student_record.review_state in ('admitted','objection_raised'):
933	# new_state = f2t[pt]['wf_transition_return']
934	# sub_obj = getattr(student_obj,f2t[pt]['id'],None)
935	# if sub_obj and new_state != "remain":
936	# try:
937	# self.portal_workflow.doActionFor(sub_obj,new_state,dest_container=sub_obj)
938	# except:
939	# #logger.info('%s, wf transition %s of %s failed' % (student_id,new_state,sub_obj.id))
940	# pass
941	#if student_record.review_state in ('admitted','objection_raised'):
942	# wfaction = 'return'
943	# try:
944	# self.portal_workflow.doActionFor(student_obj,wfaction)
945	# logger.info('%s, wf state changed' % student_id)
946	# any_change = True
947	# except:
948	# logger.info('%s, wf transition failed, old state = %s' % (student_id,student_record.review_state))
949	# pass
950	## end inclusion
951	break
952	# if not any_change:
953	# msg = 'not modified'
954	return student_id,msg,mapping
955	###)
956	###)
957
958	class StudentStudyLevelImport(WAeUPImport):###(
959	""" StudentStudyLevelImport """
960	name = "student_study_level"
961	plural_name = "%ss" % name
962	commit_after = 1000000
963	required_modes = ('create',)
964
965	def create(self,mapping): ###(
966	"edit student levels and create StudentStudyLevel object if not existent"
967	wftool = self.portal_workflow
968	logger = logging.getLogger('WAeUPTool.mass_create_level')
969	students_folder = self.portal_url.getPortalObject().campus.students
970	student_id = mapping.get('id',None)
971	matric_no = mapping.get('matric_no',None)
972	editable_keys = mapping.keys()
973	key = ''
974	msg = ''
975	while True:
976	result = self.findStudent('create',student_id=student_id,matric_no=matric_no)
977	msg = result['msg']
978	if msg:
979	break
980	student_record = result['student_record']
981	student_id = student_record.id
982	mapping['id'] = student_id
983	session = mapping.get('session','')
984	level = key = mapping.get('code','')
985	if not level.isdigit():
986	msg = 'student %s: imported level is empty' % (student_id,)
987	break
988	study_course_obj = getattr(getattr(students_folder,student_id),'study_course',None)
989	if study_course_obj is None:
990	msg = 'student %s: no study_course object' % student_id
991	break
992	level_obj = getattr(study_course_obj,level,None)
993	if level_obj is None:
994	# The only difference to the edit method is that we create a StudentStudyLevel object
995	try:
996	study_course_obj.invokeFactory('StudentStudyLevel',"%s" % level)
997	level_obj = getattr(context,"%s" % level)
998	except:
999	continue
1000	level_obj.getContent().edit(mapping = mapping)
1001	level_review_state = wftool.getInfoFor(level_obj,'review_state',None)
1002	if level_review_state != "closed":
1003	wftool.doActionFor(level_obj,'close')
1004	break
1005	return key,msg,mapping
1006	###)
1007
1008	def edit(self,mapping): ###(
1009	"edit student levels"
1010	wftool = self.portal_workflow
1011	logger = logging.getLogger('WAeUPTool.mass_edit_level')
1012	students_folder = self.portal_url.getPortalObject().campus.students
1013	student_id = mapping.get('id',None)
1014	matric_no = mapping.get('matric_no',None)
1015	key = ''
1016	msg = ''
1017	while True:
1018	result = self.findStudent('create',student_id=student_id,matric_no=matric_no)
1019	msg = result['msg']
1020	if msg:
1021	break
1022	student_record = result['student_record']
1023	student_id = student_record.id
1024	mapping['id'] = student_id
1025	session = mapping.get('session','')
1026	level = key = mapping.get('code','')
1027	#import pdb;pdb.set_trace()
1028	if not level.isdigit():
1029	msg = 'student %s: imported level is empty' % (student_id,)
1030	break
1031	study_course_obj = getattr(getattr(students_folder,student_id),'study_course',None)
1032	if study_course_obj is None:
1033	msg = 'student %s: no study_course object' % student_id
1034	break
1035	level_obj = getattr(study_course_obj,level,None)
1036	if level_obj is None:
1037	msg = 'student %s: no study_level object for level %s' % (student_id,level)
1038	break
1039	level_obj.getContent().edit(mapping = mapping)
1040	break
1041	return key,msg,mapping
1042	###)
1043	###)
1044
1045	class VerdictImport(WAeUPImport):###(
1046	""" VerdictImport """
1047	name = "verdict"
1048	plural_name = "%ss" % name
1049	commit_after = 100000
1050	required_modes = ('create','edit')
1051
1052	def create(self,mapping): ###(
1053	"edit student verdicts and create StudentStudyLevel object if not existent"
1054	wftool = self.portal_workflow
1055	logger = logging.getLogger('WAeUPTool.mass_edit_verdict')
1056	students_folder = self.portal_url.getPortalObject().campus.students
1057	student_id = mapping.get('id',None)
1058	matric_no = mapping.get('matric_no',None)
1059	editable_keys = mapping.keys()
1060	key = ''
1061	while True:
1062	result = self.findStudent('create',student_id=student_id,matric_no=matric_no)
1063	#student_record,msg = self.getStudentRecord(mapping)
1064	msg = result['msg']
1065	if msg:
1066	break
1067	student_record = result['student_record']
1068	student_id = student_record.id
1069	mapping['id'] = student_id
1070	d = {}
1071	#import pdb;pdb.set_trace()
1072	any_change = False
1073	#special treatment for StudentStudyLevel
1074	current_session = d['session'] = mapping.get('current_session','')
1075	if current_session and student_record.session != current_session:
1076	msg = 'student %s: imported session %s does not match current_session %s' % (student_id,
1077	current_session,
1078	student_record.session)
1079	break
1080	current_level = mapping.get('current_level','')
1081	if not current_level.isdigit():
1082	msg = 'student %s: imported level is empty' % (student_id,)
1083	break
1084	if current_level and student_record.level != current_level:
1085	msg = 'student %s: imported level %s does not match current_level %s' % (student_id,
1086	current_level,
1087	student_record.level)
1088	break
1089	student_review_state = student_record.review_state
1090	if student_review_state == 'deactivated':
1091	msg = "student %s in review_state %s" % (student_id, student_review_state)
1092	break
1093	if student_review_state not in ('courses_validated','returning'):
1094	msg = "student %s in wrong review_state %s" % (student_id, student_review_state)
1095	break
1096	student_obj = getattr(students_folder,student_id)
1097	# f2t = self.field2types_student
1098	study_course_obj = getattr(student_obj,'study_course',None)
1099	if study_course_obj is None:
1100	msg = 'student %s: no study_course object' % student_id
1101	break
1102	level_obj = getattr(study_course_obj,current_level,None)
1103
1104	if level_obj is None:
1105	# The only difference to the edit method is that we create a StudentStudyLevel object
1106	try:
1107	study_course_obj.invokeFactory('StudentStudyLevel',"%s" % current_level)
1108	level_obj = getattr(context,"%s" % current_level)
1109	level_obj.portal_workflow.doActionFor(level,'open')
1110	except:
1111	continue
1112	#msg = 'student %s: no study_level object for level %s' % (student_id,
1113	# current_level)
1114	#break
1115
1116	verdict = d['verdict'] = d['current_verdict'] = mapping.get('current_verdict','')
1117
1118	#if verdict == student_record.verdict:
1119	# msg = 'student %s: verdict already set to %s' % (student_id,
1120	# verdict)
1121
1122	level_review_state = wftool.getInfoFor(level_obj,'review_state',None)
1123	if level_review_state != "closed":
1124	wftool.doActionFor(level_obj,'close')
1125	# msg = 'student %s: level %s is not closed' % (student_id,
1126	# current_level)
1127
1128	study_course_obj.getContent().edit(mapping = d)
1129	level_obj.getContent().edit(mapping = d)
1130	if student_review_state != "returning":
1131	wftool.doActionFor(student_obj,'return')
1132	# try:
1133	# wftool.doActionFor(level_obj,'close')
1134	# except:
1135	# pass
1136	break
1137	return student_id,msg,mapping
1138	###)
1139
1140
1141	def edit(self,mapping): ###(
1142	"edit student verdicts"
1143	wftool = self.portal_workflow
1144	logger = logging.getLogger('WAeUPTool.mass_edit_verdict')
1145	students_folder = self.portal_url.getPortalObject().campus.students
1146	student_id = mapping.get('id',None)
1147	matric_no = mapping.get('matric_no',None)
1148	editable_keys = mapping.keys()
1149	key = ''
1150	while True:
1151	result = self.findStudent('edit',student_id=student_id,matric_no=matric_no)
1152	#student_record,msg = self.getStudentRecord(mapping)
1153	msg = result['msg']
1154	if msg:
1155	break
1156	student_record = result['student_record']
1157	key_used = result['key_used']
1158	if key_used in editable_keys:
1159	editable_keys.remove(key_used)
1160	student_id = student_record.id
1161	mapping['id'] = student_id
1162	d = {}
1163	#import pdb;pdb.set_trace()
1164	any_change = False
1165	#special treatment for StudentStudyLevel
1166	current_session = d['session'] = mapping.get('current_session','')
1167	if current_session and student_record.session != current_session:
1168	msg = 'student %s: imported session %s does not match current_session %s' % (student_id,
1169	current_session,
1170	student_record.session)
1171	break
1172	current_level = mapping.get('current_level','')
1173	if not current_level.isdigit():
1174	msg = 'student %s: imported level is empty' % (student_id,)
1175	break
1176	if current_level and student_record.level != current_level:
1177	msg = 'student %s: imported level %s does not match current_level %s' % (student_id,
1178	current_level,
1179	student_record.level)
1180	break
1181	student_review_state = student_record.review_state
1182	if student_review_state == 'deactivated':
1183	msg = "student %s in review_state %s" % (student_id, student_review_state)
1184	break
1185	if student_review_state not in ('courses_validated','returning'):
1186	msg = "student %s in wrong review_state %s" % (student_id, student_review_state)
1187	break
1188	student_obj = getattr(students_folder,student_id)
1189	# f2t = self.field2types_student
1190	study_course_obj = getattr(student_obj,'study_course',None)
1191	if study_course_obj is None:
1192	msg = 'student %s: no study_course object' % student_id
1193	break
1194	level_obj = getattr(study_course_obj,current_level,None)
1195	if level_obj is None:
1196	msg = 'student %s: no study_level object for level %s' % (student_id,
1197	current_level)
1198	break
1199	verdict = d['verdict'] = d['current_verdict'] = mapping.get('current_verdict','')
1200
1201	#if verdict == student_record.verdict:
1202	# msg = 'student %s: verdict already set to %s' % (student_id,
1203	# verdict)
1204
1205	level_review_state = wftool.getInfoFor(level_obj,'review_state',None)
1206	if level_review_state != "closed":
1207	wftool.doActionFor(level_obj,'close')
1208	# msg = 'student %s: level %s is not closed' % (student_id,
1209	# current_level)
1210
1211	study_course_obj.getContent().edit(mapping = d)
1212	level_obj.getContent().edit(mapping = d)
1213	if student_review_state != "returning":
1214	wftool.doActionFor(student_obj,'return')
1215	# try:
1216	# wftool.doActionFor(level_obj,'close')
1217	# except:
1218	# pass
1219	break
1220	return student_id,msg,mapping
1221	###)
1222
1223	def edit_old(self,mapping): ###(
1224	"edit student verdicts"
1225	wftool = self.portal_workflow
1226	logger = logging.getLogger('WAeUPTool.mass_edit_verdict')
1227	students_folder = self.portal_url.getPortalObject().campus.students
1228	student_id = mapping.get('id',None)
1229	matric_no = mapping.get('matric_no',None)
1230	editable_keys = mapping.keys()
1231	key = ''
1232	while True:
1233	msg = ''
1234	if student_id:
1235	student_record = self.students_catalog.getRecordByKey(student_id)
1236	if student_record is None:
1237	#return '',"no student with id %s" % student_id
1238	msg = "no student with id %s" % student_id
1239	break
1240	if matric_no and student_record.matric_no and matric_no != student_record.matric_no:
1241	msg = 'student %s: matric_no %s does not match %s' % (student_record.id,
1242	student_record.matric_no,
1243	matric_no)
1244	break
1245	mapping['matric_no'] = student_record.matric_no
1246	elif matric_no:
1247	res = self.students_catalog(matric_no = matric_no)
1248	if not res:
1249	msg = "no student with matric_no %s" % matric_no
1250	break
1251	student_record = res[0]
1252	editable_keys.remove('matric_no')
1253	else:
1254	msg = "no id or matric_no specified"
1255	break
1256	student_id = student_record.id
1257	mapping['id'] = student_id
1258	d = {}
1259	#import pdb;pdb.set_trace()
1260	any_change = False
1261	#special treatment for StudentStudyLevel
1262	current_session = d['session'] = mapping.get('current_session','')
1263	if current_session and student_record.session != current_session:
1264	msg = 'student %s: imported session %s does not match current_session %s' % (student_id,
1265	current_session,
1266	student_record.session)
1267	break
1268	current_level = mapping.get('current_level','')
1269	if not current_level.isdigit():
1270	msg = 'student %s: imported level is empty' % (student_id,)
1271	break
1272	if current_level and student_record.level != current_level:
1273	msg = 'student %s: imported level %s does not match current_level %s' % (student_id,
1274	current_level,
1275	student_record.level)
1276	break
1277	student_review_state = student_record.review_state
1278	if student_review_state == 'deactivated':
1279	msg = "student %s in review_state %s" % (student_id, student_review_state)
1280	break
1281	if student_review_state not in ('courses_validated','returning'):
1282	msg = "student %s in wrong review_state %s" % (student_id, student_review_state)
1283	break
1284	student_obj = getattr(students_folder,student_id)
1285	# f2t = self.field2types_student
1286	study_course_obj = getattr(student_obj,'study_course',None)
1287	if study_course_obj is None:
1288	msg = 'student %s: no study_course object' % student_id
1289	break
1290	level_obj = getattr(study_course_obj,current_level,None)
1291	if level_obj is None:
1292	msg = 'student %s: no study_level object for level %s' % (student_id,
1293	current_level)
1294	break
1295	verdict = d['verdict'] = d['current_verdict'] = mapping.get('current_verdict','')
1296
1297	#if verdict == student_record.verdict:
1298	# msg = 'student %s: verdict already set to %s' % (student_id,
1299	# verdict)
1300
1301	level_review_state = wftool.getInfoFor(level_obj,'review_state',None)
1302	if level_review_state != "closed":
1303	wftool.doActionFor(level_obj,'close')
1304	# msg = 'student %s: level %s is not closed' % (student_id,
1305	# current_level)
1306
1307	study_course_obj.getContent().edit(mapping = d)
1308	level_obj.getContent().edit(mapping = d)
1309	if student_review_state != "returning":
1310	wftool.doActionFor(student_obj,'return')
1311	# try:
1312	# wftool.doActionFor(level_obj,'close')
1313	# except:
1314	# pass
1315	break
1316	return student_id,msg,mapping
1317	###)
1318	###)

Note: See TracBrowser for help on using the repository browser.

Download in other formats: