To view or modify an item, double-click it from the Query Results table or enter the Item ID in the Goto Itemwindow. The item is displayed in the Show/Modify item editor. You can make changes to the Fortress item, add comments, and add, view, and get attachments from this editor. To save the changes, select File->Save from the menu or click the Save button at the bottom of the editor.
To display the Add Item editor, select (Project Name)->Add Item. The Description and Details fields are required. All new items have a status of Open. To save the item, click the File->Save menu or click the Save button on the bottom of the Add Item Editor.
To view the Goto Item tool window, choose (Project Name)->Goto Item from the Item tracking tree or choose Goto Item from the Fortress Toolbar.
To go to a single item, enter the Item’s ID in the ID or Keyword field. The item will be displayed in the Show/Modify Item editor.
To perform a Keywordsearch, enter the Keyword or words in the ID or Keyword field. The search results will be displayed in a Query Results table editor.
In Eclipse, the Goto Item window cannot be used for a keyword search, only ID numbers are accepted.
If you enter the word “dog” in the Keyword field, the query will return all items that contain the word “dog”.
If you enter “dog food” in the Keyword field the query will return all items that contain the word “dog” and the word “food” (“my dog likes food” and “my dog eats dog food” would both be returned).
To search for a literal phrase, use single or double quotes. For example, to search for the phrase dog food, enter “dog food” or ‘dog food’ in the Keyword field. The query will return all items that contain the phrase “dog food” (“my dog eats dog food” would be returned but “my dog likes food” would not).
The Keyword search also supports the ? and * wildcards:
? – The question mark represents any single character. For example, entering “?og” in the Keyword field returns all three lettered words in which the last two letters are "og" - (hog, log, dog, bog, jog, cog, fog). However, this query does not find items for the words like “frog”.
* – The asterisk represents zero or any number of characters. For example, entering “dog*” in the Keyword field returns items that contain the word “dog”, “dogs” or “dogfood” but not “dog food”.
If you would like to use ? or * as a letter within the keyword phrase, use the escape character "\" just before the character. For example, if you would like to find the phrase "x = foo * bar;", the phrase would be "x = foo \* bar;". Or "x = (a < b) ? 1 : 2;", the phrase would be "x = (a < b) \? 1 : 2;"
You can add attachments to an item in both the Add Item editor and the Show/Modify item editor. You also can View and Get attachments in the Show/Modify item editor.
To add an attachment, click the Add button in the Attachments section of the editor. Browse for the file you want to attach then click OK. The attachment will be added to Fortress when you save the item. You may also drag and drop files from Windows Explorer onto the attachment list to add them.
To view an attachment, either double-click the attachment in the Attachments table, or select it and click the View button. The attachment will be opened via the Windows default program for the file type.
To get an attachment, select it in the Attachments table and click the Get button. Select the folder where you want the attachment placed then click OK.
The Image Editor dialog is used to edit a clipboard image before attaching the image to a Fortress Item.
The process is as follows:
Open an item (either new or existing) in the Browse Fortress Items dialog.
Capture/copy an image to the clipboard (a screenshot, for example).
Click the Add From Clipboard button located below the attachments table. (Note: You may also paste the image using Ctrl+V with focus in the attachments table).
The image will be opened in the Image Preview dialog. At this point, one may either choose the Edit button to open the Image Editor dialog or simply enter a filename and/or description to complete the attachment process.
The Image Editor dialog provides two tools for modifying images: a crop tool and a pen tool. The pen tool has multiple size choices and a choice of colors. The editor also features unlimited Undo/Redo of operations performed on the image.
To quickly perform a crop, drag the crop rectangle over the desired area and double-click anywhere within the crop rectangle to accept the crop. To quickly cancel a crop rectangle, click anywhere outside the crop rectangle.
Open: All items begin life in the "open" state. When an item is open something still has to be done to the item before it is completed. This status is hardwired into queries like "My Open".
Unconfirmed: A (potential) bug has been reported by a customer and logged in Fortress. When the developer looks into it, she can't reproduce it. At this point, she will move the status to unconfirmed and change the assignee to a tester. The tester will spend more time trying to reproduce and isolate the bug. If it's successfully reproduced, the bug goes back to Open (with comments detailing the steps necessary to make it happen). If it can't be reproduced, it will be marked invalid.
Invalid: A bug that has been logged, but can't be reproduced. Either a customer report was wrong, an internal tester was wrong, or the bug has become Invalid over time as the project matures (e.g. the bug has been sitting Open for so long that the feature with the bug has been removed or substantially modified).
Duplicate: Somebody didn't query the bug database before logging a new issue.
Disregard: This one is seldom, if ever, used. If a bug was added by mistake you could mark it Disregard. It also can be used as a flag for items that can be deleted for reasons of your own choosing.
Completed: A developer has checked changes into the repository that are meant to address the item. At this point, the bug is no longer the programmer's problem, and becomes the problem of the tester. The tester then does some regression testing and either marks the bug Verified, burying it forever, or resets it to Open with comments on what failed and it returns to the developer.
Verified: Items that have passed through testing; the tester is confident that the item has been addressed and nothing else has been broken in the process.
These fields in an Item accept notations:
Details
Comments Body
Create a Link to an Item
To provide a link to a specific item in Fortress, type “item:” or “item” and then the item ID number. To be backwards compatible with SOS Collab you can also type “bug:” or “bug” and the item ID number.
For example:
item:2325
item 2325
bug:2325
bug 2325
The item ID can be any bug in the Fortress system and is not limited to a bug in the current project. The item ID is found on the Item Details page title or in the Item ID column of item lists.
If you see a Link Notation, click on the link to access the specific item.
Users can only access Fortress Items for projects to which they have at least Read access.