OPEN Command

You use the OPEN command to "open" an object within an information source domain, which results in one, and only one, source object. For example, in the Rose domain, the OPEN command connects to a specific Rose model and its associated components.

You use the OPEN command in one of two ways:

§  To specify an initial starting point in a source domain, from which you further define ProjectConsole Template Builder commands.

§  To create a direct reference to a particular piece of data.

The OPEN command establishes the context or reference point for other ProjectConsole Template Builder commands (such as REPEAT commands and LIMIT commands) in your document. You can place an OPEN command anywhere in a ProjectConsole Template Builder template, but it influences only those commands that are below it in the command hierarchy. Therefore, most OPEN commands occur at the beginning of the document.

OPEN Command Arguments

You provide the arguments when you test an individual or primary 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.

You do not provide OPEN arguments for secondary templates. It is best to test them in the ProjectConsole Web site, where that information is passed from the primary template.

Considerations for an OPEN Command to a Dynamic Domain

To use project-specific attributes in a template for a dynamic domain such as ClearQuest or RequisitePro, you must be connected to the source, such as the ClearQuest database or RequisitePro project. That connection triggers the retrieval of the user-defined, dynamic objects so they are available for you to select.

To make this connection, you must supply the arguments in the OPEN command.

If you leave Template Builder open while you go to a point product to create additional objects, when you return to Template Builder you must click ProjectConsole > Refresh to reload the dynamic schema to see the changes.

Adding an OPEN Command

To add an OPEN command:

1. Do one of the following:

-     In the Template View, select the command below which you want the OPEN command to appear, and click the OPEN button in the tool bar.

-     In the template itself, position the insertion point where you want to insert the command, click ProjectConsole > Add Command, select OPEN Command and click OK.

2. In the OPEN Command dialog box, select a source class, fill in the arguments if required for your purpose, and click OK.

The name of the OPEN command defaults to the name of the class to be opened. If you want to change this name, be sure to choose something meaningful. Because ProjectConsole Template Builder commands are relative to other commands, it is helpful if you make their names relative also. When you have many OPEN commands stored in many places within one document, meaningful names make it easier to define other elements. You can see the names in the Template View of your document.

You can add multiple OPEN commands to your document. The additional commands can point to information either in the same source domain or in a different domain.

To modify the OPEN command, refer to Modifying Existing Commands