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 IBM® Engineering Requirements Management DOORS® Next (DOORS Next) 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.

Procedure

  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 add content to a project area, you can use one of the following options depending upon whether configuration management is enabled for the project area:
    • Apply a project or component template
      1. Click Explore Project.
      2. Click either the Project name or Component name, Explore Dashboard, or Show Modules.
      3. In the Project Setup or Component Setup window, click Apply a project template or Apply a component template. The Apply Template dialog box appears.
      4. Select a template and click Finish. For a list of available templates, see Requirements project templates.
      5. To access this option later, click the Administration menu, and select Apply Template. However, the option disappears after types or requirements are created.
        Note: You must have a template that is already defined in the application. For more information, see Creating templates for requirements projects or components and Managing templates for requirements projects or components.
    • Import project or component properties from an existing component
      1. Click Explore Project.
      2. Click either the Project name or Component name, Explore Dashboard, or Show Modules.
      3. In the Project or Component Setup window, click Import Project properties or Import Component properties from an existing project or component. Choose your source project or component.
      4. To access this option later, click the Administration menu and select Manage Project Properties or Manage Component Properties and then select Import Project Properties or Import Component Properties.
        Note:
    • Manually define artifact types
      1. To manually define artifact types, click Explore Project.
      2. Click either the Project name or Component Name, Explore Dashboard, or Show Modules. In the Project Setup or Component Setup window, select Manually define artifact types.
      3. To access this option later, click the Administration menu, select Manage Project Properties or Manage Component Properties. You can access this option anytime. For more information, see Managing project or component properties in requirements projects.
  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.
    Note: You can also create content in a project area by using an import operation. To import content, click Explore Project. Click the Project Name or Component Name, Explore Dashboard, or Show Modules. If there are no types that are created, the system displays the Project Setup or Component Setup wizard. You must create the new project area. The Project Setup or Component Setup wizard is not available after creating the requirements or types.

Results

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 add team members to the project and begin adding artifacts. You can also add folders and define artifact types and attributes. You can also use an import operation to create artifact types or attributes. For more information, see Importing and exporting files. You can use only the ReqIF import if there are no artifact types already created by using any one of the options that are listed in step 8. 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 that is 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.