Lesson 1: Setting up a project and team as Administrator
In this lesson, you connect to a repository, create a project area, and add team members to your project area. Team members are known as users. You will define a process for your project area using a predefined process template. The process you select will initialize your configuration with everything you need to try out other components like work items and IBM® Engineering Workflow Management Source Control.
Connecting to a repository for the first time
Connect to a repository.
- Open the Work Items perspective. If this is not the current perspective, from the menu bar click .
- Open the Team Artifacts view. If no repository connections exist,
you will see a set of links to help you get started.
- In the Team Artifacts view, click Create a Repository Connection.
- In the Create a Jazz Repository Connection dialog box, in the
appropriate fields, enter the server location (a URL of the form:
https://<server>:<port>/ccm) and the user name and password you created when you set up the server. If you are running the server on your own computer, the drop down list under the URI field provides a usable value. Click Finish.Note: If a repository connection already exists, in the Team Artifacts view, to create a new connection, right-click Repository Connections; then click .Your repository connection displays in the Team Artifacts view.
Creating a project area
Create a project area.
- In the Team Artifacts view, expand the Repository Connections item. Right-click your repository connection; then click
- In the Create Project Area wizard, on the Project Area page, in the Name field, type Prelude and click Next.
- Optional: On the Choose Process Template page, if you are working with an empty repository, no process templates are defined. Click Deploy Templates.
- In the Available Process Templates area, select Scrum.
- Ensure that the Automatically initialize the Project Area radio
button is selected, and click Finish.
This process template creates everything that you need to continue using Engineering Workflow Management, such as a project area and a stream to share project content among your team.
After initialization completes, a set of work items are created that you can use to track remaining setup activities.
The Work Items view was opened in the first step of this tutorial. Work items will be discussed later.Note: The id numbers assigned to the work items might differ from what is displayed.Also, the Team Artifacts view displays the created project area:
What to do next
Adding team members to your project area
A project has several functions. For now, the tutorial will focus on defining team members and adding them to your new project.
About this task
|Name||User ID||Email Address||License|
Add other users.
- In the Team Artifacts view, right-click your project; then click Open. In the Project Area editor add a summary and description in the appropriate fields.
- In the Members pane, click Create.
- On the Create or Import Users page, select Create a new user and click Next.
- On the User Information page, type the name, user ID, and email address in the appropriate fields. The tutorial uses a fictitious developer named Chris. You can use a different name. Note the user ID, as you will need to know it later on.
- Click Next.
- On the Repository Groups page, select JazzUsers. Leave the JazzAdmins repository group to the ADMIN ID for now. Click Next.
- On the Client Access Licenses page, select Engineering Workflow Management - Developer.
- Click Finish.
This new user displays in the Members pane of the Project Area editor.
- Repeat step 2 to step 8 to add the following users:
- Yourself and any other members of your team.
- From the Members pane, select the first team member you created (in our case: Chris). Click Process Roles.
- In the Process Roles dialog box, select Team Member from the Available Roles area. Click Add. The Team Member role displays in the Assigned Roles area. Click Finish.
- Repeat step 10 and step 11 for each member of your team, including yourself.
- Click Save. The Send Team Invitation to New
Members dialog box displays requesting you to select the users who will receive a team
Note: The Team invitation feature can be fully tested only if the SMTP server properties for email notification are correctly set.
- Select only one of the users and click OK. The Invite To
Join Team dialog box displays. When you select only one user you view the invitation
properties. If you select more than one user, you only view the email subject and the first few
paragraphs of the invitation.
- Personalize the invitation subject, the associated message and clear the Email a copy of the invitation to you check box.
- As mentioned previously, unless the server properties are set to enable email notification, an email invitation will not be sent. In this example Chris, Jamie, and Build are not really members of your organization, so do not click Finish. Instead, copy the values under The properties that will compose the team invitation area and paste them into a text editor. Then click Cancel. If your server is correctly set up for email notification, you can send an invitation to your colleagues (or yourself).
Setup is complete. You now have a project area that contains team members and a stream where you can share code. You will learn more about using this stream in the next section.
In this lesson, you learned how to set up a project.