Create a new project

Create a new project when you wish to start a new phase of development. You can create a project from scratch and add items to it afterwards.

For details about creating streams, see Create streams.

PRIVILEGES: Create Project.

To create a new project:

  1. In the Projects tab, click New and select Project. The New Project dialog box opens.

  2. From the Product list, select the product in which you want to create the project.

  3. For Project name, enter a name for the new project.

  4. Select a Type from the list.

  5. For Description, enter a description for the new project.

  6. To complete the wizard, click Finish.

    To update the options or attributes, click Next and select one of the options:

    Nothing Select if you want the project to initially contain no items.
    Based on project Select to populate the new project with the item revisions from a project. Then select the project from the list.
    Based on stream Select to populate the new project with the item revisions from a stream. Then select the stream from the list.
    Based on baseline Select to populate the new project with the item revisions from a baseline. Then select the baseline from the list.
    Copy build configuration Select to copy the build configuration of the Based on project/stream to the new project.

    Note: If lists of streams or baselines are large, these fields will appear as text boxes with browse buttons, in which case use the browse buttons to select a stream or baseline.

  7. Select any required options on the Options page:

    • For Project types, select Branch  or Do not Branch. It is recommended that you select Do not Branch, and that you use a single assigned branch.

    • For Change Management Rules, select Use item type settings, Always enabled  or Always disabled.

    • Select Request required to refactor  to require the user to provide a request ID when they make refactoring changes to the project.

    For details about these options, see Project options.

  8. Select Finish to accept the default options for the rest of the New Project wizard, otherwise click Next.

  9. Select how you want the deployment of items in this project to be handled:

    Select whether the stage of item revisions is "local" to this project/stream or can be affected when their stages are changed in other projects/streams.

    If you select Use local stages, the stage of an item revision in this project/stream is not affected as a result of actioning even when stages in the GSL are associated with states in its lifecycle. The stage in this project/stream can only be changed as a result of promoting and demoting.

    If you do not select this option, then when the state of an item revision is changed as a result of actioning, its stage in this project/stream will also be changed.

    Note: After you have selected this option you cannot clear it. If your project is using Deployment Automation (DA), this option is always on.

  10. Click Next if you want to update any named branches or attributes, otherwise click Finish to complete the wizard.

    From the Valid Branches list, select branches to which future revisions in this project may be assigned.

    If you want to select a branch as the default, select it from the Default branch list.

  11. (Optional) To update any attributes, click Next and then enter any required attributes on the Attributes page..

  12. Click Finish.

Back to top

See also: