setrevision

Description

The setrevision command allows you to set the PDM-managed revision of a file inside the vault. This command updates the official PDM revision, which is the value shown on the Version tab, not a data card variable.

You may set the revision using:

%nextrevision% - moves the revision forward.
%previousrevision% - moves the revision backward.
%initial% - resets to the first revision in the revision scheme.

You can also use PDM variables by enclosing them in brackets:

[Revision]

This evaluates the variable on the file and applies its value as the new revision.

The command resolves all bracketed variables before applying the revision.

Syntax

setrevision -filePath|-search -recursive -value -csv

Parameters

filePath
Path to the file whose revision you want to update. Only a single file is affected by this command.
search
Search query in the current folder.
recursive
When used with search, includes files in subfolders.
value
The revision value to apply. This can be:
- %nextrevision% - increments the PDM revision counter.
- %previousrevision% - decrements the PDM revision counter.
- %initial% - resets revision to the scheme's first value.
- [VariableName] - evaluates the PDM variable and uses its value.
- A literal revision string supported by the vault's revision scheme.
csv
When used with search, saves results to a CSV file.

Notes

This command affects only the PDM revision, not custom properties or configuration-specific metadata.
When using [VariableName], make sure the variable is present on the file card.
%previousrevision% adjusts the counter only if the revision scheme allows backward movement.
%nextrevision% respects all revision scheme rules defined in the PDM Administration tool.

Availability