Context navigation

pages.txt @ 17977

Last change on this file since 17977 was 16812, checked in by Henrik Bettermann, 3 years ago
Add 'Modules Level'.
File size: 44.6 KB

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

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

Context navigation

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

Download in other formats: