Information Technology Support
Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section

Page excerpt:

Excerpt

How to Manage Project Components

Its toc

...

Managing Project Components in Orange Tracker

Difficulty Level

  • Beginner

Solution

All component management operations are available from the Component section of the Project Admin Page.

  1. Login as a project administrator. (A project administrator is someone who has the project-specific permission 'Administer Project', but not necessarily the global permission 'JIRA Administrators'. )
  2. Click the 'Administration' link on the top bar.
  3. This will display the Administration page, showing a list of projects which you have permission to manage. Click the project of interest.
  4. You will now see a page displaying the project details. On the lower left, the 'Components' section displays a summary of the project's components along with links to add, edit and remove components (as described below).
    Image Removed

Adding a new component

  1. In the 'Components' section (see above), click the 'Add' link.
  2. The 'Add a Component' screen will be displayed. Type the name of your new component.
  3. You can also optionally enter the component description and/or assign a user to be the component lead.
  4. Click the "Add" button. The component summary list is updated immediately and you will be redirected to the project admin page.
    Image Removed

Selecting a Default Assignee

You can also extend the default assignee of an issue to be component specific instead of project specific.

  1. In the 'Components' section (see 'Managing project components' above), click the 'Select' link. A 'Select Component Assignee' pane will appear on the Project Admin Page.
  2. For each component, select the assignee to whom you want to have new issues in the component assigned by default. See the list of options below.
  3. Click on the 'Update' button.
    Image Removed

Editing a component

  1. In the 'Components' section (see 'Managing project components' above), click the 'Edit' link at the right of a the component you wish to edit.
  2. This will bring you to the "Edit Component" page. Here, it is possible to edit the version name, description and lead.
  3. Press the 'Update' button.
  4. On completion of the update operation, you are returned to the project admin page - with an updated component list reflecting the changes made.
    Image Removed

Deleting a component

  1. In the 'Components' section (see 'Managing project components' above), click the 'Delete' link at the right of the component you wish to delete.
  2. This will bring you to the "Delete Component" page.
  3. On this page you can specify the action to be taken regarding the issues in this component. You can either associate these issues with another active component, or have the references removed.
  4. Press the 'Delete' button.
  5. On completion of the delete operation, you are returned to the project admin page - with an updated component list reflecting the changes made.

Sources and Relevant Links

Jira Help for Defining a Component

...

Its deck

#topProject components can be used to categorize issues within a project.  Components can be used in searches, reports, dashboards, filters, etc.  The components are unique per Project, so they must be defined on a per project basis.

You must be project manager within the project to add, delete, or manage components.

Adding Project Components

Adding New Components on the Fly

If you are in the project manager role for a project, you can add a new component right from the component field on an issue in the project.  Simply click the pencil for the field to edit it and then start typing the new component name.  A box will appear below the field that says "(New Component)" and the name you are typing.

Image Added

The new component will be added when you press return and then select the check mark to update the field.  A poup box will then appear that tells you the new component has been added to the project.  You cannot add a description, component lead or default assignee for the component while adding it on the fly.  If you wish to set up a component description, component lead or default assignee, you will need to use the components link in "Project Administration" (see below).

Image Added

Adding New Components from the Project Administration Screen

  1. Select "Projects" from the top menu
  2. Select the project from the recently viewed list or use "View All Projects' to select the project from a list of all projects you can view.
  3. Select "Components" from the left-hand column
  4. Enter a name for the component (required)
  5. Enter an optional description for the component
  6. optionally, add a component lead for the component.  You can then select "component lead" as the default assignee to have that person automatically assigned to an issue when the component is chosen (just leave assignee blank, select the component, and create the issue).  NOTE:  The component lead must have the right to be an assignee of issues for the automatic assignment to occur.
  7. optionally, set a default assignee for the component.  You must select one of the following choices for assignee:
    1. default assignee for the project
    2. Component lead (you must specify a component lead who has permission to be an assignee for the project's issues)
    3. Project lead
    4. Unassigned (a default assignee based on component will not be set)

Remove a Component From a Project

Removing a component should be done with care since it will affect that values on existing issues.  It should be done in off-hours since it can affect performance of the project and possibly all use of Orange Tracker.

  1. Select "Projects" from the top menu
  2. Select the project from the recently viewed list or use "View All Projects' to select the project from a list of all projects you can view.
  3. Select "Components" from the left-hand column
  4. Select the "Delete" component for the issue
  5. If there are existing issues with the component, you will be prompted to:
    1. swap the issues to another valid component (select the component from the drop-down list)
    2. Remove the component from the issues (the issues will have no component)
  6. If there are no issues associated with the component, you will see a message that it is safe to delete the component.
  7. Select the "Delete" button to remove the component (or swap the issues to a different component depending on the settings you chose).