LevelAdd

The LevelAdd verb creates a new level in the specified model dimension.

The user interface equivalent is to select the Insert option on the Edit menu when a level is selected.

For more information about creating levels, see LevelMake.

The syntax is as follows:

LevelAdd objLevel [Dimension objDim][Drill objDrillCat]
[Parent objLevel][ levelopts] [DrillList objDrillCats
 EndList] Associations assocopts

Argument

Description

LevelAdd objLevel

Creates the level objLevel. objLevel must be the object name and can include the object identifier.

Dimension objDim

Specifies a dimension for the level. objDim can be the object name, object identifier, or both.

Drill objDrillCat

Specifies a drill category for the level. objDrillCat can be the object name, object identifier, or both.

Parent objLevel

Specifies a parent for the level. objLevel can be the object name, or object identifier.

levelopts

Optional parameters that describe the level in greater detail. Some options are set by default if you do not set them. For the complete list of options, see levelopts.

DrillList objDrillCats

Specifies the multiple drill categories objDrillCats. objDrillCats is one or more drill categories, each identified by object name or object identifier.

Associations assocopts

Parameters that specify associations for the level. For the complete list of options, see assocopts.

Example

This example creates the level Year.

LevelAdd 237 "Year" Blanks "(blank)" Inclusion Generate DateFunction Year 
Generate Need RefreshLabel False  RefreshDescription False
RefreshShortName False NewCatsLock False CatLabFormat "YYYY" Timerank 10
UniqueCategories True UniqueMove False Associations 1251 "Time" 
AssociationType Type_Query AssociationRole Role_Source A
ssociationReferenced "Time" Associations 1253 "Time" AssociationContext 235 
AssociationType Type_Query AssociationRole Role_OrderBy 
AssociationReferenced "Time" SortOrder Default SortAs Ascending