This describes the fields in the OPEN command dialog box. For information on using OPEN commands, see OPEN Command.
ProjectConsole Template Builder provides a list of valid classes for all available domains. Select the class you want to access. The class list is a general list of artifacts or fields, based on the domain definition; the list does not reflect the actual values that are stored in the source.
A default name based on the selected class appears in the Name text box at the bottom of the dialog box. If there is a name collision with this default name, you must change the name after you select the class.
Every OPEN command must have a unique name. The name can consist of letters, numbers, and underscores.
The Arguments area identifies the actual source of the specified class. You are prompted to provide one or more entries, depending on the class. You can use the Browse button to navigate to a file. If the argument is a filename, you can use either absolute or relative pathnames. You must enter all arguments with exact capitalization and spacing.
When generating a Web page in the ClearCase domain, the Name field contains the full path and file name (view/VOB/file) for the target file. When the VOB contains more than one branch, it may be necessary to indicate the specific branch that contains the file. To do so, after browsing for a file, add the branch notation @@\ to the path and file name returned by the browse feature. For example, c:\my_view \ my_VOB \ my_file.txt@@ \ main.
Note: For information about what to enter for each parameter, refer to the domain reference information for the corresponding class by clicking Help > Help on Domains.
You provide the arguments when you test your template. However, when you save a template you generally leave the argument values in the OPEN command blank. The user who is responsible for Web site administration in ProjectConsole provides these values in the form of an Artifact ID. The Artifact ID that the ProjectConsole administrative user enters is the equivalent of the arguments in an OPEN command in the template.
The Advanced check box allows you to enter calculated arguments. You use calculated arguments to open a source based on the value of another object. You do this when you want to include related information from more than one domain in a Web page.
This is the general procedure for creating a relative OPEN:
- Select the Advanced check box to display a new argument column with the heading Kind.
- Under Kind, click Literal to toggle the Kind to Calculated.
- Click in the Value column to display a tree control listing the available options.
- Select the attribute you need.
When you report on Rose use cases, you may want to include information from RequisitePro, such as attribute values associated with the requirement that is associated with a specific use case in Rose. Template Builder can include information from both domains in the same Web page by using a calculated OPEN.
To create the calculated OPEN of Requisite Pro:
1. In the Template (not the Template View), position the cursor within the REPEAT for UseCases, at the point where you want the RequisitePro information to appear (you can press Enter for better positioning).
2. Click ProjectConsole > Add Command to add an OPEN command.
3. Under Select Class to OPEN in the left pane, select RequisitePro Project.
4. Select the Advanced check box to display the Kind argument column.
5. Under Kind, click the word Literal to toggle the argument to Calculated.
6. Click under the heading Value to display a tree control, and then select UseCase > RequisiteProProjectPath.
7. Click OK to create the OPEN command.
To create a REPEAT in Requisite Pro:
1. Without moving the cursor (that is, leave it just to the right of the OPEN command), click ProjectConsole > Add Command, to add a REPEAT command.
2. Under Select Objects to REPEAT in the left pane, select RequisitePro_Project > Requirements.
3. Click the Advanced check box to expand the dialog box and display additional sections.
You will use the And Where section to create a filter to limit the values displayed to only the Requirements associated with this specific Use Case.
4. Under And Where, click under Left Operand to display a tree control and then select Self > Text.
5. Click under Right Operand to display a tree control, and then select UseCase Name.
6. Click OK to create the REPEAT command.
To add additional commands for the RequisitePro domain:
· Without moving the cursor (that is, leave it between the REPEAT and ENDREP, click ProjectConsole > Add Command.
Additional commands can be a combination of DISPLAYs and REPEATs that you need to retrieve all the information you want from this domain.
During generation, any Use Case that is associated with a RequisitePro Requirement will display information from both the Rose and RequisitePro domains in the ProjectConsole Web page.