Element names

See the information on this page for naming elements.

For information on name resolution (i.e., feature chaining and qualified names), see the Name resolution section on the Managing textual notation page.

Declared name
- In addition to the keyword indicating element kind, the declaration of an element may also specify a declared name. The declared name should be fully descriptive, particularly in the context of the element definition.
  
  Declared names must be represented with a specific lexical structure when written in the textual notation. For more information, see the Naming section on the Managing textual notation page.
  
  part 'LED Flashlight' { // unrestricted element name that includes whitespace
  part bulb; // basic element name without whitespace
  }

Declared short name
- The declared short name, if given, should be an abbreviated name useful for referring to the element. The declared short name is distinguished by being surrounded by the delimiting characters < and >.
  
  The declared short name, if used, must precede the declared name.
  
  part <cyl> cylinders; // a part usage with the declared short name <cyl> and declared name cylinders
  requirement <'1'> fullVehicleMassLimit : MassRequirement; // a requirement with the declared short name <'1'>, which is also considered its requirement ID.

Name and short name
- If neither a declared name or a declared short name are given in the declaration of a usage, then it is determined by the name or short name of the redefined usage. Note that <> symbols should not be used when indicating the short name.
  
  part def Engine {
  part <cyl> cylinders : Cylinder [2 ..*];
  }
  part def FourCylinderEngine :> Engine {
  part redefines cylinders [4]; // Engine::cylinders is redefined with a new usage, whose declared name or short name is empty, but its name is "cylinders".
  // OR
  part redefines cyl[4]; // Engine::cylinders is redefined with a new usage, whose declared name or short name is empty, but its short name is "cyl". Note that <> symbols should not be used when indicating the short name.
  }

To specify the declared name via the Textual Editor

In the Textual Editor, follow the element keyword or declared short name with the needed basic or unrestricted name.

Declared names must be represented with a specific lexical structure when written in the textual notation. For more information, see the Naming section on the Managing textual notation page.
Click the Synchronize button.

part 'LED Flashlight' { // unrestricted element name that includes whitespace
part bulb; // basic element name without whitespace
}

To specify the declared name via the Specification Panel

To specify the declared name via the Containment tree

To specify the declared name via the element symbol in a view

On a symbol on view, double-click the name line under the element keyword and type the needed name.

To specify the declared short name via the Textual Editor

In the Textual Editor, follow the element keyword with the <> symbols with the needed short name within them.
Click the Synchronize button.

part def Engine {
part <cyl> cylinders : Cylinder [2 ..*]; // a part usage with the declared short name <cyl> and declared name cylinders
}
part def FourCylinderEngine :> Engine {
part redefines cyl[4]; // Engine::cylinders is redefined with a new usage, whose declared name or short name is empty, but its short name is "cyl". Note that <> symbols should not be used when indicating the short name.
}

To specify the declared short name via the Specification Panel