IWP ProblemServer Walkthrough and Tutorial
Taylor Brockman - September 25, 2004

0. Definitions

Animator: The half of the IWP software program that will playback saved .iwp files from the ProblemServer, the web, or the local Hard Drive.

Designer: The half of the IWP software program that allows teachers to design problems and create and edit .iwp files.

ProblemServer: A web interface and a web service that is a centrally located repository for storing, loading, editing and sharing .iwp animations.


1. Download the latest JRE w/ the Java Plug-in

http://java.sun.com/j2se/1.4.2/download.html
Recommended: J2SE v1.4.2_05 JRE

The applet has been tested to run under both Windows and RedHat Linux.

A warning about security:
To enable the network problemServer communication, we had to use a 3rd Party XML-RPC library that needs access to some protected environment variables. This means that the applet is signed by us, an untrusted signer. The first time that you load the applet, you will see the following screen:


Figure: Example Applet Security Warning

You will need to click "YES" on this screen to grant the applet the correct access rights to be able to use the problemServer communication.



2. Use the Animator: Browse User Problems (Students)

Load the Example User Problems directory. Here you will see sample files that you can animate.


Figure: Browsing Example Problems

Clicking on the filename (Example Target Problem.iwp) of a file will bring up an Animator Applet webpage. There is a java applet tag in this page that should cause the Animator applet to appear as a new desktop window and load the desired problem from the problemServer.


Figure: Animating a problem: HTML Page - Applet will popup


Figure: Animating a problem: Animator Applet View - Popup Window

At this point, you can interact with the Animator to play the problem back and forth, edit input values, and interact with the physics problem.
TODO: Explain more about the animator controls.


Webmaster Tip: You can deep-link to the animator page from other websites to integrate IWP content within your own website. To link to the example problem above create an A HREF link to: /pps/webInterface.php/Example%20Problems/Example%20Target%20Problem.iwp (use %20 for spaces). This will work for files out of any public iwp problemServer directory, even your own user directory.



3.4 Local Files are usable because the applet is signed. You can use the 'Local File' option under the 'Open', 'Save', and 'Save As' to work locally on .iwp files.

Tip: To make a copy of a file, Load it from the problemServer with the designer and then 'Save As' to save it under a new filename in your /Users/ directory.

Tip: Every IWP Problem file must have a .iwp extension on it to be properly recognized by the client and the server


4. Download the iwp.jar locally and Create a User Account and begin designing problems

TODO: Write Documentation on this
# build release;
creates a developer.jar that is manifested.