RELEASE / REL

Syntax

release | rel -s <softwareComponent(s)|all> -a <activity IDs> | -u <user(s)> [--cap <caption>] [--from <date>] [--to <date>] [--yu] [--yp] [--single] [--pattern <pattern string>]

Arguments

-s <softwareComponent>

Specifies which software components (SCs) to release. Options are:

• <softwareComponent> - Names of the SCs to which the activities to be released belong. If you want to release activities from more than one software component, you can provide a comma-separated list of software components. You have to enclose this list in double quotes. The software component name is case sensitive.

• all - all activities of all developed software components should be released.

-a <activity IDs>

One activity ID or a comma-separated list of activity IDs to release. Enclose the list of IDs in double quotes, for example: -a "id1,id2,id3" .

Only activities from the same software component can be released together.

-u <user (s) >

Releases all activated activities of the specified user. If you want to release activities of more than one user, you can provide a comma-separated list of user names. You have to enclose this list in double quotes ("). Use asterisk (*) to release waiting activities of all users for the specified SC.

[--cap <caption>]

Short caption description for the change request. If not specified, the following caption will be taken: " Change Request by <username> <timestamp> ". If you want to include spaces in the caption, you have to enclose the caption in double quotes.

[--from <date>]

The date from which the selection of activities should start, including the entered date.

The date format to use: yyyy-mm-dd

[--to <date>]

The date to which the selection of activities should end. The entered date is not included.

The date format to use: yyyy-mm-dd

[--yu]

If you try to release all activities of a user with option -u , by default you will be asked to proceed.

With --yu set you will not be asked and all activities of user u will be released.

[--yp]

If the activities you want to release have predecessor activities which are not yet released, they will be shown and you will be asked to release them too. With --yp set, you will not be asked and all predecessors will be released too.

Be careful with this option, because it is possible that some predecessor activities belong to a different user.

[--single]

When this option is set, every activity is released with a new change request that gets the activity display name as a caption.

[--pattern <pattern string>]

Here you can specify a string for releasing only all activities starting with this string in their caption. If the string contains spaces, the string needs to be enclosed in double quotes (").

Description

Releases the specified activities. Works only for activated activities.