|1.0||What is Jazz?|
|2.0||Setting up the Jazz Client|
|3.0||Jazz Source Control|
|4.0||Jazz Work Items|
|5.0||Connecting to Google Chat|
Jazz is an integrated development platform with an emphasis on team collaboration, communication, and software development processes. Jazz contains a client and a server. In this tutorial we will set up and install the Jazz client, as well as show a few of the features of Jazz:
Jazz uses a few terms that require some clarification:
In this tutorial, we will be getting started with
Jazz using iTrust as our example project.
The Jazz Client is built on Eclipse. One can install Eclipse plug-ins in the same manner as Eclipse. For this tutorial, we will be using a Jazz client with pre-installed plugins from the Eclipse Web Tools Platform (WTP).
1. Download the self-extracting file with the Jazz client from a location which your TA provides. Note: this is for Windows users only. For other operating systems, please go to jazz.net and install the WTP plugins yourself. Your TA can guide you through this process.
2. Extract the file onto your hard drive in the location of your choosing. Start Jazz by executing the following program:
(your extracted location)\Jazz Client with WTP\jazz\client\eclipse\TeamConcert.exe
3. Your workbench should ask you for your workspace. Note: on the first startup of Jazz, you should see a Welcome Screen. If you do not see a welcome screen and the Process Perspective is not available, just restart Jazz and that should work.
4. Go to
5. Under the
Figure 1. Creating a Repository Connection
6. Your TA should give you the information needed
for successfully creating a connection to the repository. Fill in the information and click
7. Your TA should provide you with the name of the
project area for your team project. Select the project area and
8. Your Team Artifacts view should now be populated with various access points for Jazz features, such as Repository Workspaces, Project Areas, Team Areas, Work Items, etc. Though we are connected to our Project Area, we have not actually uploaded iTrust yet. To upload iTrust, we need to first deploy it (see the deployment instructions on the iTrust website for how to do that).
9. While we're here, let's change your password (if
you haven't already). Right-click on your repository connection and
Figure 1.33 Open your user editor
10. Click on the
Figure 1.66 Changing your password
11. Now let's load iTrust. First we need to create
a "Repository Workspace", which is a space on the Jazz repository
reserved for your work. Your teammates can track your workspace, but
only you can deliver code to it.
Figure 2. The populated team artifacts view
12. Double-click the
Figure 3. The Stream Workspace
Jazz provides a version control system that allows you to track the changes you make in your code both locally and within your team. The following terms are used in various ways:
The following steps will take you through:
1. Switch to the Java perspective (
2. Right-click on your project and select
3. Select your
Figure 4. Selecting the component in which to share your project
4. Make sure that iTrust is the only Jazz project
selected to be shared. Click
5. The default settings for ignoring resources
should be the
6. The process of creating a change set and uploading changes can be lengthy, please be patient. When this is finished, you will need to confirm your changes.
7. Now we need to complete the changes and deliver them. Under the Pending Changes view, you should see the entire iTrust project ready to be delivered. Right-click on the workspace and select "Deliver"
8. Now our iTrust project is shared on the stream.
Now let's make some changes and deliver those. Edit the file in
9. Under the pending changes view, the developer
notes should show up. Note that right-clicking on the change in
Figure 6. Delivering changes
10. To view changes from the stream made by your
teammates, right-click on your project in the package explorer and
Figure 7. Incoming changes
11. To accept the changes, right click on the change and select "Accept...".
Figure 8. Accepting changes
12. To check out a project for the first time into
your workspace, go to your Team Artifacts view, find the
Figure 9. Loading a project for the first time
Work items are ways for team members to collectively gather and assign tasks regarding the project. Work items can have various different types, such as enhancements or defects. In this section, we will create a new work item and show how to find your team's work items.
1. In your Team Artifacts view (you may need to switch to the Process perspective), expand your project area node. Right-click on the Work Items and select New > Work Item...
Figure 5. Creating a new Work Item
2. Select "Defect" and hit
3. Your new defect should be opened up with many different options. Add the following information:
Figure 6. Adding Information to your Work Item"
4. Save your work item using the button in the upper-right.
5. Now let's find our work item. For that, we need
to set up a query for all of our work items. Under your Team
Artifacts view, right click on
6. Select Simple Query in the editor that is opened. You should be presented with a screen that has many different options for work items. Add the only constraint for work items to be in your project area. Running the query results in a similar screen as in the figure below.
Figure 7. A basic work item query
And there's our work item!
If you have a Google account, you can use the Chat feature in Jazz. At this point in time, we do not have any chat servers set up, so if you would like to use the Chat feature, you will need a Google account. Otherwise, you may skip this section.
1. Make sure that you are connected to a Project
Area. In Jazz, Windows users should go to
2. Click on
Figure 8. Adding a new Instant Messaging connection
4. Hit the
5. Your user name should appear in green in the
Figure 9. Selecting another person to chat with
6. Selecting "Chat..." will open a chat view in Jazz.
Figure 10. Chatting with another person
7. Right-click on your Team Area to
Figure 11. Joining a team discussion
Jazz does a whole lot more than we've gone over here. Feel free to explore their interfaces and features.
Jazz also has significantly thorough documentation. You can find help menus throughout the client, as well as on Jazz.net. Below are some links that can be very helpful: