Delivering change sets to other streams in the DOORS Next application

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 requires you to manually create the 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

  1. On the toolbar:
    1. Ensure that the Current Configuration menu is set to the stream that contains the change sets to deliver.
    2. Click Current Configuration > Deliver Changes.
    A dialog box opens.
  2. Select the stream to deliver the changes to, click OK.
  3. Follow the prompts and complete the steps in the wizard.
    You can review all changes using the Standard delivery of change sets. Additionally, 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 are notified for any conflicts.

      Automatically resolve conflicts where possible: Select to resolve conflicts that occur when different attributes of an artifact are modified in each configuration. For instance, 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.
      • Select Preview changes and manually resolve any conflicts to manually review the changes, or choose from the following options:
        • Notify me: When a conflict occurs between artifacts, the delivery stops and you resolve the conflict.
        • Automatically merge where possible: Select to resolve conflicts that occur when different attributes of an artifact are modified in each configuration. For instance, 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.
      • Choose change sets to deliver: Select and then click Add, and choose the change sets to deliver to the target stream. To remove a change set from the list, from the menu on the left of the name, click Don't Deliver.

        Depends on Change Sets: If your changes depend on other change sets (including the change sets from other team members), you must deliver them as well. Inspect the dependencies as shown or by hovering over the link in the Dependents column to see which change sets would also be delivered. The dependent change sets are delivered at the same time as yours. However, you can choose to ignore a dependent change set by selecting the corresponding checkbox in the Ignored column before delivering the changes.

      If you don't choose specific change sets, the system delivers all the ones that were already delivered to the source configuration.
  4. 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.
      On the Deliver Change Sets page, sections on the left show new, modified, and removed artifacts

    • 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.
      Help icon shows how changes are color-coded

      To toggle between a side-by-side comparison and single-pane view of the changed artifacts, click Side-by-side comparison Icon that shows a window split vertically into two panes on the toolbar

    • Deliver the changes for an artifact: Use the Changed in both section and the options that are available on the page for delivering the changes. Shows the controls to deliver the changes to artifacts
      Shows the Mark as Resolved control
    • Select or exclude individual changes for delivery: For each changed attribute, select an option.
      Menu beside an artifact attribute shows the delivery options

    • Manually merge changes using 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 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.

      Shows details of the Manually Merge dialog box
  5. 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 work in a personal stream and deliver the change set, it is removed from the personal stream.

What to do next

To view the changes, switch to that stream. For more information, 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.