Creating requirements projects

Jazz project administrators can create projects and modify project structure and team membership.

Before you begin

To create a project, you must log in to the repository as a user with JazzAdmins or JazzProjectAdmins repository permissions. You must also be assigned the Rational® DOORS® Next Generation Analyst role and the associated client access license. If you want to enable configuration management, an RM administrator must enter a valid license key. See Activating configuration management.


  1. If you have not already done so, log in to a requirements project repository.
  2. On the Administration menu drop down menu icon, click Manage Project Areas.
  3. On the Active Project Areas page, click Create Project Area.
  4. In the New Project window, enter a project name and optional description.
  5. Optional: To apply the process configuration from another project area to the new one, enable the Use the process configuration from another project area for this project area option, click Change, and choose a project area in the list.
  6. Click Save.
    A new project is created and the Application Administration page opens.
  7. Optional: To enable configuration management for the new project area, on the Application Administration page, in the navigation pane, click Configuration Management and click Enable Configuration Management.
  8. Optional: To use a template to create the initial structure and content for the new project, click Explore Project. In the Project Setup window, click Apply a project template and in the Apply Template dialog box, choose a template.
    For a list of available templates, see Requirements project templates.
    Note: If you choose not to apply a template, you can apply one later by clicking Apply Template in the project Administration menu.
  9. Click Finish.
    Important: You cannot create project areas from the Administration menu on the All Projects page, or from an existing project area. To create project areas, use Application Administration. You can apply project templates using the Administration menu in existing project areas.


A new project is created. If configuration management is enabled, the new project contains a component and there is an initial stream for the component.

What to do next

You can now add team members to the project and begin adding artifacts. You can also add folders and define artifact types and attributes. To return to the Artifacts page, click the project name on your Project Dashboard page or on the Home drop-down menu. home dropdown menu icon

If configuration management is enabled, you can now use the component to represent a collection of versioned artifacts within the project area. For example, instead of working with all the artifacts from the project in one stream (for example, that represents a physical piece called a Handheld Meter Reader), you can use a component to represent a smaller collection of artifacts (for example, to represent a smaller physical piece such as a Sensor in the handheld meter reader).

To start working in the initial stream of the component, click the project name. Your configuration context is set to the initial stream of the component. To create and see links to artifacts in other applications (QM, RM, DM, and CCM applications), a Global Configuration Management configuration lead must add a configuration of the component and configurations from the other applications to the same global configuration.