The predefined templates that are included with the Lifecycle
Project Administration user interface are XML files. You can download
and modify these files to create customized lifecycle projects and
project areas.
Before you begin
You must have JazzProjectAdmins or JazzAdmins repository group
permissions, and the Jazz® Team Server must
be running. See Accessing the Lifecycle Project Administration user interface. Note: Editing
XML files is a technical task, and it is easy to make mistakes. You
should be familiar with XML syntax before attempting this task.
About this task
The templates contain the following sections:
- Template Description: Use this section to specify the template
identifier, title, description, and locales. The title and description
appear on the Templates page of the Lifecycle Project Administration
user interface.
- Project Areas: Use this section to specify the application project
areas to create. For each project area, specify which process templates
are available to create the project area. For example, the Analyst,
Developer, Quality Professional template creates project areas in
the Requirements Management, Change and Configuration Management,
and Quality Management applications. To create the Change and Configuration
Management project area, the template provides users with the choice
of Scrum and Formal Project Management process templates. For Requirements
Management project areas, you specify process and project templates.
The process and project templates appear in the user interface in
the order in which you specify them.
- Project Area Associations: Use this section to specify the associations
to establish between the project areas. Associations determine which
artifacts you can link across project areas.
Procedure
- In the user interface, click Templates.
- In the Actions column cell for the
template that you want to download, click
, the Download template icon.
- Locate the template XML file in your file system and open
it in an XML editor. Save the file under a different name.
- In the Template Description section, edit the dc:identifier,
dc:title, and dc:description tags to specify a unique template identifier,
new title, and helpful description. Optionally, edit the entries in
the locales tag to specify the locales in which the template is available.
-
In the Project Areas section, add or remove projectArea tags to specify application project
areas to create. Use the id attribute to specify the application type (rtc.project, rrc.project,
rqm.project). To specify the process templates that are available to create a project area, use the
processTemplate tag. The following example specifies that users can choose the Scrum or Formal
Project Management template to create the change and configuration management project area:
<projectArea id="rtc.project>
<processTemplates>
<processTemplate>
<dc:identifier>scrum2.process.ibm.com</dc:identifier>
<dc:title>Scrum</dc:title>
</processTemplate>
<processTemplate>
<dc:identifier>formalpm.process.ibm.com</dc:identifier>
<dc:title>Formal Project Management Process</dc:title>
</processTemplate>
</processTemplates>
<dc:subject>Change Management</dc:subject>
<domain ref="http://open-services.net/ns/cm#"/>
</projectArea>
- In the Project Associations section, add or remove projectAreaAssociation
tags to specify the associations to establish between the project
areas. Use the sourceDomain and targetDomain tags to indicate the
direction of the linking. Use the linkType tag to indicate the relationship
between the artifacts being linked to each other. The following example
specifies that artifacts created in the requirements management project
area can be linked to artifacts created in the Change and Configuration
Management project area. The linkType tags indicate that the Requirements
Management artifacts (requirements) are implemented by the Change
and Configuration Management artifacts (work items). See Supported link types for the full list of
link types.
<!-- RRC implemented-by RTC -->
<projectAreaAssociation>
<sourceDomain ref="#rrc.project"/>
<linkType>implemented-by</linkType>
<targetDomain ref="#rtc.project"/>
</projectAreaAssociation>
<!-- RTC implements RRC -->
<projectAreaAssociation>
<sourceDomain ref="#rtc.project"/>
<linkType>implements</linkType>
<targetDomain ref="#rrc.project"/>
</projectAreaAssociation>
-
In the lifeCycleProjects tag, update the list of project areas to be created in the lifecycle
project. In the following example, the <lifeCycleProjectContext> tag entries identify three
project areas to be created, one in each of the IBM®
Engineering Lifecycle Management
applications.
<lifeCycleProjects>
<lifeCycleProject id="lpa.project">
<dc:title>${request.param.projectName}</dc:title>
<dc:description>${request.param.lpaProjectDescription}</dc:description>
<lifeCycleProjectContext ref="#rrc.project"/>
<lifeCycleProjectContext ref="#rtc.project"/>
<lifeCycleProjectContext ref="#rqm.project"/>
</lifeCycleProject>
</lifeCycleProjects>
- Save the template XML file.
What to do next
After you finish creating a lifecycle project template, import
it into the repository so that you can use it to create lifecycle
projects.