After you finish adding artifacts or making changes to artifacts in a change set, you can
deliver that change set to the stream. The changes are then available to anyone who uses the stream.
You can deliver only one change set at a time.
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 logged in to a
project.
- You must have permission to deliver change sets.
- In some projects, an administrator might require you to link change sets to work items that are approved
(as defined by the application that manages work items). If this option is enabled, review the work
item to ensure that this condition is met before you deliver the change set.
About this task
An administrator can prevent unauthorized changes to artifacts by requiring you to link change
sets to work items or change requests that have at least one approval. The governance of your
project or organization determines when this option is enabled. For example, at the start of a
project or release, the option might not be enabled so that team members can easily deliver many
changes. Toward the end of a milestone or release, the option might be enforced so that only
authorized changes are delivered. Dependent change sets must also be linked to approved work
items.
Procedure
- You can deliver a change set to its stream in different ways:
- If the configuration context is set to the change set to deliver, on the toolbar,
click .
- If the configuration context is set to the stream that contains the change set to
deliver:
Note: To switch to the stream that contains the change set, on the toolbar, click , and search for the stream.
- Click .
- In the configuration editor, click the Change Sets tab.
- In the Actions column beside the change set, click Deliver change
set.
- 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:
- Notify me: When a conflict occurs between artifacts,
the delivery stops and you resolve the conflict.
- Automatically merge 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.
- Always overwrite with source: When a
conflict occurs between artifacts, the version in the change set automatically overwrites the
version in the target stream.
- Specify dominant source attributes: When a
conflict occurs between artifacts, the conflict is resolved by automatically delivering the values
of attributes that you selected. When you deliver your changes, if the system detects a conflict
between the artifact versions in the source and target configurations, it delivers only the selected
attribute values for that artifact version to the target stream.
If you choose to review your changes, use the controls on the
Deliver Change
Sets page.
- Click Deliver near the upper right of the page.
Results
The changes are now available in the stream and are visible to team members who use the
stream.
If you are working in a personal stream, after you deliver the change set, it is
automatically removed from your personal stream.
What to do next
You can now deliver those changes to another stream in the RM application. You can either deliver
all the change sets or only selected ones from one stream to another. See the related topic.