Environment options
This page provides information on the SysML v2-specific environment options you can use to customize your workflow.
Opening the Environment Options dialog
To open the Environment Options dialog
- From the Options menu, select Environment. Then select either SysML v2 or SysML v2 Textual Editor group.
Modifying environment options
To modify environment options
- Open the Environment Options dialog.
- Locate the option you want to modify.
- Use the quick filter to find the needed option in the list. Filtering is performed in all available options, not only the selected option group.
- Click the Show Description button to display the environment option description section at the bottom of the dialog to read about the option functionality.
- Use the quick filter to find the needed option in the list. Filtering is performed in all available options, not only the selected option group.
- An option value can be changed by typing a new value, setting a value to true/false, or selecting a value from the list.
Click the Reset to Defaults button to restore default option values.
- Click OK.
SysML v2 Environment Options
| Option | Default value | Value options | Description |
|---|---|---|---|
| SysML v2 | |||
| General | |||
| Show Element Keyword | true | true/false | Set to true to display element keywords (e.g., part, action, actor) across the UI, such as in the Containment tree, Specification panel, and shortcut menu, while excluding views. |
| SysML v2 Textual Editor | |||
| Code Style | |||
| Add Blank Lines Between Textual Notation Blocks | false | true/false | Set to true to insert a blank line after each textual notation block in the textual notation to separate the blocks. |
| Display Specializations as Keywords | false | true/false | Set to true to display specializations as keywords rather than symbols in the textual notation. Learn more >> |
| Display Metadata as Keywords | false | true/false | Set to true to display metadata as keywords rather than symbols in the textual notation. Learn more >> |
| Use Short Name Instead of Name | true | true/false | Set to true to display the element's short name instead of its name in the textual notation. Learn more >>
This option applies only when an element is targeted outside the Textual Editor (e.g., when subsetting an element in a view). If the element is directly targeted in the Textual Editor by typing its name, it will not be automatically replaced with the short name. However, if the element is first targeted in a view and then opened in the Textual Editor, the short name of the target element will be displayed. |
| Use Short Name Instead of Name for Requirement | false | true/false | Set to true to display the requirement's short name instead of its name in the textual notation. Learn more >>
This option applies only when a requirement is targeted outside the Textual Editor (e.g., when subsetting a requirement in a view). If the requirement is directly targeted in the Textual Editor by typing its name, it will not be automatically replaced with the short name. However, if the requirement is first targeted in a view and then opened in the Textual Editor, the short name of the target requirement will be displayed. |
| Max Column for Hard Wrap | 170 | Number | Specify the maximum number of columns for hard wrapping lines in the Textual Editor. When a line exceeds the specified limit, it is split into sections of new indented lines to fit the line length based on the maximum number of columns. When wrapping, the editor follows specific rules, such as breaking at keywords ("connect", "from", "to", "of"), binary operators ("+", "-"), commas, and long single-line bodies. Set to -1 to disable the max column. |
| Editor | |||
| Synchronize Model with Errors | false | true/false | Set to true to synchronize the model with the textual notation, even if the notation contains errors. Learn more >> |
| Name Resolution Error Limit | 10 | Number | Specify the name resolution error limit to control the handling of name resolution errors. When specified, the name resolution stops if the error limit is reached, leaving the remaining names unresolved. This limit applies independently to each open Textual Editor tab. Set to -1 to disable the error limit and allow name resolution to continue for all names, skipping only those with errors. Learn more >> |
| Force KerML Namespaces Opening | false | true/false | Set to true to force the opening of KerML namespaces in the Textual Editor. |
| Preferred Element Name for Autocompletion | Short name | Short name Name Both names | Specify which element name should be suggested in context-sensitive autocompletion. If the selected name type is not specified for an element, autocompletion will suggest an existing name type instead. Learn more >> |
| Enable Sticky Header | true | true/false | Set to true to enable the sticky header in the Textual Editor, which displays the owner of the currently visible notation at the top of the editor. Reopen the Textual Editor for the changes to take effect. Learn more >> |
| Sticky Header Line Count | 5 | Number | Specify the maximum number of lines to display in the sticky header. Reopen the Textual Editor for the changes to take effect. Learn more >> |
| Font Size | 14 | Number | Specify the default font size. |
| Text Generation | |||
| Smart Generation Timeout | -1.0 | -1.0 - ∞ | Specify the timeout duration for smart generation in seconds. During textual notation generation, the tool generates the shortest qualified names. If the timeout is specified, a simpler name is generated once the time limit is reached. Set to -1 to disable the timeout. |