Home Search

DriveWorks Pro 22
Change Child Specification State

Send Feedback

Change Child Specification State

The Change Child Specification State task will change the state of the child specifications as defined by the properties of the control.

This task can be used to Transition Child Specifications from one State to another. This can be used on any Transition in the Parent Specification.

The state to be changed, in the child specification, is not required to be directly connected to the child's current state.

It can also be a state that is not connected to any other state within the child's specification flow.

If the Child Specification creates documents on this State, make sure the parent Transition is not being run by DriveWorks Live and IIS.


Property NameDescription
DefinitionNamesOnly child specifications for the given control names will be changed. Use a pipe bar '|' to separate multiple control names, or a '*' to apply to all controls.

This defaults to * when the Task is added.

ProjectNamesOnly child specifications based on projects with the given names will be changed. Use a pipe bar '|' to separate multiple project names, or a '*' to apply to all projects.

This defaults to * when the Task is added.

StateNameThe name of the target state to which to change matching child specifications.
TitleChanges the Title (not the name) of the task.

Ensure that the DriveWorks user has permissions to the relevant State in the Child Project.


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
DefinitionNames"ChildSpecList1|ChildSpecList2"ChildSpecList1|ChildSpecList2DriveWorks will run this task for controls called ChildSpecList1 and ChildSpecList2
ProjectNames"Project1|Project2"Project1|Project2DriveWorks will look for Projects named Project1 and Project2 in the previous controls.
StateName"Completed"CompletedDriveWorks will change all Projects to this State if it can be found or accessed by the current user.

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:


  • All child specification states were changed successfully.

Success with Warnings

  • Some child specification states were changed, but some were not.

Failed (one of the following occurred)

  • Could not find child specification control.
  • No child specification states were changed.
  • General failure - Check the specification report for more details.

See Also

Specification Flow Security