- Open Eclipse
- Open the source code project to use during the study
- Connect to Core
- Use iTrace Core to Start Tracking
- Use iTrace Core to Stop Tracking
- Disconnect from the Core
- You MUST disconnect the iTrace Eclipse plugin before closing Eclipse the output data is complete
Before You Begin
This iTrace Eclipse plugin requires iTrace Core v0.1.0 to be downloaded and installed before you use the extension.
For help with installing the iTrace Eclipse plugin, please read the Installing the iTrace Eclipse Plugin document for instructions.
Viewing the iTrace Eclipse Plugin Window
If the iTrace Eclipse Plugin window is not visible, you can open it using the following steps:
- In the Eclipse menu go to
Window->Perspective->Open Perspectiveand click
- In the “Open Perspective Menu” select
iTrace Eclipse Pluginfrom the list of available perspectives
Once the iTrace Eclipse Plugin window is open you can dock it in the editor and it should remain visible on subsequent launches of the Eclipse IDE.
Changing the Socket Port
If you have changed the Socket communicate port number in the iTrace Core application, you will need to set the iTrace Eclipse plugin socket to listen for data on the same port number. You can edit the socket port number setting using the following steps:
- In the Eclipse menu go to
- From the Eclipse preferences window click on
iTrace Eclipse Plugin
- Change the socket port number to your desired value (must be between 1025 and 65535)
Changes to the socket port setting go into effect when the
Connect to Core button is clicked on the iTrace Eclipse Plugin. If iTrace Core and the iTrace Eclipse Plugin socket port values are not the same, the tools will not be able to communicate.
Connecting to iTrace Core
With the iTrace Core open, the iTrace Eclipse Plugin can be connected by clicking the
Connect to Core button found on the iTrace Eclipse Plugin window. When the iTrace Eclipse Plugin is successfully connected, the button text will change to
NOTE: iTrace Core must be running before attempting to connect the iTrace Eclipse Plugin and both applications must be using same socket port setting value.
Starting and Stopping a Tracking Session
To start a tracking session, ensure that the iTrace Eclipse Plugin is connected and then click the
Start Tracking button on the iTrace Core application. When the session is complete, click
Stop Tracking on the iTrace Core application. If you intend to start another tracking session, it is NOT necessary to disconnect the iTrace Eclipse Plugin from iTrace Core. A new session can be started by clicking
Start Tracking again on iTrace Core.
Disconnect from iTrace Core
When you are completely finished with data collection from your subject, stop the tracker using the iTrace Core application and then click ‘Disconnect’ on the iTrace Eclipse plugin.
NOTE: Closing Eclipse without disconnecting will leave you with invalid XML.
highlight tokens feature highlights the source code tokens being viewed on the screen in real time while tracking. This feature is not intended for use during an actual study and is only intended as a demo feature.