source: main/waeup.kofa/trunk/src/waeup/kofa/doctests/pages.txt @ 14395

Last change on this file since 14395 was 13657, checked in by uli, 9 years ago

Merge changes from branch uli-upgrade-dependencies back into trunk.

These changes replace the old bootstrap.py script with a more recent version.

Apart from that only some testing packages have been upgraded, to get a
minimal set of changes.

Tests with existing instances and docker succeeded when done in a fresh
virtualenv. That means, that for existing instances it might be neccessary
to create a new virtualenv and to run bootstrap.py and buildout from
this new virtualenv afterwards.

File size: 44.4 KB
RevLine 
[7819]1Browsing Kofa
[7321]2*************
[6607]3
[12912]4Here we visit parts of a Kofa portal using a browser.
[6607]5
6University
7==========
8
9We can watch universities in the browser.
10
11We create an university object and put into the ZODB root::
12
13  >>> root = getRootFolder()
14  >>> list(root)
15  []
16
[7811]17  >>> from waeup.kofa.app import University
[6607]18  >>> u = University()
19  >>> root['myuniversity'] = u
20  >>> list(root)
21  [u'myuniversity']
22
23  >>> from zope.component.hooks import setSite
24  >>> setSite(root['myuniversity'])
25
[6609]26To make sure, we can 'watch' pages, we first have to initialize out
27test browser::
28
29  >>> from zope.testbrowser.testing import Browser
30  >>> browser = Browser()
31
[11254]32Let's get the default view of a university::
[6607]33
34  >>> browser.open('http://localhost/myuniversity')
35  >>> print browser.contents
36  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7819]37  ...Welcome to WAeUP.Kofa...
[6607]38  ...
39
[7674]40We can change to German::
[12912]41
[7674]42  >>> browser.getLink('de').click()
43  >>> print browser.contents
44  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
45  ...Anfragen...
46  ...
47
48And then change back to English by clicking on the third link containing 'en'
49behind 'Anfragen' and 'Einloggen'::
[12912]50
[7674]51  >>> browser.getLink('en', index=2).click()
52  >>> print browser.contents
53  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
54  ...Enquiries...
55  ...
56
[6609]57The contact form for anonymous users is called 'Enquiries'::
[6607]58
[6609]59  >>> browser.open('http://localhost/myuniversity')
60  >>> browser.getLink('Enquiries').click()
[7225]61  >>> browser.getControl('Send').click()
[6609]62  >>> print browser.contents
63  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7234]64  ...Required input is missing...
[6609]65  ...
66
[7225]67  >>> browser.getControl(name='form.fullname').value = "Bob Tester"
68  >>> browser.getControl(name='form.email_from').value = "xx@yy.zz"
[7401]69  >>> browser.getControl(name='form.body').value = u'test message'
[7225]70  >>> browser.getControl('Send').click()
[6611]71  >>> print browser.contents
72  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]73  ...Your message has been sent...
[6611]74  ...
75
[8364]76Registered users with an email address can request a password change:
77
78  >>> root['myuniversity']['users'].addUser('forgetful', 'secret',title='Bob Forgetful',
79  ...                               description='A forgetful user', email='aa@aa.ng')
[8777]80  >>> browser.open('http://localhost/myuniversity/changepw')
[8364]81  >>> browser.getControl(name="form.identifier").value = 'forgetful'
82  >>> browser.getControl(name="form.email").value = 'aa@aa.ng'
[9178]83  >>> browser.getControl("Send login credentials").click()
[8364]84  >>> print browser.contents
85  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
86  ...An email with your user name and password has been sent to aa@aa.ng...
87
[6609]88Now we login as manager::
89
90  >>> browser.addHeader('Authorization', 'Basic mgr:mgrpw')
91  >>> browser.handleErrors = False
92
[6907]93We can then get an edit view of the configuration container::
[6609]94
[6907]95  >>> browser.open('http://localhost/myuniversity/configuration')
[6607]96  >>> print browser.contents
97  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[6907]98  ...<form action="http://localhost/myuniversity/configuration/@@index"
[6607]99  ...
100
101The edit form contains the default value for the university name::
102
103  >>> 'Sample University' in browser.contents
104  True
[7208]105
[6607]106We can perform several actions on the edit form::
107
108  >>> browser.getControl("Save", index=0).click()
109  >>> print browser.contents
110  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[8739]111  ...Form has been saved...
[6607]112  ...
113
[6907]114  >>> browser.open('http://localhost/myuniversity/configuration')
[6607]115  >>> browser.getControl("Update plugins").click()
116  >>> print browser.contents
117  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]118  ...Plugins were updated. See log file for details...
[6607]119  ...
120
[8364]121The default frontpage HTML has been saved in a dictionary
[7704]122and is properly rendered on the frontpage of the portal:
123
124  >>> browser.open('http://localhost/myuniversity')
125  >>> print browser.contents
126  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[8364]127  ...<h1>Welcome to WAeUP.Kofa...</h1>
[7704]128  ...
129
130The German part is really not being rendered:
131
132  >>> 'Willkommen' in browser.contents
133  False
134
135
136If we change to German so that the German part of frontpage.rst is rendered:
137
138  >>> browser.open('http://localhost/myuniversity//@@change_language?lang=de')
139  >>> print browser.contents
140  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[8364]141  ...<h1>Willkommen auf WAeUP.Kofa...</h1>
[7704]142  ...
143
144The English part is really not being rendered:
145
146  >>> 'Welcome' in browser.contents
147  False
148
149Switch back to English:
150
151  >>> browser.open('http://localhost/myuniversity//@@change_language?lang=en')
152
[6607]153
[12912]154Officers
155========
[6607]156
157  >>> browser.open('http://localhost/myuniversity')
[12912]158  >>> browser.getLink('Officers').click()
[6607]159  >>> print browser.contents
160  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[12912]161  ...Officers...
[6607]162  ...
163
[12912]164We can add officers:
[6607]165
[12919]166  >>> browser.getLink("Add officer").click()
[6607]167  >>> browser.getControl(name="form.name").value = 'bob'
[8759]168  >>> browser.getControl(name="form.title").value = 'Bob The User'
[7149]169  >>> browser.getControl(name="password").value = 'secret'
170  >>> browser.getControl(name="control_password").value = 'secret'
[7222]171  >>> browser.getControl(name="form.email").value = 'xx@yy.zz'
[7869]172  >>> browser.getControl(name="form.phone.country").value = ['+234']
173  >>> browser.getControl(name="form.phone.area").value = '123'
174  >>> browser.getControl(name="form.phone.ext").value = '45678'
[12919]175  >>> browser.getControl("Add officer").click()
[6607]176  >>> print browser.contents
177  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
178  ...<td>bob</td>
179  ...
180
181We can edit user bob:
182
[7707]183  >>> browser.getControl("Manage", index=0).click()
[6607]184  >>> browser.getControl("Save", index=0).click()
185  >>> browser.getControl("Cancel", index=0).click()
186
[7178]187We can add site roles which are then displayed on the user container page.
188Since the test browser does not use javascript, we have to add site roles
[6607]189manually by setting the roles attribute:
190
191  >>> print root['myuniversity']['users']['bob'].roles
192  []
[7185]193  >>> root['myuniversity']['users']['bob'].roles = ['waeup.ApplicationsOfficer']
[6607]194  >>> print root['myuniversity']['users']['bob'].roles
[7185]195  ['waeup.ApplicationsOfficer']
[6607]196  >>> browser.open('http://localhost/myuniversity/users')
197  >>> print browser.contents
198  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[10226]199  ...<td nowrap>Applications Officer (view only) <br /></td>
[6607]200  ...
201
[12912]202Officers can't be added twice:
[6607]203
[6608]204  >>> browser.open('http://localhost/myuniversity/users/add')
205  >>> browser.getControl(name="form.name").value = 'bob'
[8759]206  >>> browser.getControl(name="form.title").value = 'Bob The User'
[7149]207  >>> browser.getControl(name="password").value = 'secret'
208  >>> browser.getControl(name="control_password").value = 'secret'
[7222]209  >>> browser.getControl(name="form.email").value = 'xx@yy.zz'
[7869]210  >>> browser.getControl(name="form.phone.country").value = ['+234']
211  >>> browser.getControl(name="form.phone.area").value = '123'
212  >>> browser.getControl(name="form.phone.ext").value = '45678'
[12919]213  >>> browser.getControl("Add officer").click()
[6608]214  >>> 'The userid chosen already exists' in browser.contents
215  True
216
[12912]217Officers can be deleted:
[6608]218
219  >>> browser.open('http://localhost/myuniversity/users')
[8364]220  >>> browser.getControl("Remove", index=0).click()
[7657]221  >>> 'User account bob successfully deleted' in browser.contents
[6608]222  True
223
224
[8364]225
[6607]226Contact Form
227============
228
229Let's enter the contact form::
230
231  >>> browser.open('http://localhost/myuniversity/contactadmin')
232  >>> print browser.contents
233  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[6647]234  ...Contact
[6607]235  ...
236
[7234]237We fill the form  (this will send a real message to
238contact@waeup.org)::
[6607]239
240  >>> browser.open('http://localhost/myuniversity/contactadmin')
[7225]241  >>> browser.getControl(name='form.body').value = "test message"
242  >>> browser.getControl('Send').click()
[7208]243  >>> print browser.contents
[6607]244  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]245  ...Your message has been sent...
[6607]246  ...
247
[7234]248If this test fails, chances are, that the local machine has no SMTP
249server installed.
[6607]250
251
[7234]252
[6607]253Faculties
254=========
255
256Faculties are stored in a special container of `IUniversity`
257instances. The container is called ``faculties`` and provides an
258add-form to add new faculties::
259
[6611]260  >>> browser.open('http://localhost/myuniversity/faculties/manage')
261  >>> browser.getControl('Add faculty').click()
[6607]262  >>> print browser.contents
263  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]264  ...*...
[6607]265  ...<span>Name of faculty</span>:
266  ...
[6611]267  >>> browser.getControl('Cancel').click()
268  >>> browser.open('http://localhost/myuniversity/faculties/add')
[7208]269
[6607]270We fill in a new name for our new faculty::
271
272  >>> ctrl = browser.getControl(name='form.title')
273  >>> ctrl.value = 'TestFac'
274
275Furthermore we add a prefix and a code (kind of abbreviation):
276
277  >>> browser.getControl(name='form.code').value = 'TF'
278
279Finally we click on 'Add Faculty' to add the new thing::
280
281  >>> browser.getControl('Add faculty').click()
282
283We can view a faculty by browsing a URL like this::
284
285  >>> browser.open('http://localhost/myuniversity/faculties/TF')
286
287Afterwards, the faculty should be visible:
288
289  >>> browser.open('http://localhost/myuniversity/faculties')
290  >>> print browser.contents
291  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
[10207]292  ...<h1 class="kofa-content-label">Academic Section</h1>
[11254]293  ...<td> <a href="http://localhost/myuniversity/faculties/TF"> <span>TF</span></a></td>
[6607]294  ...
295
296We can 'visit' each faculty by clicking on the appropriate link:
297
298  >>> browser.getLink('TF').click()
299  >>> print browser.contents
300  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[6647]301  ...Faculty of TestFac (TF)...
[6607]302  ...
303
[6611]304If we add the same faculty twice, an error message will occur:
305
306  >>> browser.open('http://localhost/myuniversity/faculties/add')
307  >>> ctrl = browser.getControl(name='form.title')
308  >>> ctrl.value = 'TestFac'
309  >>> browser.getControl(name='form.code').value = 'TF'
310  >>> browser.getControl('Add faculty').click()
311  >>> 'The faculty code chosen already exists.' in browser.contents
312  True
313
[6607]314Modifying faculties
315-------------------
316
317A faculty can directly be reached by its code:
318
319  >>> browser.open('http://localhost/myuniversity/faculties/TF')
320
321We can change the settings for a faculty by clicking on the
322provided 'Manage  faculty' button:
323
324  >>> browser.getLink('Manage faculty').click()
325
326Let's set a new title and save the form:
327
328  >>> browser.getControl(name='form.title').value = "My renamed faculty"
329  >>> browser.getControl(name='form.actions.save').click()
330
331Our faculty was indeed renamed to ``My renamed faculty``:
332
333  >>> browser.open('http://localhost/myuniversity/faculties')
334  >>> print browser.contents
335  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[10207]336  ...<h1 class="kofa-content-label">Academic Section</h1>
[11254]337  ...<td> <a href="http://localhost/myuniversity/faculties/TF"> <span>TF</span></a></td>
[6607]338  ...<td>Faculty of My renamed faculty (TF)</td>
339  ...
340
[6608]341We can grant local roles:
[6607]342
[6608]343  >>> root['myuniversity']['users'].addUser('bob', 'secret',title='Bob',
344  ...                               description='A sample user')
345  >>> browser.open('http://localhost/myuniversity/faculties/TF/manage')
346  >>> browser.getControl(name="user").value = ['bob']
[7208]347  >>> browser.getControl(
348  ...     name="local_role").value = ['waeup.local.DepartmentManager']
[6608]349  >>> browser.getControl("Add local role").click()
350  >>> print browser.contents
351  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
352  ...<td>bob</td>
353  ...
354
[12912]355On the officers page the new local role is displayed:
[6608]356
[12912]357  >>> browser.getLink("Officers").click()
[6608]358  >>> print browser.contents
359  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7185]360  ...<td>Department Manager:...
[6608]361  ...
362
363The local role can be removed again:
364
365  >>> browser.open('http://localhost/myuniversity/faculties/TF/manage')
366  >>> ctrl = browser.getControl(name='role_id')
367  >>> browser.getControl("Remove selected local roles").click()
368  >>> print browser.contents
369  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
370  ...No local role selected...
371  ...
372
373  >>> browser.open('http://localhost/myuniversity/faculties/TF/manage')
374  >>> ctrl = browser.getControl(name='role_id')
[7185]375  >>> ctrl.getControl(value='bob|waeup.local.DepartmentManager').selected = True
[6608]376  >>> browser.getControl("Remove selected local roles").click()
377  >>> print browser.contents
378  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7700]379  ...Local role successfully removed...
[6608]380  ...
381
382Deleting faculties
383------------------
384
385  >>> browser.open('http://localhost/myuniversity/faculties/manage')
386  >>> browser.getControl('Cancel').click()
387  >>> print browser.url
388  http://localhost/myuniversity/faculties
389  >>> browser.getLink('Manage academic section').click()
390  >>> browser.getControl('Add faculty').click()
391  >>> ctrl = browser.getControl(name='form.title')
392  >>> ctrl.value = 'Second Faculty'
393  >>> browser.getControl(name='form.code').value = 'TF2'
394  >>> browser.getControl('Add faculty').click()
395  >>> browser.open('http://localhost/myuniversity/faculties/manage')
396  >>> browser.getControl("Remove selected", index=0).click()
[6917]397  >>> 'No item selected' in browser.contents
[6608]398  True
399  >>> browser.open('http://localhost/myuniversity/faculties/manage')
400  >>> ctrl = browser.getControl(name='val_id')
401  >>> ctrl.getControl(value='TF2').selected = True
402  >>> browser.getControl("Remove selected", index=0).click()
403  >>> print browser.contents
404  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
405  ...Successfully removed:...
406  ...
407
[6607]408Departments
409===========
410
411Adding departments
412------------------
413
414Departments are stored in :class:`IFaculty` instances with their code
415as key. Faculties therefore are also department containers. Faculties
416provides an add-form to add new departments:
417
418  >>> browser.open('http://localhost/myuniversity/faculties/TF/add')
419  >>> print browser.contents
420  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]421  ...*</span>
[6607]422  ...<span>Name of department</span>:
423  ...
[6611]424  >>> browser.getControl('Cancel').click()
425  >>> browser.open('http://localhost/myuniversity/faculties/TF/add')
[6607]426
427We fill in a new name for our new department:
428
429  >>> ctrl = browser.getControl(name='form.title')
430  >>> ctrl.value = 'TestDept'
431
432Furthermore we add a code (kind of abbreviation):
433
434  >>> browser.getControl(name='form.code').value = 'TD'
435
436Finally we click on 'Add Department' to add the new thing::
437
438  >>> browser.getControl('Add department').click()
439
440If we try to register a department under the same code twice we will
441get an error:
442
443  >>> browser.open('http://localhost/myuniversity/faculties/TF/add')
444  >>> ctrl = browser.getControl(name='form.title')
445  >>> ctrl.value = 'Another TestDept with same code'
446  >>> browser.getControl(name='form.code').value = 'TD'
447  >>> browser.getControl('Add department').click()
448  >>> print browser.contents
449  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]450  ...The code chosen already exists in this faculty...
[6607]451  ...
452
[6609]453We can view a department by browsing a URL like this::
[6607]454
455  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD')
456
[6609]457Afterwards, the department should be visible::
[6607]458
459  >>> browser.open('http://localhost/myuniversity/faculties/TF')
460  >>> print browser.contents
461  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[10207]462  ...<h1 class="kofa-content-label">Departments</h1>
[11254]463  ...<td> <a href="http://localhost/myuniversity/faculties/TF/TD"> <span>TD</span></a></td>
[6607]464  ...<td>Department of TestDept (TD)</td>
465  ...
466
467
468Modifying departments
469---------------------
470
471We can change the settings for a department by clicking on the
472provided 'Edit department' button:
473
474  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD')
475  >>> browser.getLink('Manage department').click()
476
477Let's set a new title and save the form:
478
479  >>> browser.getControl(name='form.title').value = "My test dept"
480  >>> browser.getControl(name='form.actions.save').click()
481
482Clicking 'Save' we will stay on the settings form. So we can change
[7208]483the department again.
[6607]484
485  >>> browser.getControl(name='form.title').value = "My renamed dept"
486  >>> ctrl = browser.getControl("Save")
487  >>> ctrl.click()
488
489
490Our department was indeed renamed to ``My renamed dept``:
491
492  >>> browser.open('http://localhost/myuniversity/faculties/TF')
493  >>> print browser.contents
494  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
[10207]495  ...<h1 class="kofa-content-label">Departments</h1>
[11254]496  ...<td> <a href="http://localhost/myuniversity/faculties/TF/TD"> <span>TD</span></a></td>
[6607]497  ...<td>Department of My renamed dept (TD)</td>
498  ...
499
[6613]500We can grant local roles:
501
502  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD/manage')
503  >>> browser.getControl(name="user").value = ['bob']
[7208]504  >>> browser.getControl(
505  ...     name="local_role").value = ['waeup.local.DepartmentManager']
[6613]506  >>> browser.getControl("Add local role").click()
507  >>> print browser.contents
508  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
509  ...<td>bob</td>
510  ...
511
512The local role can be removed again:
513
514  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD/manage')
515  >>> ctrl = browser.getControl(name='role_id')
516  >>> browser.getControl("Remove selected local roles").click()
517  >>> print browser.contents
518  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
519  ...No local role selected...
520  ...
521
522  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD/manage')
523  >>> ctrl = browser.getControl(name='role_id')
[7208]524  >>> ctrl.getControl(
525  ...     value='bob|waeup.local.DepartmentManager').selected = True
[6613]526  >>> browser.getControl("Remove selected local roles").click()
527  >>> print browser.contents
528  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7700]529  ...Local role successfully removed...
[6613]530  ...
531
[6608]532Deleting departments
533--------------------
[6607]534
[6608]535  >>> browser.open('http://localhost/myuniversity/faculties/TF/manage')
536  >>> browser.getControl('Cancel', index=0).click()
537  >>> print browser.url
538  http://localhost/myuniversity/faculties/TF
539  >>> browser.getLink('Manage faculty').click()
540  >>> browser.getControl('Add department').click()
541  >>> ctrl = browser.getControl(name='form.title')
542  >>> ctrl.value = 'Second Department'
543  >>> browser.getControl(name='form.code').value = 'TD2'
544  >>> browser.getControl('Add department').click()
545  >>> browser.open('http://localhost/myuniversity/faculties/TF/manage')
546  >>> browser.getControl("Remove selected", index=0).click()
[6917]547  >>> 'No item selected' in browser.contents
[6608]548  True
549  >>> browser.open('http://localhost/myuniversity/faculties/TF/manage')
550  >>> ctrl = browser.getControl(name='val_id')
551  >>> ctrl.getControl(value='TD2').selected = True
552  >>> browser.getControl("Remove selected", index=0).click()
553  >>> print browser.contents
554  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
555  ...Successfully removed:...
556  ...
557
558
[6607]559Courses
560=======
561
562Once we have a department, we can add courses.
563
564Adding courses
565--------------
566
[7333]567Courses are stored in :class:`ICoursesContainer` instances with their
568code as key. CoursesContainers are normally availabe as `course`
[7811]569attribute of :class:`waeup.kofa.university.department.Department`
[6607]570instances.
571
[12912]572To ease the life of officers we do not require to browse the
[7333]573coursescontainers (which have a rather flat user interface), but
[6607]574provide adding of courses in department views.
575
576Each department provides a ``Add course`` action button near top.
577
578Departments provide an add-form to add new courses:
579
580  >>> dept_url = 'http://localhost/myuniversity/faculties/TF/TD'
[6613]581  >>> browser.open(dept_url + '/manage')
582  >>> browser.getControl('Add course').click()
[6607]583  >>> print browser.contents
584  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]585  ...*</span>
[6607]586  ...<span>Title of course</span>:
587  ...
588
589We fill in a name for our new course:
590
591  >>> ctrl = browser.getControl(name='form.title')
592  >>> ctrl.value = 'My Course 1'
593
594Furthermore we add a code (kind of abbreviation):
595
596  >>> browser.getControl(name='form.code').value = 'COURSE1'
597
598This course will take place in the the first semester, so we set the
599`semester` value to 1:
600
601  >>> ctrl = browser.getControl(name='form.semester')
602  >>> ctrl.options
[7681]603  ['1', '2', '3', '9']
[6607]604
605  >>> ctrl.displayOptions
[10438]606  ['1st Semester', '2nd Semester', 'Combined', 'N/A']
[6607]607
608  >>> ctrl.value = ['1']
609
610Finally, we create the course:
611
612  >>> browser.getControl('Add course').click()
613
614If we try to register a course under the same code twice we will
615get an error:
616
617  >>> browser.open(dept_url + '/addcourse')
618  >>> ctrl = browser.getControl(name='form.title')
619  >>> ctrl.value = 'Another course with same code'
620  >>> browser.getControl(name='form.code').value = 'COURSE1'
621  >>> browser.getControl('Add course').click()
622  >>> print browser.contents
623  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]624  ...A course with same code already exists:...
[6607]625  ...
626
627Our course will be linked under the code on the department page:
628
629  >>> browser.open(dept_url)
630  >>> browser.getLink('COURSE1').click()
631  >>> browser.url
632  'http://localhost/myuniversity/faculties/TF/TD/courses/COURSE1'
633
634Before we really add a course we can cancel the action and will be
635redirected to the department page:
636
637  >>> browser.open(dept_url + '/addcourse')
638  >>> browser.getControl('Cancel').click()
639  >>> browser.url
640  'http://localhost/myuniversity/faculties/TF/TD'
641
642
643Modifying courses
644-----------------
645
646We can change the settings for a course by clicking on the provided
647'Edit settings' link:
648
649  >>> browser.open(dept_url + '/courses/COURSE1')
650  >>> browser.getLink('Edit course').click()
651
652When modifying a course, we cannot change the code any more:
653
654  >>> browser.getControl(name='form.code')
655  Traceback (most recent call last):
656  ...
657  LookupError: name 'form.code'
[13657]658  available items:
659    <TextControl(form.title=My Course 1)>
660    ...
[6607]661
[13657]662
[6607]663Let's set a new title and save the form:
664
665  >>> browser.getControl(name='form.title').value = "My test course"
666  >>> browser.getControl(name='form.actions.save').click()
667
668Clicking 'Save' we will stay on the settings form. So we can change
[7490]669the course again. If we click ``Cancel`` nothing will be
[6607]670changed:
671
672  >>> browser.getControl(name='form.title').value = "Blah"
673  >>> browser.getControl('Cancel').click()
674
[7490]675Our course was not renamed to ``Blah``:
[6607]676
677  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD')
678  >>> print browser.contents
679  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7490]680  ...<td>My test course</td>...
[6607]681  ...
682
[6608]683Searching courses
684-----------------
[6607]685
[6608]686  >>> browser.open('http://localhost/myuniversity/faculties/search')
[7490]687  >>> browser.getControl(name='query').value = "My test course"
[6608]688  >>> browser.getControl('Search').click()
689  >>> print browser.contents
690  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
691  ...faculties/TF/TD/courses/COURSE1">COURSE1</a>
692  ...
693
[7076]694  >>> browser.open('http://localhost/myuniversity/faculties/search')
695  >>> browser.getControl(name='query').value = "COURSE1"
696  >>> browser.getControl('Search').click()
697  >>> print browser.contents
698  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
699  ...faculties/TF/TD/courses/COURSE1">COURSE1</a>
700  ...
701
[6608]702  >>> browser.getControl(name='query').value = "Nonsense"
703  >>> browser.getControl('Search').click()
704  >>> 'Search Results' in browser.contents
705  False
[11794]706  >>> '<div class="alert alert-warning">No object found.</div>' in browser.contents
707  True
[6608]708
[7076]709  >>> browser.getControl(name='query').value = ""
710  >>> browser.getControl('Search').click()
711  >>> 'Empty search string' in browser.contents
712  True
713
[10540]714We can grant local roles:
715
716  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD/courses/COURSE1/manage')
717  >>> browser.getControl(name="user").value = ['bob']
718  >>> browser.getControl(
719  ...     name="local_role").value = ['waeup.local.Lecturer']
720  >>> browser.getControl("Add local role").click()
721  >>> print browser.contents
722  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
723  ...<td>bob</td>
724  ...
725
726On the portal user page the new local role is displayed:
727
[12912]728  >>> browser.getLink("Officers").click()
[10540]729  >>> print browser.contents
730  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
731  ...<td>Lecturer:...
732  ...
733
734The local role can be removed again:
735
736  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD/courses/COURSE1/manage')
737  >>> ctrl = browser.getControl(name='role_id')
738  >>> browser.getControl("Remove selected local roles").click()
739  >>> print browser.contents
740  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
741  ...No local role selected...
742  ...
743
744  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD/courses/COURSE1/manage')
745  >>> ctrl = browser.getControl(name='role_id')
746  >>> ctrl.getControl(value='bob|waeup.local.Lecturer').selected = True
747  >>> browser.getControl("Remove selected local roles").click()
748  >>> print browser.contents
749  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
750  ...Local role successfully removed...
751  ...
752
[6607]753Deleting courses
754----------------
755
[7208]756We can delete courses by browsing the manage page of the containing
757department and checking the appropriate select box and clicking the
758´´Remove selected´´ button.
[6607]759
[7208]760  >>> browser.open(
761  ...     'http://localhost/myuniversity/faculties/TF/TD/@@manage#tab-2')
[7490]762  >>> 'My test course' in browser.contents
[6607]763  True
764
[6613]765  >>> browser.getControl('Cancel', index=0).click()
766  >>> browser.getLink('Manage department').click()
767  >>> browser.getControl('Remove selected courses').click()
[6917]768  >>> 'No item selected' in browser.contents
[6613]769  True
770
[7208]771  >>> browser.getControl(
772  ...    name='val_id').getControl(value='COURSE1').selected = True
[6607]773  >>> browser.getControl('Remove selected courses').click()
774
775  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD')
776  >>> 'My renamed course' in browser.contents
777  False
778
779
[7204]780Deleting departments with courses
781---------------------------------
782
783  >>> browser.open('http://localhost/myuniversity/faculties/TF/manage')
784  >>> browser.getControl('Cancel', index=0).click()
785  >>> browser.getLink('Manage faculty').click()
786  >>> browser.getControl('Add department').click()
787  >>> ctrl = browser.getControl(name='form.title')
788  >>> ctrl.value = 'Third Department'
789  >>> browser.getControl(name='form.code').value = 'TD3'
790  >>> browser.getControl('Add department').click()
791  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD3/manage')
792  >>> browser.getControl('Add course').click()
793  >>> ctrl = browser.getControl(name='form.title')
794  >>> ctrl.value = 'My Course 5'
795  >>> browser.getControl(name='form.code').value = 'COURSE5'
796  >>> browser.getControl('Add course').click()
797  >>> browser.open('http://localhost/myuniversity/faculties/TF/manage')
798  >>> ctrl = browser.getControl(name='val_id')
799  >>> ctrl.getControl(value='TD3').selected = True
800  >>> browser.getControl("Remove selected", index=0).click()
801  >>> print browser.contents
802  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
803  ...Successfully removed:...
804  ...
805
[6607]806Certificates
807============
808
[12966]809Once we have a department, we can add also certificates.
[6607]810
811Adding certificates
812-------------------
813
[7333]814Certificates are stored in :class:`ICertificatesContainer` instances
815with their code as key. CertificatesContainers are normally availabe as
[6607]816`certificates` attribute of
[7811]817:class:`waeup.kofa.university.department.Department` instances.
[6607]818
[12912]819To ease the life of officers we do not require to browse the
[7333]820certificatescontainers (which have in fact no user interface), but
[6607]821provide adding of certificates in department views.
822
823Each department provides a ``Add certificate`` action button near top.
824
825Departments provide an add-form to add new certificates:
826
827  >>> dept_url = 'http://localhost/myuniversity/faculties/TF/TD'
[6613]828  >>> browser.open(dept_url + '/manage')
829  >>> browser.getControl('Add certificate').click()
[6607]830  >>> print browser.contents
831  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]832  ...*</span>
[6607]833  ...<span>Title</span>:
834  ...
835
836We fill in a name for our new cert:
837
838  >>> ctrl = browser.getControl(name='form.title')
839  >>> ctrl.value = 'My Certificate 1'
840
841Furthermore we add a code (kind of abbreviation):
842
843  >>> browser.getControl(name='form.code').value = 'CERT1'
844
845Set the remaining required fields:
846
[7843]847  >>> browser.getControl(name='form.study_mode').value = ['ug_ft']
[6607]848  >>> browser.getControl(name='form.start_level').value = ['100']
849  >>> browser.getControl(name='form.end_level').value = ['400']
850  >>> browser.getControl(name='form.application_category').value = ['basic']
851
852Finally, we create the certificate:
853
854  >>> browser.getControl('Add certificate').click()
855
856If we try to register a certificate under the same code twice we will
857get an error:
858
859  >>> browser.open(dept_url + '/addcertificate')
860  >>> ctrl = browser.getControl(name='form.title')
861  >>> ctrl.value = 'Another cert with same code'
862  >>> browser.getControl(name='form.code').value = 'CERT1'
[7843]863  >>> browser.getControl(name='form.study_mode').value = ['ug_ft']
[6607]864  >>> browser.getControl(name='form.start_level').value = ['100']
865  >>> browser.getControl(name='form.end_level').value = ['400']
866  >>> browser.getControl(name='form.application_category').value = ['basic']
867
868  >>> browser.getControl('Add certificate').click()
869  >>> print browser.contents
870  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]871  ...A certificate with same code already exists:...
[6607]872  ...
873
874Our certificate will be linked under the code on the department page:
875
876  >>> browser.open(dept_url)
877  >>> browser.getLink('CERT1').click()
878  >>> browser.url
879  'http://localhost/myuniversity/faculties/TF/TD/certificates/CERT1'
880
881Before we really add a certificate we can cancel the action and will be
882redirected to the department page:
883
884  >>> browser.open(dept_url + '/addcertificate')
885  >>> browser.getControl('Cancel').click()
886  >>> browser.url
887  'http://localhost/myuniversity/faculties/TF/TD'
888
889
890Modifying certificates
891----------------------
892
893We can change the settings for a cert by clicking on the provided
894'Edit certificate' link:
895
896  >>> browser.open(dept_url + '/certificates/CERT1')
897  >>> browser.getLink('Manage certificate').click()
898
899When modifying a certificate, we cannot change the code any more:
900
901  >>> browser.getControl(name='form.code')
902  Traceback (most recent call last):
903  ...
904  LookupError: name 'form.code'
[13657]905  available items:
906    <TextControl(form.title=My Certificate 1)>
907    ...
[6607]908
[13657]909
[6607]910Let's set a new title and save the form:
911
912  >>> browser.getControl(name='form.title').value = "My test cert"
913  >>> browser.getControl(name='form.actions.save').click()
914
915Clicking 'Save' we will stay on the settings form. So we can change
[7208]916the cert again.
[6607]917
[7208]918  >>> browser.getControl(name='form.title').value = "My renamed cert"
[6607]919  >>> ctrl = browser.getControl("Save",index=0)
920  >>> ctrl.click()
921
922If we go to the settings page and click ``Cancel`` nothing will be
923changed:
924
925  >>> browser.getControl(name='form.title').value = "Blah"
926  >>> browser.getControl('Cancel',index=0).click()
927
928Our certificate was indeed renamed to ``My renamed cert`` and not to
929``Blah``:
930
931  >>> browser.open('http://localhost/myuniversity/faculties/TF/TD')
932  >>> print browser.contents
933  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
934  ...<td>My renamed cert</td>...
935  ...
936
[7076]937Searching certificates
938----------------------
[6607]939
[7076]940  >>> browser.open('http://localhost/myuniversity/faculties/search')
941  >>> browser.getControl(name='query').value = "My renamed cert"
942  >>> browser.getControl('Search').click()
943  >>> print browser.contents
944  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
945  ...faculties/TF/TD/certificates/CERT1">CERT1</a>
946  ...
947
948  >>> browser.open('http://localhost/myuniversity/faculties/search')
949  >>> browser.getControl(name='query').value = "CERT1"
950  >>> browser.getControl('Search').click()
951  >>> print browser.contents
952  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
953  ...faculties/TF/TD/certificates/CERT1">CERT1</a>
954  ...
955
[6607]956Deleting certificates
957---------------------
958
[7208]959We can delete certificates by browsing the manage page of the
960containing department and checking the appropriate select box and
961clicking the ´´Remove selected´´ button.
[6607]962
[7208]963  >>> browser.open(
964  ...    'http://localhost/myuniversity/faculties/TF/TD/@@manage#tab-3')
[6607]965  >>> 'My renamed cert' in browser.contents
966  True
967
[6613]968  >>> browser.getControl('Remove selected certificates').click()
[6917]969  >>> 'No item selected' in browser.contents
[6613]970  True
971
[7208]972  >>> browser.getControl(name='val_id').getControl(
973  ...    value='CERT1').selected = True
[6607]974  >>> browser.getControl('Remove selected certificates').click()
975  >>> 'My renamed cert' in browser.contents
976  False
977
978
[12920]979Certificate Courses
980===================
[6607]981
982Once we have a certificate, we can add also certificate courses. These
983are referrers of courses with some extra data.
984
985Before we can work with certificate courses, we need some certificates
986and courses to be available.
987
988  >>> browser.open(dept_url + '/addcourse')
989  >>> ctrl = browser.getControl(name='form.title')
990  >>> ctrl.value = 'Another course with same code'
991  >>> browser.getControl(name='form.code').value = 'COURSE1'
[7208]992  >>> browser.getControl(name='form.title').value = 'Course 1'
[6607]993  >>> browser.getControl('Add course').click()
994
995  >>> browser.open(dept_url + '/addcourse')
996  >>> ctrl = browser.getControl(name='form.title')
997  >>> ctrl.value = 'Another course with same code'
998  >>> browser.getControl(name='form.code').value = 'COURSE2'
999  >>> browser.getControl(name='form.title').value = 'Course 2'
1000  >>> browser.getControl('Add course').click()
1001
1002  >>> browser.open(dept_url + '/addcertificate')
1003  >>> ctrl = browser.getControl(name='form.title')
1004  >>> ctrl.value = 'Another cert with same code'
1005  >>> browser.getControl(name='form.code').value = 'CERT1'
1006  >>> browser.getControl(name='form.title').value = 'Certificate 1'
[7843]1007  >>> browser.getControl(name='form.study_mode').value = ['ug_ft']
[6607]1008  >>> browser.getControl(name='form.start_level').value = ['100']
1009  >>> browser.getControl(name='form.end_level').value = ['400']
1010  >>> browser.getControl(name='form.application_category').value = ['basic']
1011  >>> browser.getControl('Add certificate').click()
1012
1013  >>> browser.open(dept_url + '/addcertificate')
1014  >>> ctrl = browser.getControl(name='form.title')
1015  >>> ctrl.value = 'Another cert with same code'
1016  >>> browser.getControl(name='form.code').value = 'CERT2'
1017  >>> browser.getControl(name='form.title').value = 'Certificate 2'
[7843]1018  >>> browser.getControl(name='form.study_mode').value = ['ug_ft']
[6607]1019  >>> browser.getControl(name='form.start_level').value = ['100']
1020  >>> browser.getControl(name='form.end_level').value = ['400']
1021  >>> browser.getControl(name='form.application_category').value = ['basic']
1022  >>> browser.getControl('Add certificate').click()
1023
[7208]1024
[12920]1025Adding certificate courses
1026--------------------------
[6607]1027
1028Certcourses are stored in :class:`ICertificate` instances
1029with their code as key.
1030
[8920]1031Each certificate provides a ``Add certificate course`` action button near top.
[6607]1032
1033Certificates provide an add-form to add new certcourses:
1034
1035  >>> cert_url = dept_url + '/certificates/CERT1'
[6613]1036  >>> browser.open(cert_url + '/manage')
[8920]1037  >>> browser.getControl('Add certificate course').click()
[6607]1038  >>> print browser.contents
1039  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
[7459]1040  ...*</span>
[6607]1041  ...<span>Level</span>:
1042  ...
1043
1044In the add-form we will get a list of available courses to select
1045from. This list will contain all courses stored in the site, not only
1046the ones from local department:
1047
1048  >>> ctrl = browser.getControl(name='form.course')
1049  >>> ctrl.displayOptions
[8032]1050  ['--', 'COURSE1 - Course 1', 'COURSE2 - Course 2']
[6607]1051
[12920]1052We select the first course and create our certificate course:
[6607]1053
1054  >>> ctrl.getControl('COURSE1').selected = True
[7208]1055  >>> browser.getControl(name='form.level').value = ['100']
[8920]1056  >>> browser.getControl('Add certificate course').click()
[6607]1057
[12920]1058Our certificate course will be linked on the parent certificate page:
[6607]1059
1060  >>> browser.open(cert_url)
1061  >>> browser.getLink('COURSE1_100').click()
1062  >>> browser.url
1063  'http://localhost/my...sity/faculties/TF/TD/certificates/CERT1/COURSE1_100'
1064
[12920]1065We can't add the same certificate course twice:
[6613]1066
1067  >>> cert_url = dept_url + '/certificates/CERT1'
1068  >>> browser.open(cert_url + '/manage')
[8920]1069  >>> browser.getControl('Add certificate course').click()
[6613]1070  >>> ctrl = browser.getControl(name='form.course')
1071  >>> ctrl.getControl('COURSE1').selected = True
1072  >>> browser.getControl(name='form.level').value = ['100']
[8920]1073  >>> browser.getControl('Add certificate course').click()
1074  >>> 'The chosen certificate course is already' in browser.contents
[6613]1075  True
1076
[12920]1077When we started to add a new certificate course, we can also cancel the
[6607]1078process before submitting. This will bring us back to the certificate
1079page:
1080
1081  >>> browser.open(cert_url + '/addcertificatecourse')
1082  >>> browser.getControl('Cancel').click()
1083  >>> browser.url
1084  'http://localhost/myuniversity/faculties/TF/TD/certificates/CERT1'
1085
1086
[12920]1087Modifying certificate courses
1088-----------------------------
[6607]1089
1090We can change the settings for a certcourse by clicking on the
1091provided 'Edit certificate course' link:
1092
1093  >>> browser.open(cert_url + '/COURSE1_100')
[8920]1094  >>> browser.getLink('Edit certificate course').click()
[6607]1095
[6613]1096If we just click 'Save and return' nothing will change:
1097
1098  >>> browser.getControl("Save and return").click()
1099  >>> browser.getLink('COURSE1_100').click()
1100  >>> browser.url
1101  'http://localhost/myun.../TF/TD/certificates/CERT1/COURSE1_100'
1102
[6607]1103Let's set a new level (it was 100 before) and save the form. This will
1104bring us to the certificate index page afterwards:
1105
[6613]1106  >>> browser.open(cert_url + '/COURSE1_100/manage')
[7208]1107  >>> browser.getControl(name='form.level').value = ['200']
[6613]1108  >>> browser.getControl("Save and return").click()
[6607]1109
1110As we changed the level, also the URL will change:
1111
1112  >>> browser.getLink('COURSE1_200').click()
1113  >>> browser.url
1114  'http://localhost/myun.../TF/TD/certificates/CERT1/COURSE1_200'
1115
1116If we go to the settings page and click ``Cancel`` nothing will be
1117changed:
1118
[8920]1119  >>> browser.getLink('Edit certificate course').click()
[6607]1120  >>> browser.getControl(name='form.level').value = ['400']
1121  >>> browser.getControl('Cancel').click()
1122
1123Our certcourse provides a new level of 200 and not 400:
1124
1125  >>> browser.open(cert_url + '/COURSE1_200')
1126  >>> print browser.contents
1127  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
1128  ...<td>Level:</td>
1129  ...<td>200 (Year 2)</td>
1130  ...
1131
[12920]1132Searching certificate courses
1133-----------------------------
[6607]1134
[7076]1135  >>> browser.open('http://localhost/myuniversity/faculties/search')
1136  >>> browser.getControl(name='query').value = "COURSE1"
1137  >>> browser.getControl('Search').click()
1138  >>> print browser.contents
1139  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"...
1140  ...faculties/TF/TD/certificates/CERT1/COURSE1_200">COURSE1</a>
1141  ...
1142
1143  >>> browser.getControl(name='query').value = "*"
1144  >>> browser.getControl('Search').click()
1145  >>> 'Search string not allowed' in browser.contents
1146  True
1147
[12920]1148Deleting certificate courses
1149----------------------------
[6607]1150
1151We can delete certcourses by browsing the containing certificate manage page:
1152
1153  >>> browser.open(cert_url + '/manage#tab-2')
1154  >>> 'COURSE1_200</a>' in browser.contents
1155  True
[8920]1156  >>> browser.getControl('Remove selected certificate courses').click()
[6917]1157  >>> 'No item selected' in browser.contents
[6613]1158  True
[7208]1159  >>> browser.getControl(name='val_id').getControl(
1160  ...    value='COURSE1_200').selected = True
[8920]1161  >>> browser.getControl('Remove selected certificate courses').click()
[6607]1162  >>> 'Successfully removed: COURSE1_200' in browser.contents
1163  True
[7208]1164
[6607]1165  >>> 'COURSE1_200</a>' in browser.contents
1166  False
1167
1168
1169
1170Data Center
1171===========
1172
1173The data center helps us uploading files for later import or similar.
1174
1175  >>> browser.open('http://localhost/myuniversity')
1176  >>> browser.getLink('Data Center').click()
1177
1178Setting the file path
1179---------------------
1180
1181A datacenter stores files in a path in filesystem. By default this is
1182a directory in the sources:
1183
1184  >>> print browser.contents
1185  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
1186  ...
[7584]1187  <b>Storage path:</b> <span>.../parts/test/datacenter</span>
[6607]1188  ...
1189
1190Going to 'Settings` we can change the path:
1191
1192  >>> browser.getLink('Edit settings').click()
1193  >>> pathsetting = browser.getControl(name='newpath')
1194
1195We create a directory and set it as our upload path:
1196
1197  >>> import os
1198  >>> cwd = os.getcwd()
1199  >>> uploadpath = os.path.join(cwd, 'testfiles')
1200  >>> os.mkdir(uploadpath)
1201  >>> pathsetting.value = uploadpath
1202
1203And submit the form:
1204
1205  >>> browser.getControl(name='save').click()
1206
1207We clean up the set directory path, as there might be some files be
1208copied some files from installation:
1209
1210  >>> files = os.listdir(uploadpath)
1211  >>> for filename in files:
1212  ...   if os.path.isdir(os.path.join(uploadpath, filename)):
1213  ...     continue
1214  ...   os.unlink(os.path.join(uploadpath, filename))
1215
1216We also remove any existing 'accesscodes' subdir:
1217
1218  >>> import shutil
1219  >>> for filename in files:
1220  ...   if not os.path.isdir(os.path.join(uploadpath, filename)):
1221  ...     continue
1222  ...   if filename != 'accesscodes':
1223  ...     continue
1224  ...   shutil.rmtree(os.path.join(uploadpath, filename))
1225
1226The new upload directory is now empty, except from the logs and other
1227standard dirs, which are created automatically:
1228
1229  >>> sorted(os.listdir(uploadpath))
[8372]1230  ['deleted', 'finished', 'logs', 'unfinished']
[6607]1231
1232
1233Uploading files
1234---------------
1235
1236Now we can upload files. Most interesting files might be CSV files,
1237that can be imported lateron. We create a CSV file containing faculty
1238descriptions:
1239
1240  >>> open('faculties.csv', 'wb').write(
1241  ... """code,title,title_prefix
1242  ... FA,Arts,faculty
1243  ... FS,Sciences,faculty
1244  ... """)
1245
1246Now we can upload this file. To do this, we first go to the upload
1247page:
1248
[9024]1249  >>> browser.getLink('Upload data').click()
[6607]1250
1251and enter the appropriate data in the form:
1252
1253  >>> filewidget = browser.getControl(name='uploadfile:file')
1254  >>> filewidget
1255  <Control name='uploadfile:file' type='file'>
[7208]1256
[6607]1257A sidenote for developers: by marking the filewidget with the
1258``:file`` extension, we tell Zope to handle this field as a file
1259widget.
1260
1261  >>> import cStringIO
1262  >>> filecontents = cStringIO.StringIO(
1263  ...   open('faculties.csv', 'rb').read())
1264  >>> filewidget.add_file(filecontents, 'text/plain', 'myfaculties.csv')
[7208]1265
[6607]1266  >>> browser.getControl(name='SUBMIT').click()
1267
1268The file was indeed uploaded, with the current userid inserted:
1269
1270  >>> sorted(os.listdir(uploadpath))
[8372]1271  ['deleted', 'finished', 'logs', 'myfaculties_zope.mgr.csv', 'unfinished']
[6607]1272
1273We create and upload also a CSV file containing departments:
1274
1275  >>> open('departments.csv', 'wb').write(
1276  ... """code,title,title_prefix,faculty_code
1277  ... LIT,Literature,department,FA
1278  ... SOC,Sociology,department,FA
1279  ... PHY,Physics,department,FS
1280  ... INF,Informatics,department,FS
1281  ... MAT,Math,department,FS
1282  ... """)
1283
1284  >>> browser.open('http://localhost/myuniversity/datacenter/upload')
1285  >>> browser.getControl(name='uploadfile:file').add_file(
1286  ...   cStringIO.StringIO(open('departments.csv', 'rb').read()),
1287  ...   'text/plain', 'mydepartments.csv')
1288  >>> browser.getControl(name='SUBMIT').click()
1289
1290We create and upload also a CSV file containing courses:
1291
1292  >>> open('courses.csv', 'wb').write(
1293  ... """code,level,title,passmark,credits,semester,faculty,department
1294  ... LI1,,Introduction to Literature I,40,2,1,FA,LIT
1295  ... LI2,,Introduction to Literature II,40,2,2,FA,LIT
1296  ... AN1,000,Analysis I,40,2,1,FS,MAT
1297  ... AN2,000,Analysis II,40,2,2,FS,MAT
1298  ... """)
1299
1300  >>> browser.open('http://localhost/myuniversity/datacenter/upload')
1301  >>> browser.getControl(name='uploadfile:file').add_file(
1302  ...   cStringIO.StringIO(open('courses.csv', 'rb').read()),
1303  ...   'text/plain', 'mycourses.csv')
1304  >>> browser.getControl(name='SUBMIT').click()
1305
1306We create and upload also a CSV file containing certificates:
1307
1308  >>> open('certificates.csv', 'wb').write(
1309  ... """code,title,faculty_code,department_code,study_mode,end_level,m_prefix,start_level,application_category
1310  ... LBA,BACHELOR OF LITERATURE,FA,LIT,UG,ug_ft,500,LIT,100,basic
1311  ... LMA,MASTER OF LITERATURE,FA,LIT,UG,ug_pt,500,LIT,100,cest
1312  ... DME,DIPLOMA OF MATH,FS,MAT,DP,dp_ft,200,DME,100,cest
1313  ... """)
1314
1315  >>> browser.open('http://localhost/myuniversity/datacenter/upload')
1316  >>> browser.getControl(name='uploadfile:file').add_file(
1317  ...   cStringIO.StringIO(open('certificates.csv', 'rb').read()),
1318  ...   'text/plain', 'mycertificates.csv')
1319  >>> browser.getControl(name='SUBMIT').click()
1320
1321We create and upload also a CSV file containing certificate courses:
1322
1323  >>> open('certcourses.csv', 'wb').write(
[7665]1324  ... """code,faculty_code,department_code,certificate_code,level,mandatory
[6607]1325  ... LI1,FA,LIT,LBA,100,True
1326  ... LI2,FA,LIT,LBA,200,True
1327  ... """)
1328
1329  >>> browser.open('http://localhost/myuniversity/datacenter/upload')
1330  >>> browser.getControl(name='uploadfile:file').add_file(
1331  ...   cStringIO.StringIO(open('certcourses.csv', 'rb').read()),
1332  ...   'text/plain', 'mycertcourses.csv')
1333  >>> browser.getControl(name='SUBMIT').click()
1334
1335
1336Importing a CSV file
1337--------------------
1338
1339The import of CSV files is described in batchprocessing.txt.
1340
1341
1342Clean up:
1343
1344  >>> import os
1345  >>> import shutil
1346  >>> shutil.rmtree(uploadpath)
1347
Note: See TracBrowser for help on using the repository browser.