Home Search

DriveWorks Pro 19
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 version of the 3D Document. The Save 3D Document task will take that in memory version and store it in the Specification.

Having the tasks perform in this way makes it faster to use. The resulting 3D Document can be then be saved when needed. Next time you open the Specification the models will be where you saved them.


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.