Linking Students to Tests

The Student Tests page uses the default Test Area and default Student Area which are set in System Administration. To access other tests, create hyperlinks as described below.

Students take tests by clicking on a link to one of these 3 files: TestMenu.asp, TakeTest.asp, and TestCode.asp. The one the teacher chooses depends upon specific application needs.  Students can also review test content by playing the Academic Olympics Game with a link to game/G1/StartGame.asp.

  1. If you want to put a DIRECT link from your course materials to a SPECIFIC test, then create a link to TakeTest.asp.

    • TakeTest will only ask for the student's name and password. Then it will take the student to the test specified.
    • The link to TakeTest.asp should ALWAYS be set to open in a NEW window.
    • The names of the student and Test Areas as well as the Test ID are all hidden in the link parameters as shown below.
    • If NO parameters are set as part of the link, then TakeTest will ask for the name of the student and Test Areas as well as the Test ID.
    • Setup and confirmation features:
      • If the test is setup in Advanced Features to allow and confirm new names, then to enter a new name the student must check the "Click here if you are a NEW student" box.
        • Every student or employee must have a unique password, ID or employee number.
      • If the test is setup to allow new names without confirming them or to request no name at all, then the "Click here if you are a NEW student" box does not appear
        • Students or employees can have the same passwords.
    • If these parameters ARE entered with the link to TakeTest, then this page will only ask for the student name and password.
      • It is possible to add parameters for the student name or password so that even these fields do not appear, for example, when doing a survey.
      • Student Area: Since there can by any number of Student Areas, the one the teacher is using for this test must be specified.
      • Test Area: Since there can also be any number of Test Areas, the one the teacher wants these students to access must be specified.
      • Test ID: A Test Area can have any number of tests in it. Each test has a Test ID that identifies the specific test the student is to take.

      This is what the hyperlink to TakeTest.asp should look like:

      http://www.robotutor.com/RoboTutor9/taketest.asp?studentarea=Students9&testarea=Everyone9&testpassword=A11

      • If you are linking to the RoboTutor site, you only need to enter the Test ID (shown in green at the very end). The Test ID (test password) is a unique number or name that you assign a test when you create it. If you are on another site, you also need to change the path (blue) and the names of your student and Test Areas (lavender).

        •  
    • If you would like to have your students or employees enter 1 or more Sorting Codes (course number, teacher, age, etc.) when they log into a test, add &code=true to the end of the hyperlink shown above.
      • Sorting Codes can be used in Student Administration to select students for various reports.
      • You can also enter the Sorting Code directly in the command line if you want that code for every student. For example, &code=Jones3 for Mr. Jones' 3rd period. 
        • To add several Sorting Codes from the command line, include a COMMA between them, but NO spaces. For example: &code=Jones,Period3
        •
      • This feature also works with Test Menus and Surveys.
         
      •
  2. If you want your students to see a MENU of all tests in a specific Test Area, then create a link to TestMenu.asp.
     
    • TestMenu is designed to automatically create a menu of all tests in a specific Test Area. All the links from this menu are automatically set so students only need to enter their names.
    • The names of the student and Test Areas as well as the title on the menu page are all hidden in the link parameters as shown below.
    • The link to TestMenu.asp should always be set to open in a NEW window.
    • If NO parameters are set as part of the link, then TestMenu will ask for the name of the Student Area, the name of the Test Area, and the title for the test menu.
    • If these parameters ARE entered with the link to TestMenu, then this page will not display and the student will go directly to the menu itself.

    This is what the hyperlink to TestMenu.asp should look like:

    http://www.robotutor.com/RoboTutor9/TestMenu.asp?testarea=everyone9&studentarea=students9&testtitle=My Tests

    • If you are linking to the RoboTutor site, you only need to enter a test title (shown in green at the end). If you are on another site, you need to change the path (blue) and the names of your student and Test Areas (lavender).

  1. If you want to use a "test" in a GROUP PRESENTATION or an ANONYMOUS SURVEY, you will probably NOT want the program to ask for a student name and password.

http://www.robotutor.com/RoboTutor9/taketest.asp?firstname=Student&lastname=Summary&
studentpassword=12345&studentarea=Students9&testarea=Everyone9&testpassword=A11

  • Note: the values in lavender shown above (firstname=Student, lastname=Summary and studentpassword=12345) can be substituted with any other values you prefer as long as they are not used by any existing student.
  • Another option is to have TakeTest list all the tests in a specific Test Area using a drop-down menu in place of the text field that asks for the Test ID.  That way students can simply pick a test. You could have a Test Area with nothing but the tests in a specific subject. To start the game with a drop down menu, replace testpassword={Test ID} with testpassword=testmenu.

http://www.robotutor.com/RoboTutor9/taketest.asp?firstname=Student&lastname=Summary&
studentpassword=12345&studentarea=Students9&testarea=Everyone9&testpassword=testmenu

  1. It may be desirable at times to restrict student access to tests and course materials by linking them to TestCode.asp.  An example is where students are paying for the right to take an online course.  To setup RoboTutor for this purpose, follow these steps:

    • From the main menu, click on System Administration. Access is limited to those who know the password to this area.
    • On the next page, scroll down to the Course Access Codes section and enter the number of pass codes you want to generate in the # field.
    • Enter the number of months the pass codes will be usable once they are activated in the Mo. field.
    • Enter the URL where the students will go to see the course materials.
      • To prevent students from later accessing them without logging in, use the special ASP pages located in the courses/template folder.
      • Create a new folder and copy the files in the template folder to your new one. Rename them or create new files as needed. Then use a path to that folder as your URL above.
      • For example, create a folder under courses and name it course1. Copy all the files from the Template folder to course1.
      • The URL you put in the form to create Access Codes would then be courses/course1/CourseMenu.asp.
      • Note, if you click the Test Link button and your address is CORRECT, then you should get the following: Application Error, A Pass Code was not specified. It says this because you should not be able to access these pages without a test code number.
    • Click Submit and a page appears that lists the pass codes generated. Be sure and print it.
    • The next step is to generate the course materials using the files in your new course folder.
      • Open CourseMenu.asp in an HTML editor such as FrontPage.
      • Add or delete menu links as needed.
      • Modify the Final Exam link at the bottom to include your Test Area, Student Area, and the password to the test.
      • Do the same for each of the Section pages.
    • When the course materials are finished and on the network, put a link for your students to TestCode.asp. Give (or sell) to each of your students one of the pass codes.
      This is what the hyperlink to TestCode.asp should look like:
      http://      www.robotutor.com      /RoboTutor9/testcode.asp?studentarea=Students9
       
    • If you are linking to the RoboTutor site, you only need to enter a Student Area name (shown in green). If you are on another site, you need to change the path (blue).
      • Students will be only asked for their pass code.
      • If you do not include the Student Area in the link, then students will also be asked for the name of the Student Area where their name and scores will be stored.
      • Once they enter their name, it is tied to that pass code and all they need to do in the future is enter the pass code to access the course materials.
         
  2. If you want your students to PLAY a GAME using the questions from any test, then create a link to game/G1/StartGame.asp.
     
    • The names of the Test Area and Test ID are usually hidden in the link parameters as shown below.
    • No Student Records are saved in the Student Area database, so no reference needs to be put in the code.
    • The link to StartGame.asp should always be set to open in a NEW window.
      • Note, the files for the game are all in the Game folder under the main menu. Your links must therefore include the name of the folder as shown below.
    • If NO parameters are set as part of the link, then StartGame will ask for the Test Area (testarea) and the Test ID (testpassword).
    • If these parameters ARE entered in the parameters with the link to StartGame, then StartGame will only ask for the names of the players.

    This is what the hyperlink to StartGame.asp should look like:

    http://www.robotutor.com/RoboTutor9/game/G1/StartGame.asp?start=true&testarea=everyone9
    &    testpassword=    mygame&Help=Answers

    • If you are linking to the RoboTutor site, you only need to enter the name of the Test Area (shown in lavender) and  Test ID (shown in green at the end). If you are on another site, you need to change the path (blue).

    • Another option is to have StartGame list all the tests in a specific Test Area using a drop-down menu in place of the text field that asks for the Test ID.  That way students can simply pick a test. You could have a Test Area with nothing but special game versions of the tests. To start the game with a drop down menu, replace testpassword={Test ID} with testpassword=testmenu.

    http://www.robotutor.com/RoboTutor9/game/G1/StartGame.asp?start=true&testarea=everyone9&testpassword=testmenu& Help=Answers

    • To make a link to a game, go to the Question List page and click the Game link at the bottom of the page. When it opens in your browser, copy the Address and put it anywhere you want a link.
      • To have the game display the CORRECT answer when students miss a question, the path to the game should have Help=Answers at the end. This is the default when you click on the Game link.
      • To have the game display the TUTORIAL answer when student miss a question, change Answers to Tutorial so it looks like this: Help=Tutorial.
      • To have the game display both CORRECT and TUTORIAL answers, use Help=Both
      • To have the game display nothing, use Help=
    • The game by default opens into a new regular window. To open it full screen, add this code to the end of the command line: &Screen=Full

Students can also access their personal records and see how they are doing toward reaching the Certification objectives of any program:
  • TakeTest.asp logs in students for taking tests. It also has an "Access My Records" button at the bottom so students can view their personal records.
  • AccessMyRecords.asp lets students view their personal records, but does not log them in for testing.

This is what the hyperlink to AccessMyRecords.asp should look like:

http://www.robotutor.com/RoboTutor9/AccessMyRecords.asp?studentarea=Students9
  • If you are linking to the RoboTutor site, you only need to enter a Student Area name (shown in green). If you are on another site, you need to change the path (blue).
  • Students will be only asked for their name and password.
  • If you do not include the Student Area in the link, then students will also be asked for the name of the Student Area where their name and scores will be stored.
  • Once they enter their name, they go to a page that lets them view the following:
    • The Certificate Program Report Card if it has been setup.
    • All the tests the student has taken and are recorded in that Student Area.
    • Select tests the student taken as specified by a start and end date.
  • The student also has the option to to display every test taken or only the highest scores for each taken taken.

Teachers can access Student Records & Reports by clicking on the Administration button at the bottom of the Log In page.

  • Click Administration from TakeTest.asp
    • A page will open that requests the Password to the Records and Reports Menu of the Test Area that the Log In page is trying to access. This Password may be the same or different from the one used to open the Test Area in the regular program.
    • Enter the Password and the Records and Reports Menu will open.
    • The Teacher does not have access to any other features in the program from this menu.
  • To put a button directly to Records & Reports from any other web page, use this code:

http://www.robotutor.com/robotutor9/admin/default.asp?TestDB=Everyone9&StudentDB=Students9
&Source=../tests_table.asp&TestID=?

  • TestDB is the name of the Test Area. Change the part in Red to the correct name.
  • StudentDB is the same of the Student Area. Change the part in Red to the correct name.
  • Source is the page to which you want the Teacher to return when leaving the Records and Reports section. It is most likely the page on which the button will be placed.
    • If left blank (Source=) then the default is TakeTest.asp so students can Log In for a test.
      • TestID then should be included and provide the ID for a specific test in this Test Area.
        • If a Source is provided, then leave TestID blank.
  • Change the URL in blue to the address of your website.