Instructor Manual

You can also download the instructor manual here (disabled now, the latest version is in HTML below)

Table of Contents

Getting Started

Visit the url at which APOGEE is hosted. You will be brought to a login page. Enter your user name and password and you will be redirected to the appropriate user page.
Login Page

Instructor Project Summary

After logging in as an instructor, you will be brought to a page that displays courses and projects. Courses displays all courses created by that instructor, and Projects displays all projects created by that instructor.
02

Creating/Deleting Courses

You can create a project by filling in the information above the Course table. You need to input the ID, which is a unique course identifier specified by the user, the Title, which is the name of the course, and the Term in which the course is offered. Once this information is inputted, simply click the Add button to add the course.
03
The new course will then show up on the course list. 04

To delete a course, simply press the "select" link next to the course you want to delete, and then click Delete.

Creating/Deleting Projects

You must add projects to specific courses. So, first, you must select a course in which the project will be added. Simply click the "select" link next to the course you want the project to be added to. Clicking "select" will highlight the whole course.
05

To add the project to the selected course, click the Add button below the "Projects" headline. It will then bring you to a project creation screen. Project information such as the title, post and due date, specification, description, status, and test cases are defined here (Test cases will be discussed in detail below). 06

To delete a project, "select" the project as you did the course, and click the Delete button (the one under the Projects headline).

Test Cases

Test cases are used to test a web application. They are defined by the user to test anything from basic functionality to security vulnerabilities of a submitted web application. Test cases are constructed through a three-tier tree system. Requirement Categories->Requirements->Testcases. Each category will be described below.

Requirement Categories

Requirement Categories are a category of a group of requirements sharing a similar theme. For example, a requirement category could be "Functional Requirements" which will contain all the functionality aspects of a web application. A requirement category can have many requirements, each with many test cases.

Adding Requirement Categories

To create a Requirement Category, simply press the "Add" button below the project details. Fill out the required information, such as the category name, description, and whether or not the category is visible to studnets, and then click save.

Deleting Requirement Categories

Deleting a requirement is simple. Click the requirement category you would like to delete on the left menu, and click the delete button at the bottom.

07

Requirements

Requirements are more specific than requirement categories. These are used to bind a group of test cases under a common theme. For example, for the Requirement Category "Robustness," you may have a requirement called "Overflow" which contains test cases which check for proper handling of integer overflow.

Adding Requirements

In order to add a requirement, you must choose a requirement category to add it to. Click the requirement category you want to add the requirement to and then click the Add button above the menu on the left. Fill in the required information, and then click Save on the bottom.

Deleting Requirements

Similar to deleting Requirement Categories, select the requirement you wish to delete, and then click delete.

08

Test Case Actions

Test case actions are where you actually design the exact operation that is going to be checked. It is flexible enough to allow you to check standard functionality, such as proper addition, whether or not certain controls are there, and even automatically check the application for a security exploit.

Adding test cases

Test cases are relatively simple to add. You stack simple operations on top of each other to get the desired test result. First, you need to fill out all the information on the top, the name, whether it's visible, points, and the description. When you're done, click save.

Now to actually define the test case, we look towards the bottom. The drop box contains actions that you can select. Currently, these are the actions that are available:
10

Visit Page simply visits a specified page.
Click Button will click a button with either an ID or Name, which is specified by the user.
Enter Text allows text to be entered into a web control (which is specified by id or name).
VerifyExistence allows you to check if there is a certain string displayed on the page.
Wait simply waits a set amount of time before continuing.

You must add each action individually by selecting an action from the drop box and clicking Add, fill out the required information (text to enter into the box, or which button control to press, etc) and click the "Save" button on the same row as the drop box.

Deleting Test Cases

To delete test cases, you must select the test case you want to delete and press the delete button all the way at the bottom. To delete an individual action, select the action and press the delete button above it.

Rearranging Actions

You can rearrange actions by selecting the action in the table, and either pressing the "MoveUp" or "MoveDown" button.

09