Table of Contents

SETRECISIONFROMSOURCE Command Documentation

DESCRIPTION

The SetRecisionFromSourceCommand allows you to batch-update the PDM-managed revision for multiple files by reading values from a CSV input source.

The source CSV must contain at minimum:

  • Id → the PDM file ID
  • Value → the revision value to apply

This command applies the revision exactly as supplied in the CSV just like in the set revision command.
It does evaluate %nextrevision%, %previousrevision%,%initial%, or bracketed variables—only literal revision values.

You may optionally output a results CSV that includes success/failure information for each processed row.

SYNTAX

setrevisionfromsource -source -csv

PARAMETERS

  • -source
    Path to the CSV file that contains the input dataset.
    Required columns:
    • ID — the file’s PDM ID inside the vault.
    • Revision — the revision string supported by the revision scheme

setrevisionfromsource

Note

You can generate IDs and variables into a CSV by using the search command.

  • -csv (optional)
    Path to an output CSV file where results will be written.
    The results file contains:
    • File ID
    • Operation status
    • Error message (if any)

EXAMPLAES


setrevisionfromsource -source source.csv -csv results.csv

NOTES

  • This command updates the PDM Revision shown on the Version tab, not datacard variables.
  • All revisions must already exist in the active revision scheme.
  • If a file ID does not exist or cannot be updated, the error will be logged and processing continues for the remaining records.
  • Output CSV is optional; if omitted, results are printed to console only.

AVAILABILITY

  • 3.0.12
Edit this page