You can either deliver all the change sets or only selected change sets from one stream
to another.
Before you begin
- Ensure that you are familiar with project areas,
components (if supported), baselines, streams, and
change sets (if supported).
- Ensure that you are familiar with global configurations and
personal streams (if your organization uses them).
- Ensure that you are logged in to a
project.
- If your team manually requires you to manually create change sets to group changes, you must
first deliver the changes to the flow target (the stream that the change set was created in).
- You must have permission to deliver change sets.
- Understand how your organization uses streams, baselines, and
change sets based on how many teams need to work in parallel on different versions of the same
artifacts. To learn more, see Patterns for stream usage on Jazz.net.
Procedure
-
On the toolbar:
-
Ensure that the Current Configuration menu is set to the stream that
contains the change sets to deliver.
-
Click .
-
Select the stream to deliver the changes to.
-
Follow the prompts and complete the steps in the wizard.
In addition to the Standard delivery of
change sets where you can review all change before delivering them, you can speed up or customize
the delivery process with the Express or Custom
delivery options.
- Express: You have many changes to deliver and
don't need to review them. Automatically deliver all the changes without reviewing them; you will be
notified if there are any conflicts.
Automatically
resolve conflicts where possible: Select so the system resolves
conflicts that occur when different attributes of an artifact are modified in each configuration;
for example, the primary text modified in the source and the description modified in the target. If
the same attribute is modified in both configurations, delivery stops and you resolve the
differences.
- Custom: You might have many changes or you want
to control which ones are delivered; select all or a subset of them; choose to review them or not;
and specify how the system handles conflicts:
If you don't choose specific change sets, the system delivers all the ones that were already
delivered to the source configuration.
- Optional:
If you choose to review your changes, click Next.
If you choose to review your changes, use the controls on the
Deliver Change
Sets page.
- View the artifacts in the change set: Expand and collapse the sections on the left side
of the page:
- See differences when artifacts changed in both the change set and the target stream:
Expand the Changed in both section, and click an artifact. Changes are
color-coded in the changes section:
To toggle between a side-by-side comparison and single-pane view of the changed
artifacts, click Side-by-side comparison
on the toolbar
- Deliver all or none of the changes for an artifact: Use the check boxes in the
Changed in both section and the buttons in the right side of the page:
- Select or exclude individual changes for delivery: Beside each changed attribute, select
an option:
- Manually merge changes in the Primary Text field: When you select the Manually
Merge menu option for the Primary Text field, a dialog box opens with an editable Primary Text
field. The field is populated with the target value, since that is what you can edit. The dialog box
also shows the read-only source value for comparison:
- You can use either the source or target text as the base to edit and make changes as needed. To
use the text of the source artifact as a starting point for your changes, click Start With Source
Text. The text of the target artifact moves to the other pane so that you can compare them.
- You can include existing embedded artifacts, links, and terms from both the source and the
target by using either copy and paste or drag and drop.
- You can copy a link or an image to the clipboard without selecting the entire link text or
image. In the read-only primary text content on the left side of the dialog box, right-click a link
or an image and click Copy.
- You can also click and drag a link or an image from the left side and drop it into the editable
primary text field on the right.
Click Apply Changes when you finish.
-
Click Deliver near the upper right of the page.
Results
The changes are now available in the stream that you selected to deliver them to. If you
were working in a personal stream and delivered the change set, it is removed from the personal
stream.
What to do next
To view the changes, switch to that stream: see Selecting a component and configuration to work in.
To see which streams contain a specific change set, see Showing where change sets were delivered.