The Send to Issue command creates or modifies change package entries for one or more elements in one or more issue records. When first created, a change package entry has the same structure as a patch: the set of 'recent changes' to an element. After subsequent modifications, a change package entry can include a much broader set of changes.The command has several variants, providing different ways to specify the data to be sent to the change package(s):
• You specify a version, which AccuRev interprets as the head version of a patch. AccuRev automatically determines the corresponding basis version.
• You can invoke Send to Issue in the following contexts. Note that each context provides access to some, but not all, variants of the command.
• In the Version Browser, choose Send to Issue or Send to Issue (specifying basis) from the context menu of any version.
• In the Versions pane of the History Browser, select one or more versions and choose Send to Issue from the selection's context menu.
•
• In the Changes subtab of an issue record or the Change Package Contents pane of a Stream Issues tab, select one or more change package entries and choose Send to Issue from the selection's context menu.In the Send to Issue (specifying basis) variant of the command, you specify the basis version , defining the extent of the change to be sent to the change package(s). After you invoke the command, the mouse pointer changes to. Click the version you wish to be the basis version for the change. (You can press the Esc key at this point to cancel the command.)
The basis version you specify must be an ancestor of the head version. If it isn't, an "Invalid Change Package" error occurs.AccuRev prompts you to specify one or more issue records, in which change package entry(s) will be created or modified.If you've specified one of your AccuWork queries as the default query, AccuRev executes the query and displays the results.Note: If you have enabled the use of third-party issue tracking system (ITS) keys in the AccuWork schema, the Select Issue (Change Package) dialog displays additional controls that let you specify whether you want to use AccuWork issue numbers or third-party keys when selecting issues to promote against. See the section “Using Third-Party Keys in the Java GUI” in the AccuRev® Technical Notes for more information.
• By clicking: left-click to select an issue record. Hold down the Ctrl or Shift key to select multiple records.
• By filtering: enter text into the "Only show issues that contain" field, then click to choose an issue from the filtered list. Delete the text in that field to remove the filter and display all issues.You also have two other options for specifying issue records other than the initial set shown by the dialog:
• Choose an issue record associated with another user. To do so, choose a user or group name from the drop-down list to the right of the Issue # field. The set of names shown here is defined when the change-package configuration is set (see The AccuWork Schema Editor (Change Packages subtab) on page 323).
• Create a new issue using the New Issue button at the bottom of the dialog. Note that if you have chosen to display issue records associated with another user, the new issue must be associated with that user when you create it, or the issue will not display on the Send to Issue dialog.If you don't have a default query, AccuRev prompts you to type in an issue number (or multiple numbers, separated by SPACEs).The Send to Issue command fails if AccuRev determines that an existing change package entry cannot be modified by "adding in" the set of versions you specified. A change package entry must always be expressible as "all the versions between the specified head and basis versions". Here are two situations in which this is not possible:This case typically arises when you do work on a task at two different times, and someone else has worked on the same element in between. In this example, you created versions 18-20 of a file and created a change package entry with those versions. A colleague updated her workspace to bring in your changes, created versions 1 and 2 in her workspace, and promoted her changes. You then updated your workspace to bring in her changes, and made a new set of changes, in versions 21-23.Now, you want to add your new changes into the same change package. When AccuRev tries to combine the six versions into a single change package entry, it detects the 'gap' consisting of your colleague’s versions 1 and 2, and displays an error box.Typically, you'll want to "span the gap", making the change package entry include the entire series of versions — your original changes, your colleague’s changes, and your new changes. You can accomplish this by first removing the existing change package entry from the Changes subtab of the issue record, then using the Send to Issue (specifying basis) variant of the command. In this example, you'd specify version 23 as the head version and version 17 as the basis version.Note: You can accomplish the same result even more easily if you encounter this situation while executing the Promote command on version 23, and you are using the change-package-based integration between AccuRev and AccuWork. In this case, AccuRev offers to 'span the gap' between the two change set entries automatically.This case typically arises when developers in different workspaces try to use the same change package. There is no simple "gap" between the existing change package entry and the new set of version.You can remedy this situation by performing a merge at the element level. (There is no merge operation defined at the change package level.)
AccuRev, Inc. |
Phone: 781-861-8700 |
Fax: 781-861-8704 |
support@accurev.com |