Receiving and sending component baselines

Rational Team Concert™ and Rational® Engineering Lifecycle Manager exchange component baselines whenever a stream manager receives or sends component baselines by using the Rational Engineering Lifecycle Manager interface.

Before you begin

You must connect at least one product to a stream before you can receive component baselines for the first time. See Connecting products, streams, and component baselines

About this task

All send and receive operations are initiated from the Rational Engineering Lifecycle Manager interface. The main usage scenarios are in "Day-to-day use of the integration" in Integration workflow.

After you connect a product to a stream, you must receive component baselines from the stream before you can send baselines to the stream.

Procedure

  1. Receive component baselines from a Rational Team Concert stream.
    1. In Rational Engineering Lifecycle Manager, open a Products screen by clicking Products > Favorite Products or Recently Viewed Products.
    2. On the Products screen, find a product that is connected to a stream.

      The icon to the left of a connected product looks like this: Icon representing a product that is connected to a stream. This different product icon shows that the product is in a special state; it is connected to a stream. If this is the first receive operation for a connected product, then it does not have components beneath it.

    3. Receive Rational Team Concert component baselines from the stream. Right-click the connected product and choose Manage Stream > Receive SCM Components.
    4. Preview the incoming changes to the product tree in the Preview SCM Components - Receive dialog box.

      The change summary, shown in the following image, describes the state of the SCM components. If any SCM components will not be included in the receive, they are added to one of the descriptions in the change summary.

      Image shows the change summary for the "Preview SCM Components - Receive" dialog box.

      Following the change summary, the Before column shows the component baselines connected to products that are now in the product tree. The After column shows the baselines to be added to the product tree after you receive the SCM Components.

      For additional information, place the cursor over the small question mark in the change summary, and over the words Before and After in the table.

      All users: All component baselines for the stream are pulled into Rational Engineering Lifecycle Manager as child products.

      When you receive baselines, a pinned product version is not updated, regardless of the baseline that is in the SCM stream.

      Click the product to see the details from Rational Team Concert on the right. You can see the stream that the product is connected to, the Rational Team Concert server friend name or URL, and other information.

    5. You can restructure the flat Rational Team Concert component baseline structure in Rational Engineering Lifecycle Manager.

      Move and reuse products that are connected to streams and component baselines, and then send the products back to Rational Team Concert as component baselines. To learn more about restructuring, see "Day-to-day use of the integration" in Integration workflow.

      You can also branch products that are connected to streams or component baselines. See Creating a variation to branch a product

  2. Send component baselines to a Rational Team Concert stream.

    You must receive component baselines from the stream at least once before you can perform a send operation or the send fails. Rational Team Concert cannot recognize the products that you send if the products are not connected to a Rational Team Concert stream. (A clue that you must receive component baselines first is that the connected product you want to send does not have components beneath it.)

    If you received component baselines from Rational Team Concert and then restructured the component baselines by adding or removing them, send the component baselines to the Rational Team Concert stream to keep the stream in sync.

    1. In Rational Engineering Lifecycle Manager, open a Products screen by clicking Products > Favorite Products or Recently Viewed Products.
    2. In the Products screen, look for the product that is connected to a stream.
      • If you have many products, try filtering in the product grouping list box by setting a custom product grouping, such as All top-level products.
      • If you have not yet received component baselines from Rational Team Concert into the connected product, follow the instructions in step 1 to receive component baselines first from Rational Team Concert.
    3. Send component baselines to the stream by right-clicking over the connected product and selecting Manage Stream > Send SCM Components.
    4. Preview the outgoing changes from the product tree to the SCM components in the Preview SCM Components - Send dialog box.

      The change summary, shown in the following image, describes the state of the SCM components. If any SCM components will not be included in the send, they are added to one of the descriptions in the change summary.

      Image shows the change summary for the "Preview SCM Components - Send" dialog box.

      Following the change summary, the Before column shows the component baselines that are now in the SCM stream. The After column shows the baselines that are connected to products that are to be used in the SCM stream after the send.

      For additional information, place the cursor over the small question mark in the change summary, and over the words Before and After in the table.

      All users: All component baselines for the stream are pulled into Rational Engineering Lifecycle Manager as child products.

      Click the product to see the details from Rational Team Concert on the right. You can see the stream that the product is connected to, the Rational Team Concert server friend name or URL, and other information.

    5. In Rational Team Concert, refresh the stream.

      You can see the Rational Engineering Lifecycle Manager products that you moved or reused in the Components section in the Stream page.

      Rational Team Concert shows component baselines in a flat structure. If you created complex product hierarchies in Rational Engineering Lifecycle Manager, you cannot see them in Rational Team Concert. The restructured product hierarchies remain in Rational Engineering Lifecycle Manager.

What to do next

If you want to load only the components that your team needs, see Generating load rules for component baselines.


Feedback