Home Search

DriveWorks Pro 24
PDMPro: Change the State of a File

Send Feedback

PDMPro: Change the State of a File

This Specification Task will change the state of a file inside the vault.

Properties

Property NameDescription
Source File PathFull path to the file whose state will be changed.
State NameThe name or id of the state to move the file to.
Transition NameThe name or ID of the transition to be used.
CommentThe comment to use when changing the file state (Optional).
Constant NameThe name of the Constant into which the result should be driven (Optional).

Examples

Property NameExample RuleMeaning
Source File Path "C:\PDM Vault\DriveWorks\TestFile.txt"The TextFile.txt will be the file whose state is changed.
State Name“Approved”The file will be moved to the “Approved” state.
Transition Name“No Approval Required”The transition called “No Approval Required” will be run.
Comment“DriveWorks Automation”The file history will display the comment “DriveWorks Automation”
Constant NameDWConstantReportingThe Constant called “Reporting” will be driven to the result of the task.

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.

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.

The status output navigation is as follows:

Success

  • Successfully changed the state of the file using the transition provided

Success with Warnings

  • N/A - Should never be fulfilled

Failed

  • State name is blank
  • Transition name is blank
  • File path is empty
  • File is not in a vault
  • File is not a recognized type
  • File is checked out elsewhere
  • File location is invalid
  • Transition is missing for the file
  • Transition was not accepted by PDM