Home Search

DriveWorks Pro 22
Save 3D Document

Send Feedback

Save 3D Document

The Save 3D Document task will save a DriveWorks 3D Document used in a 3D Preview Control back to the Specification.

The following Specification Macro Tasks work on a 3D Document in a 3D Preview Control:

You can think of these task as working on an in memory (not committed to disk) version of the 3D Document.

The Save 3D Document task will take that in memory version and store it in the Specification.

Having the task function this way is more performant.

Reopening a Specification will display the 3D Document as it was when the Save 3D Document Task was executed.

The resulting 3D Document can be saved to disk when needed by using the Release Documents Task.


Property NameDescription
Preview Control NameThe name of a 3D Preview Control to perform the action on.
This 3D Preview Control must be using a DriveWorks 3D Document.


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
Preview Control Name"3DPreviewControl"3DPreviewControlThis task will run on the named Preview Control. If that Preview Control has a DriveWorks 3D Document, then the task will attempt to set the Transform of the specified Node.

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:


  • Succesfully saved 3D document.

Success with Warnings

  • N/A

Failed (one of the following occurred)

  • No control name specified.
  • Control with name doesn't exist.
  • Control must be previewing a 3D document.
  • General error - check Specification report for more information.