Defining products

Products are used to model top-level deliverables that your teams are delivering externally to customers or internally to your organization. Products are also used to group your software delivery teams and delivery resources (code repositories, build jobs, issue tracker projects) together into a rich product-centric data model that represents the delivery activities of your teams.

Most CloudBees Engineering Efficiency reports and views are provided in the context of a selected product, so the products you define should correspond to the way you would like to organize and track the work of your software delivery teams.

The products you define will vary based on your internal team structures and the responsibilities of those teams. Some teams may be responsible for delivering an entire software release to your customers regularly, while other teams may be responsible for delivering just one aspect of the software, like an API service, a particular feature set, etc. In each of these cases, you should define products that represent the deliverable that each team is responsible for delivering, enhancing, and maintaining. You would then associate each product with the software delivery resources — including repositories, jobs and projects — that are used to track, build, and deliver those products.

Products use data from integration apps with third-party services. Refer to Integrating third-party services for details.

Linking software delivery resources to products

When connecting your software delivery systems like GitHub and Jira to your CloudBees organization, data is imported into the System of Record and can be used to provide insights into current work processes. The System of Record data model can be enhanced by linking resources and their corresponding data to your products.

Data is added to System of Record by installing apps to integrate data from third-party sources. The more sources that are integrated and the more relevant resources you link to your products, the more complete a picture of the software delivery you can create and the more insights are available.

When you add a Jira integration, for example, you can gain insight into where work is being invested using the product’s Investment areas.

For more information about integrations, refer to Integrating third-party services.

Once data sources are integrated, each product has screens that display data to help engineering managers answer questions, such as where their teams are spending time and how work is accomplished and processed. The more services that are integrated, the more complete a picture of the software delivery you can create.

Viewing products

The Products lists all products and provides a summary of any data that is associated with each product: number of active epics, when the first commit was merged, and accuracy.

To view a specific product:

  1. Sign in to CloudBees Engineering Efficiency and select CloudBees Engineering Efficiency.

  2. Select the Products tab.

  3. Select the product you wish to view.

To change products when viewing any product:

  1. Select the drop-down arrow next to the product name in the upper left corner.

  2. Choose a product from the list.

Managing products

Products lists all created products. You can filter the product list by entering a keyword in the search box.

After you have created your first product, you may want to create additional products or modify or delete existing products.

Only CloudBees Engineering Efficiency admins can create, modify, or remove products.

Creating a product

To create a product:

  1. Sign in to CloudBees Engineering Efficiency with an admin account.

  2. Select Products.

  3. Select Create new product.

  4. Enter a name for the product, and then select Create.

The new product name appears on Products.

Modifying a product

You can modify a product by changing its name or associated color.

To change the product name:

  1. Sign in to CloudBees Engineering Efficiency with an admin account.

  2. From Products, select the product you wish to modify.

  3. Select Manage Manage product from the left navigation.

  4. Modify the product name, and then select Save changes.

The updated product name appears on Products.

Deleting a product

Deleting a product removes all associated services, repositories, etc. The services are still available within CloudBees Engineering Efficiency and can be associated with other products.

To delete a product:

  1. Sign in to CloudBees Engineering Efficiency with an admin account.

  2. From Products, select the product name you wish to modify.

  3. Select Manage Manage product from the left navigation.

  4. Select Delete product.

  5. Check the box to acknowledge that you wish to delete the product, and then select Delete product.