Home Search

DriveWorks Solo 22
Info: Special Variables

Send Feedback

Introduction

DriveWorks has built in variables known as Special Variables that can be used in rules.

The special variables are found in the Rule Builder from the Quick Text drop down.

The available special variables are listed below:

Project Name

Name: DWProjectName

Returns the name of the Project.

Examples

Rule

Meaning
DWProjectName

Will return the name given to the project.

Specification ID

Name: DWSpecificationId

Every time a project is run in DriveWorks, it is allocated a guaranteed unique incrementing number called a specification id, which is combined with the name of the project to give the running project its specification name.

The Specification Id and Specification Name are used in DriveWorks in various ways, e.g.:

  • Whenever a running project is finished, a folder is created which is named after the specification name in a folder called "Results" in the same folder as the project file.
  • By default, new models are created with the same name as their originals but suffixed with the specification name.
You can use the Specification Id and Specification Name in your own rules by using the Quick Text button on the Rules Builder.
The Specification Id and Specification Name are made available to the running project in two Special Variables called "DWSpecificationId" and "DWSpecification" respectively.
DWSpecificationID begins at 1 and has a range of approximately 2 billion.

Examples

Rule

Meaning
DWSpecificationId

Will result in 9999 while administering a project.

Will result in the next available number once a project is running, e.g. 1

TEXT(DWSpecificationID,"0000")

Will ensure the result contains at least 4 digits, e.g. 0001

This will NOT truncate the DWSpecificationID when the range goes above 9999 but will always include at least 4 digits.

Specification Name

Name: DWSpecification

Every time a project is run in DriveWorks, it is allocated a guaranteed unique incrementing number called a specification id, which is combined with the name of the project to give the running project its specification name.

The Specification Id and Specification Name are used in DriveWorks in various ways, e.g.:

  • Whenever a running project is finished, a folder is created which is named after the specification name in a folder called "Results" in the same folder as the project file.
  • By default, new models are created with the same name as their originals but suffixed with the specification name.
You can use the Specification Id and Specification Name in your own rules by using the Quick Text button on the Rules Builder.
The Specification Id and Specification Name are made available to the running project in two Special Variables called "DWSpecificationId" and "DWSpecification" respectively.
DWSpecificationID begins at 1 and has a range of approximately 2 billion.

Examples

Rule

Meaning
DWSpecification

Will return the combined name of the project and the SpecifactionID

Form Container Width

Name: DWFormContainerWidth

The special variable Form Container Width reports on the available width a form is being displayed in.

This is useful when designing user forms to adapt to changes in width on multiple devices.

When viewed in Form Design the special variable reports the width of the available Form Design area. This accounts for the Task Explorer on the left and the properties list on the right.

Linking this special variable to the layout properties of form controls, user forms can dynamically adjust to suit the device the form is being viewed on.

Examples

Rule

Meaning
DWFormContainerWidth

Will result in the width of the Form Design area while administering a project.

Form Container Height

Name: DWFormContainerHeight

The special variable Form Container Height reports on the available height a form is being displayed in.

This is useful when designing user forms to adapt to changes in height on multiple devices.

When viewed in Form Design the special variable reports the height of the available Form Design area.

Linking this special variable to the layout properties of form controls, user forms can dynamically adjust to suit the device the form is being viewed on.

Examples

Rule

Meaning
DWFormContainerHeight

Will result in the height of the Form Design area while administering a project.

© DriveWorks Ltd 2024 - All rights reserved.
Privacy Policy | Terms & Conditions