Specification Settings (DriveWorks Documentation)

Specification Settings

The Specification Settings task provides the ability to control the naming and folder location of specifications which are created by running a project.

Each specification made appears in the Specification Explorer, until archived.

A specification creates two DriveWorks files, these files contain:

Details of the user forms as they were at the time the specification was made, and the data entered into the form controls.
Details of the rules that were applied at the time the specification was made.

These files are given a name that is the result of the rule applied to the setting Specification Name. They are stored at the location thats been set by the is the result of the rule applied to the setting Specification Path.

The specification files have the file extensions:

.drivespec
.driveprojx

These files are stored in a subfolder of the Specification Path setting named DriveWorksFiles. This folder name cannot be changed.

The folder and files are not viewable in Windows Explorer by default. The Windows Explorer Folder options must be changed to "Show hidden files, folders, and drives" to view them.

Specification Name

This setting creates a unique name for each specification.

The default rule for this setting is:

"<project name> " & Text(DWSpecificationID,"0000")

Where:

<project name> is the name of the project to which the specification belongs.

DWSpecificationID is a Special Variable that gives a unique incremental number.

To set up a rule for the Specification Name click the "Build" button to the right of the Specification Name section.

The result of this rule can be used by using the Special VariableDWSpecification.

The Specification Name needs to be unique for every specification that is created. To do this we recommend the use of the Special Variable DWSpecificationID.

Volatile Functions

Volatile functions constantly change value whenever they are calculated.

Do not use any volatile function in the File Name rule or Path rule for any item created by DriveWorks.

Volatile functions include:

Date and Time functions.
These include functions such as Now, Today, Second, etc..
Random Number functions.
These are Rand and RandBetween.

Specification Path

This setting defines the location from which the DriveWorks specification files will be stored.

Each Specification must be located in a unique folder.

If the Specification is not stored in a unique folder it may be possible to overwrite older specifications.

The default rule for this setting is:

DWSpecification

Where:

DWSpecification is a Special Variable where the result of the Specification Name rule gets written to.

To setup a rule for the Specification Path click the "Build" button to the right of the Specification Path section.

The result of this rule can be used by using the Special VariableDWSpecificationPath.

Volatile Functions

Volatile functions constantly change value whenever they are calculated.

Do not use any volatile function in the File Name rule or Path rule for any item created by DriveWorks.

Volatile functions include:

Date and Time functions.
These include functions such as Now, Today, Second, etc..
Random Number functions.
These are Rand and RandBetween.

Specification Tags

Tags are relevant when two or more DriveWorks Autopilot machines are deployed.

Tags control the order in which DriveWorks Autopilot processes should be running and process the required information for a specification.

The result of the Tags rule must match a tag set in DriveWorks Autopilot.

Rule	Meaning
If(HighPriorityCheckBox=True,"High","Low")	When the checkbox HighPriority is checked will result in the tag "High" being applied to the parameter. Otherwise the tag "low" will be applied.

DriveWorks Autopilot must be set to process the information being tagged.

Additional Folders

To set up a rule for Additional Folders click the "Build" button to the right of the Additional Folders section.

The rule should have the same structure as the following:

Example Additional Folder Rule

 DWSpecification & "\Folder 1" & "|" & DWSpecification & "\Folder 2"

The above rule would create two new folders, Folder 1 and Folder 2. The two newly created folders will appear in another folder named after the Specification Name.

If a folder has been created by using the Relative Path in Model Rules General then you will NOT need to create a rule in Additional Folders to create the same folder.

An example of the folder structure that has been created will display in the Current Value section.

The result of this rule can be used by using the Special VariableDWAdditionalFolders.

DriveWorks Tech Tips Portal

Incrementing Specification ID

Specification Settings can be used to create a Specification ID that increments separately for each user.

View all Tech Tips

DriveWorks Tech Tips Portal is available to DriveWorks Pro customers with an active subscription and support contract.

Tech Tips provide cut down projects that highlight specific functionality for faster and more effective learning.

To access the portal:

Go to https://my.driveworks.co.uk/learn/tech-tips/
Login with your DriveWorks Pro account credentials, if asked
Click the Visit Tech Tips Portal button for access

The portal provides a search facility, start typing the name of the Tech Tip (as indicated above) to display the Tip you require.

DriveWorks Pro 22 Specification Settings