Analyzing Data Impacts | Exploring and Documenting |
In this session, you take information from a Revolve analysis and add it to an annotation. Then you use the Annotation tool to modify the annotation.
Please see the Tutorials Map to check that you have run all necessary previous sessions.
Annotations are effective ways to document your project. You can use them to make notes to yourself about project components or you can use them in multiple-user projects to tell other users about specific situations or to assign coding tasks.
Annotations are useful in helping analysts track enhancements and to help programmers share code for research. You can use information contained in an annotation as a starting point for analysis.
This session uses the project you created in the chapter Using Revolve.
To create an annotation:
The Variables browser is displayed.
The Variables dialog box displays, by default, those places in the application where the selected variable(s) is directly modified, referenced, or redefined. You can change this using the Variable Information Options dialog.
The settings should now be as in Figure 6-1. This selection process is called information screening.
A group of information has been isolated and can be used to create a coding task.
The Capture Results interface is displayed. This enables you to add information to annotations, subprojects, Pop files, and Tag files.
The Required Field dialog is displayed, prompting you to, "Please Enter a Title for this Annotation:."
Locations modifying WS01-XCTL-PROGRAM
in the open field.
A Revolve dialog informs you how many elements were added to the annotation.
The annotation is created and ready to be applied in coding tasks. Information can be added to the annotation and it can be edited.
To view the annotation:
LOCATIONS*
in the Match edit field.
Be sure to include the wild card character (*) or the match will look for an annotation named LOCATIONS.
The Annotation tool searches for an annotation that begins with LOCATIONS. The annotation we created in the previous procedure is displayed.
The information about the annotation as well as the information that we captured from variable WS01-XCTL-PROGRAM is displayed.
To edit the annotation LOCATIONS MODIFYING WS01-XCTL-PROGRAM:
The Edit Annotation dialog is displayed. It contains current information about the annotation, including its title, creator, intended recipients, status, and a description of the contents. You can edit any of these details. See Figure 6-3.
Enhancement Request for all locations modifying WS01-XCTL-PROGRAM
This is where programmers will check to see why this annotation was created.
Notice that the source code is available for the contents of the annotation. You can implement modifications in the Annotation tool and link to other tools and browsers to extend analysis.
In this session you:
If you want to take a break before going on to the next session, you can close the project; or you can close Revolve with or without closing the project.
Return to the Tutorials Map and choose which session to go on to next.
Comments on the books?
Click Send Us Comments.
Copyright © 2000 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names
used herein are protected by international law.
Analyzing Data Impacts | Exploring and Documenting |