Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Testing

...

the

...

Site

...

Creation

...

Tool

...

for

...

Trainers

...

Note
titleDRAFT

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:


...

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.

...

Info
titleSome 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 trainer
  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.
Gallery
columns3
titleScreenshots of the entire process
Warning
titleChanges 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.