How to Promote record(s) into a Library Project

Overview

Promote record(s) to Library Project feature enables you to promote TopTeam record(s) from current Project into a Library Project so that they can be reused in another Projects.

Library Project: Any Public Project where record(s) are available for Reuse.

Current Project: A Project from where the selected record(s) are promoted to a Library Project.

NOTE:

  • Current and Library Projects are considered as Destination and Source Projects respectively.
  • Once a record is promoted to a Library Project, it becomes destination reuse record in the current Project. Whenever any changes are made in the promoted record in Library Project, they are synchronized into the current record.

This article describes various methods by which you can invoke the Promote to Library Project wizard and the steps for promoting records to a Library Project.

Who should read this?

  • Project Admin
  • TopTeam Users
  • TopTeam Administrators
  • IT Support
  • System Administrators

Prerequisites

You need different permissions in Library Project and current records’ project for promoting records.
Refer to the article Permissions required to promote records in Library Project.

1. Various methods to open Promote to Library Project wizard

1. From Repository Explorer
2. From Detail Editor of a record
3. From OneView Document
4. From any Tree/List editors
5. From Requirements Tree/List

Method 1: From Repository Explorer

media_1533121394666-1.png

Method 2: From Detail Editor of a record

media_1533121616896.png

Method 3: From OneView Document

Step 3.1. From Document Map

media_1533122262214.png

Step 3.2. From More drop-down menu of a record

media_1533124340712.png

Method 4: From any Tree/List editors

media_1533124739324.png

NOTE: Similar actions can also be performed in any List editor.

Method 5: From Requirements Tree/List

media_1533126122820.png

NOTE: The Promote to Library Project option is NOT available in Requirements Document View.

Promote to Library Project wizard opens

media_1533538151771.png

2. Promoting selected record(s) into a Library Project

Step 2.1. Select the record(s), open Promote to Library Project wizard and click Next

Refer to the section above for opening Promote Records to Library Project wizard.

Step 2.2. Specify a Library (any Public) Project to promote the selected record(s) from the current Project

media_1533196925537.png

Step 2.3. Choose an option if you want to promote child record(s) of the selected record(s)

media_1533204335699.png

NOTE: This page will display only if the selected record(s) have child record(s).

Step 2.4. Choose an option to synchronize between the records being promoted to library and current Project

media_1533205231967.png

NOTE:

  • Choose Automatic Update option if you want the destination (current Project) records to update automatically whenever their source records are updated in the Library Project.
  • Choose Manual Update option if you want the destination records to be updated manually by you.

Step 2.5. View details in Action Log and click Finish

media_1533276578699.png

Step 2.6. Pop-up showing status of the promoted records display

media_1533276804341.png

NOTE: If an error occurs while promoting a record from the selected records, it automatically shifts to the next record and starts promoting the remaining records.

Step 2.7. Promoted records display in the Library Project

media_1533277501204.png

Limitations:

  1. A record which is already a reused record (either Source or Destination) cannot be promoted i.e. only non-reused records can be promoted.
  2. A record from a OneView Document can be promoted only in OneView Document. Records at Project level (NOT in OneView Document) can be promoted at Project level.
  3. Requirements from Requirements Document can be promoted to either Requirements Documents or any OneView Document.
  4. If your database version is 11.4, you cannot promote parent records whose child records are destination records.

Revised: September 24th, 2019