Deliver changes to streams

You deliver the changes in your work area to a stream in a repository using the Deliver operation.

When there are conflicts between a work area and a stream, first perform an update to resolve the conflicts locally and then try delivering again.

Note: Deliver is a lock-free operation. If two developers deliver different files at the same time, both deliveries will succeed.

To deliver changes to a stream:

  1. Desktop client: Rght-click the stream root folder or a subfolder and select Deliver.

    Windows Explorer: Right-click the folder in your work area from where you want to deliver to the stream and select Dimensions > Deliver.

    The Deliver from this Work Area field is populated with the work area root. If you select a subfolder, its path is highlighted.

    If you select a work area that is not associated with a stream, in the Deliver Changes to This Stream field, select a stream.

  2. For advanced options, click Advanced.

  3. To restrict the deliver operation to particular files:

    • In Include local files, enter expressions to specify which files from the work area will be delivered to the repository.

    • In Exclude local files, enter expressions to exclude a set of files when delivering to the repository.

      For details about using wildcards, see Include and exclude files and folders.

  4. Select the local changes to include in the delivery: additions, deletions, modifications, and moves/renames.

  5. If you have defined ignore rules but want to skip them for this delivery, select Disable restrictions from .dmignore file.

  6. Click Next.

  7. If a list of Additional streams from which to include content is displayed, the work area from which you are delivering has been updated from other streams and/or baselines. Clear the streams or baselines whose files you do not want to deliver to the parent stream and click Next.

    A list of changes is displayed including each revision’s work area filename, change type, and the conflict type and default resolution (if applicable).

    Caution: If there are conflicts between the work area and the stream, you cannot continue with the deliver operation. To perform an update from the stream and resolve the conflicts, click the link in the dialog box. For details, see Update work areas from streams. After you resolve the conflicts and update your work area, try delivering again.

  8. (Optional) In the Default options panel, change the default values for delivering an item revision to the repository:

    Option Description
    Comment Enter the default comment for any new item revisions that are created.
    Relate to request(s) Specify one or more default requests to be related in response to any new item revisions that are created.
    Design part for new files Select the part specification for the owning design part for new items created in this work area (unless overridden by any values set for a folder beneath the root folder in this work area).
    Permissions after deliver Select Make read only or Keep unchanged for the permissions to be set on a file after uploading to the repository.
    Expand substitution variables

    Select Yes or No.

  9. (Optional) In the Selection options panel, change the default values for each item revision that you select.

    If you are deleting a revision, select an option from the Removal Scope list, for example, delete all the item revisions from the stream. Some limitations apply. For example, you cannot delete a revision from a baseline or a revision that is related to an active request.

  10. To view the changes made to a revision, right-click and select View.

  11. Click Deliver.

Back to top