OPEN Command Dialog Box

This section describes the fields in the OPEN command dialog box. For more information on using OPEN commands, see OPEN Command.

image\open.gif

Select Class to OPEN:

Depending on the domains available, SoDA provides a list of valid Classes. Choose the one you want to access. The Class list is a general list, based on the domain definition; it is not a list of values from the actual source, such as your Rose model.

Name

Every OPEN command must have a unique name. The name can consist of letters, numbers, and underscores. The OPEN Command Dialog Box automatically sets the name of the command to be the same as the name of the selected Class. If there is a name collision, you must change the name after selecting the class.

When generating a report 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 following branch notation to the path and file name returned by the browse feature: @@\. For example, c:\my_view \ my_VOB \ my_file.txt@@ \ main.

Arguments

The Arguments area identifies the actual source of the specified class. One, two, or more entries may be required, depending on the class. The Browse button allows you to navigate to a file. If the argument is a filename, either absolute or relative pathnames can be used. If more than one argument is required, it/they must be typed with exact capitalization, spacing, etc.

 

NOTE: For information about what to enter for each parameter, refer to the domain reference information for the corresponding class by clicking SoDA > Help on Domains.

Advanced

The Advanced check box allows for relative (or Calculated) arguments. Relative arguments are used to open a source, based on the value of another object. To create a relative OPEN:

- Check the Advanced key; a new column in the Arguments area is listed (Kind).

- Click on "Literal" to toggle the Kind to "Calculated."

- Click in the Value column; a tree control lists available options.

- Choose the attribute you need.

Example:

External Word documents, containing the UseCase documentation, can be attached to a Rose UseCase (or other Rose objects). SoDA can include these Word documents into the SoDA document. Follow these steps to create the commands to do this:

1.    In the Template (not the Template View), put the cursor within the REPEAT for UseCases, at the point where you want the Word document to appear (you can press Enter for better positioning):
- Use
SoDA > Add Command to add a REPEAT command.
- Select the
ExternalDocs relationship.
- Set the
Name to ExternalDoc.

2.    Without moving the cursor (i.e., just inside the REPEAT command for ExternalDocs), use
SoDA > Add Command to add an OPEN command. An OPEN Command dialog box is displayed.

3.    In the Select Class area (left-hand box), click MicrosoftWord > Document.

4.    Check the Advanced key box. A new field called Kind, is added to the Arguments area.

5.    Click on the word Literal to toggle the value to Calculated.

6.    Move the cursor to the green area under the title Value, click once to open a tree control.
- In the tree control, select
ExternalDoc > Value.
- Click
OK to create the OPEN command.

7.    Without moving the cursor (i.e., just to the right of the OPEN command), use SoDA > Add Command, to add a DISPLAY command. A DISPLAY Command dialog box is displayed.

8.    In the Select Attribute area, choose MicrosoftWord > FormattedText.

 

During generation, any external document attached to the UseCase will be inserted into the SoDA document at this point.

 

image\ebx_1237438844.gif

 

To import text files and bitmaps, use the FileSys domain.