Home Search

DriveWorks Pro 20
Run Macro

Send Feedback

Run Macro

The Run Macro task will run a macro in the specification.

Macros cannot be run while editing a project.


Property NameDescription
TitleChanges the Title (not the name) of the task.
Macro NameThe name of the macro in the project.
Macro Argument

Provides an optional argument to the macro.

Click here for more information...
DeferTrue to defer the execution of the macro until after the Specification has been saved. False to run immediately.

When a Specification is created a copy of the Project file (.driveprojx file) is stored alongside it in a hidden folder. This file is saved when a Specification is transitioned to a non-running state. The Defer property ensures the Task runs after everything else has happened in that Transition, Operation or change in State.

When transitioning a Specification to a paused state, and set a Task to be deferred, it will run after all the changed values have been saved to the Project file.

When a Task is set to be deferred in an Operation then all other Specification Tasks on that Operation would be run first before the Deferred Task is run.


When this task is added the properties are static by default.
See How To: Change A Static Property To A Dynamic Property to enable rules to be built on these properties.

Property NameExample RuleExample ResultMeaning
DeferFalseFalseSetting this to False will run the Macro immediately
Macro Argument"mm|Inch"mm|InchThis value/list can be used via the DWCurrentMacroArgument Special Variable in other Rules
Macro NameSetUnitsSetUnitsThis is the name of the Specification Macro that this Task will run.

Using the Task in a Specification Macro

This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.

Outputs are only available within Specification Macros. Currently Outputs are not available for Specification Flow.

Status Outputs

This task supports Status Outputs. These can be used to perform different actions depending on what the status outcome of the task is. For more information see Status Outputs in the Task Node Outputs section of Specification Macros Task Node.

The status output navigation is as follows:


  • Macro was successfully executed.

Success with Warnings

  • N/A


  • Macro failed to succesfully execute - see the Specification report for more information.