Test Plan - Site Creation Tool for Trainers

Owned by James Renfro
Last updated: Oct 24, 2006Version comment
6 min read

Testing the Site Creation Tool for Trainers

The user story here can be summarized as follows:

"We need a tool that will allow a number of workshop sites to be created based on a list of attendees for a training workshop--and a way for the workshop instructor to just enter names in a form that will run a site creation job in order to handle last minute appearances by people wanting to take the class."


JIRA Ticket(s) relating to this story:

New addition - Oct 24, 2006

In order to test the bug fix that went in with SAK-259, it's necessary to have at least one user assigned to the template project or course. It will also be necessary to verify that the "Next" and "Back" buttons work correctly in all cases, and that the paging of 5,10,20,etc... training sites works in the Manage Sites view. For more details on all of this, look for Bug Fix! annotations in the test plan below.


Setup Prerequisites

  • The following new realms need to be created:
    • Create realm !user.template.trainer with auth permissions checked for:
      • site.add.training-course
      • site.del.training-course
      • site.add.training-project
      • site.del.training-project
      • site.upd.site.mbrshp
      • ...and any other 'read' permissions for which we want to copy content
    • Copy realm !site.template.course to !site.template.training-course
    • Copy realm !site.template to !site.template.training-project
  • A new user needs to be created for each tester, of type trainer, and the login/password combo need to be made available to that tester
    • Add the tool "Training Sites" to each user's My Workspace
  • A course training template of type "training-course" needs to be created with all the necessary tools and content and each tester's user needs to be granted Instructor permission on it.
  • A project training template of type "training-project" needs to be created with all the necessary tools and content and each tester's user needs to be granted maintain permission on it.

Acceptance Tests

Goal: Basically, the goal here is to add one or more sites of a given template (project or course) to the SmartSite instance, using a user's kerberos id or ucdavis email address as the key. The user should then be able to login and access the course or project normally as 'maintain' or 'instructor' role. Also, the trainer should have the same role on that site.

Some key understandings

  • Creating a new site from template is a 4-step process.
  • There are two paths to giving the app its list of kerberos ids/email addresses – one is by typing them in by hand, the other using a flat text file.
  • If a given kerberos id or ucdavis email address is not correct, then that record will be ignored
  • Although a copy of the template site is made for each user's training site, still it's possible, in steps 3 and 4, to prevent specific tools or content from being copied into the new training site by unchecking a box to the right of the specific tool name under the appropriate screen.
  • It is not possible to copy ALL content from the template site to the training sites – only the the tool contents listed in Step 4 are available for copying over. In some cases, items that are copied over may be marked as "DRAFT"... this is due to limitations on the underlying Sakai implementation and is not addressable within our current effort.

1.0 Functional Verification

  1. Login as trainer1
  2. Navigate to "Training Sites" in left-hand column
    • This should present a view called "Training Sites" with the title "Manage Training Sites"
    • Initially, the list of training sites may be empty
  3. There are three choices of action here
    • Add Training Sites
      • This will take you to the first screen of a four-step process
      • Simply type kerberos ids or ucdavis email addresses into the text box, one-per-line, and click "Next"
      • A table of users should now be displayed, showing the identifier you passed, the full name of the user, their kerberos, email, possibly some notes, and a checkbox marked "Ignore"
        • If you click the checkbox to the right of a user, no site will be created in the following steps for that user
        • If the kerberos or email address passed was incorrect or could not be found, then no data will appear for that identifier and the "Notes" field should indicate that the user was not found
      • A list of potential template sites should be displayed in a dropdown box, choose the one you wish to copy
      • Click Next
      • Now you should be prompted to select the tools you wish to copy from the template site – by default, every tool is selected. If you do not want to copy a tool over, simply uncheck the checkbox
      • Click Next
      • Now you should be promtped to select any available content to copy over from the template site. Note that only a subset of the tool content can be copied. Just as in the step above, all content will be copied by default.
      • Click "Create Sites"
      • You should now see the Sites appear in the "Manager Training Sites" view. If you click on one of the tabs at the top of your SmartSite navigator, you should now see a site for every user appear.
    • Add Sites from File
      • The process is almost identical to the one above, except that the first step will prompt you for a file on your local machine.
      • The file should be just simple text, saved as a .txt, and should contain a single kerberos id or ucdavis email address per line.
    • Delete Selected
      • From the "Manage Training Sites" view, just click on the checkbox to the right of the training site you wish to remove, then click "Delete Selected"
      • The site(s) should disappear. If you refresh the view at the top of your SmartSite navigator, those tabs should also disappear.

To check if dropbox bug is fixed - BUG FIX!

  1. Add a user as a participant of either the course or project template site, verify that a dropbox is created in that site for that participant. Then go through the steps above to add a new training site (owned by a different user).
    • Check that the new training site includes the dropbox with the name of the user transferred.
    • Check that the same user exists under SiteInfo for the training site

Screenshots of the entire process
Step 3 of 4
Step 2 of 4
Step 1 of 4 - File Upload
Step 1 of 4 - Typing
Manage Sites Screen
Step 4 of 4

Changes as of 10/5 and 10/6

Added some new functionality as per suggestions made during the demo meeting 10/5.

  • Changed Message.properties to reflect actual behavior
  • Removed mark in Verify Users
  • Changed phrasing of "Allow trainer to have access"
  • Removed "resources-only" note under verify users
  • Included a back button on all appropriate screens
  • Added Spring property based switch to filter the template list to show/ignore training sites, and property-based restrictions to restrict/not restrict list to valid template types
  • Added property-based switch to use auto-generated site ids or not
  • Added paging to the "Manage Sites" page

Functional Area: Site Creation Tool for Trainers

 

 

 

 

Component Name(s): ucd-training-admin-tool

 

 

 

 

 

 

 

 

 

 

# Test Condition

Expected Result

(tick)/(error) Pass/Fail

Comment

 

 

 

 

 

1.0 Functional Verification

 

 

 

 

1.01

Add course for a single user by typing kerberos id

Site is created with correct tools & content, and is accessible to user

 

 

1.02

Add projects for multiple users by typing kerberos ids and email addresses with reduced content

Sites are created with correct tools & reduced content

 

 

1.03

Add project for a single user by file upload with reduced tool set

Site is created with reduced tools & normal content, and is accessible to user

 

 

1.04

Add courses for multiple users by file upload with some invalid ids and clicking on ignore for at least one user

Sites are created for all valid, non-ignored users with correct tools & content

 

 

1.05

Delete one or more sites created by tester

Site should be removed in the tool and no longer available to user

 

 

1.06

Add course for a single user by typing kerberos id and unchecked the "Allow trainer access to training sites" checkbox

Site is created with correct tools & content, and is NOT accessible to trainer, but IS accessible to the user it was created for

 

2.0 User Interface Element Verification

 

 

 

 

2.01

Verify template list

Only courses and projects accessible to the trainer should be visible

 

 

2.02

Verify training site list

Only courses and projects created by the testers should be visible

 

 

2.03

With at least 11 sites in the Manage Sites window, try paging back and forth, delete pages

State should be correctly maintained, listing of which sites are being viewed should be correct

 

 

2.04

Make extensive use of "Back" and "Next" buttons

State should be maintained, with no unexpected jumps

 

 

 

 

 

 

 

3.0 Error Handling-Presentation Layer (i.e. UI)

 

 

 

 

3.01

Attempt to add site by typing in user with non-existence kerberos id

On 'verify users' screen, no info provided

 

 

3.02

Attempt to add site(s) by file upload for users with non-existence UC Davis email addresses

On 'verify users' screen, no info provided for invalid email addresses

 

 

 

 

 

 

 

4.0 Error Handling-Log Verification

 

 

 

 

4.01

Verify errors generated from Training Site Creation tests: catalina.out.

 

 

 

 

 

 

 

 

5.0 Audits & Controls

 

 

 

 

5.01

Verify Security: trainer is not able to add sites from the Worksite Setup tool

New button does not appear under Worksite Setup

 

 

 

 

 

 

 

6.0 Performance

 

 

 

 

6.01

Verify that submit response time is reasonable at each step

 

 

 

 

 

 

 

 

DOCUMENT REVISION HISTORY

 

1) Created by James Renfro on 10/2/2006.

2) Modified by James Renfro on 10/6/2006.