Home Search

DriveWorks Pro 21
Run Macro in Hosted Specification

Send Feedback

Run Macro in Hosted Specification

This task will run a Specification Macro in a Hosted Specification.

Perform actions in a Hosted Specification when a Specification Macro is run in the current Specification.

Multiple Specification Host Controls can be running in the current Specification. Therefore the target Specification Host Control name must be specified for the task to run.

Properties

Property NameDescription
Macro ArgumentProvides an optional Macro Argument to the Specification Macro.
Macro NameThe name of the Specification Macro to execute in the Hosted Specification.
Specification Host Control NameThe name of the Specification Host Control to use to obtain the Specification to invoke the Specification Macro on.
TitleChanges the Title (not the name) of the task.

Example

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.

PropertyExample RuleExample ResultMeaning
Macro Argument250250250 will be passed into the Special Variable DWCurrentMacroArgument and can then be used in the Hosted Specifications rules.
Macro Name"Set Control Value"Set Control ValueThe name of the Specification Macro to run in the Hosted Specification. Set Control Value will be run in the Hosted Specification.
Specification Host Control Name"SpecificationHostControl"SpecificationHostControlThe name of the Specification Host Control to use in the current Specification. The Specification Macro will run in the Specification hosted in this Control.

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:

Success

  • Macro executed successfully inside Hosted Specification.

Success with Warnings

  • N/A

Failed

  • No Macro was specified.
  • Host Control could not be found.
  • No Specification inside the Host Control.
  • Could not find Macro in the Hosted Specification.
  • General error - see Specification Report for more information.