Viewing/modifying existing issues

There are two main mechanisms for bringing up an existing issue for review through the GUI.¹ The first, and perhaps the most intuitive, is to scroll through the main list until you see the one you are interested in, then double-click the mouse over that line.

A second method is to call it up directly by its issue number. To do this, use the Issue number option from the View menu, press ^I, or use the related button on the toolbar. However you do it, the popup shown below will appear.




The issue form will initially come up in Review mode. In order to make edits to the form, you must first change the state of the toggle in the upper left corner of the form to Modify. By doing so, you are preventing anyone else on the system from simultaneously making edits to the same issue. An example of the issue form is shown below.




As with the creation of a new issue, there may be both soft and hard rules which you may need to consider as you modify a form. Additionally, your Razor configuration may impose certain restrictions on which user ids may make state transitions. Please refer to "Issue STATEs (permissions)" on page 205 and "Attaching scripts to buttons" on page 235 for more information on how controls can be placed on Razor functions.

Checking on related file activity

If an issue has been related to an activity in either the file version control or release management aspect of Razor (the versions or threads programs), then a button labeled Activity will be available in the top right corner of the issue form (refer back to the issue form shown on page 60). Selecting this button will result in a new popup being displayed (like the one below), displaying a synopsis of all the related file, thread and project operations.




Remember that virtually all user actions are recorded in Razor in easily parsed ASCII files. This makes integration with third party tools or locally generated reporting scripts fairly simple.

For information on how issues can be associated with file activity in the versions program, see "Associating issues to editing activity" on page 89, or with the creation/update of threads, see "Defining threads by related issues" on page 131.

Recording your modifications

After you have modified the information on the issue form, select either Ok or Apply at the bottom of the form to record your edits with the database. Selecting Reset will undo all of your edits since you took the issue into Modify mode. The Cancel button will pop up a dialog similar to the one below.




Selecting "Yes, dismiss the form" dismisses the form and no changes will be applied to the database. "No, don't dismiss the form" will return control back to the issue form.

It is possible that someone else may have modified an issue while you were viewing it. If so, you will see this at the top of the issue form.




You will not be able to modify this issue. Your only choice is to select Cancel and reselect the issue.

¹ It is also possible to bring up an existing issue form to the GUI by use of a command line option. See "Bringing up issue forms by command line" on page 165. Subject of course to any access restrictions, discussed on page 199.