Introducing SoDA Commands

Each SoDA template contains one or more of these SoDA commands: OPEN, REPEAT, DISPLAY, and LIMIT. Here is a brief description of each command:

§  The OPEN Command identifies a particular object in a source domain. It normally provides the highest abstraction of a domain object from which other SoDA commands can be defined. For instance, you might OPEN a directory, or perhaps a Rose model.

§  The REPEAT Command identifies sections within a document that are repeated for each object found based on some relationship. This command is useful when there is a set of objects in the source domain that needs to be uniformly documented. The document template defines the format and generic content of the section. SoDA builds a section for each object found in the source. SoDA maintains the consistency between the document and the objects in the source.

REPEAT commands can be filtered. Identifying which REPEAT commands are filtered (ADVANCED REPEAT) can be accomplished through
Template View.

§  The DISPLAY Command inserts attributes of a source object into a generated document. You can display both text and graphics. Any of the following might be displayed: the name of a Rose class category, the cardinality of a "has" relationship, the name of a directory, or the contents of a text file.

§  The LIMIT Command determines whether an object exists with certain characteristics. Normally a LIMIT command defines an expression that evaluates to True or False. If the object fails the test defined by the expression, the corresponding section is left out of the document.

LIMIT commands come in three flavors: LIMIT, LIMIT OMIT, and LIMIT OTHERWISE.