Update File Data

Updates the document control attributes of a file in Autodesk Vault, including category, lifecycle definition, lifecycle state, revision definition, and revision number.

Purpose

Use this task when a workflow needs to advance or adjust a file's document control status, such as moving a drawing to a Released lifecycle state, assigning it to the correct category upon project completion, or changing its revision scheme when issuing a new version. All fields are optional; only the fields you provide will be changed, leaving all other attributes untouched.

Inputs

Field	Type	Required	Description
File Identifier	Text	Yes	The Vault file ID or full Vault path to the file to update, e.g. $/Designs/Project001/DRAWINGS/drawing.dwg.
Category	Text	No	The name of the category to assign to the file. Must match a valid category defined in Vault. If not provided, the category will not change.
Lifecycle Definition	Text	No	The name of the lifecycle definition to apply. Must match a valid lifecycle in Vault. If not provided, the lifecycle definition will not change.
Lifecycle State	Text	No	The name of the lifecycle state to transition the file to. Must be a valid state within the current lifecycle. If not provided, the state will not change.
Revision Definition	Text	No	The name of the revision scheme to assign. Must match a valid revision definition in Vault. If not provided, the revision definition will not change.
Revision Number	Text	No	The revision label to set on the file, e.g. A or 01. Must be a valid value within the assigned revision scheme. If not provided, the revision number will not change.
Match Properties From File Identifier	Text	No	The Vault file ID or full Vault path of a source file whose non-system properties will be copied to the target file. If not provided, properties will not be copied.
Comment	Text	No	A comment to record against each change applied during this task. If not provided, a default automation comment is used.

Outputs

Name	Description
VaultFile	The Vault file object reflecting all changes applied by this task. Downstream tasks can use this to perform further operations on the updated file.