SETVAR Command Documentation

DESCRIPTION:

Sets the value of a variable for a specified checked out file or many checked out files.

SYNTAX:

setvar [-filePath|-search]  -variableName -value [-configNames] [-stringformat] 

PARAMETERS:

-filePath: The file to set the variable for.

-variableName: The variable to set.

-value: The value to assign to the variable.

-configNames: The configuration names to set the variable for, separated by commas.

-search: The search operation to use.

-stringformat: string format. See remarks section.

EXAMPLES:

setvar -filePath file1.sldprt -variableName Description -value $value -stringformat UpperCase # Upper case the current value.

EVALUATION:

The value parameter gets evaluated by PDMShell. This feature allows you to use placeholders in the new value, which will be replaced with actual values from the file or folder. This can be useful to dynamically generate new values based on file or folder properties or other variables. The following placeholders are supported:

Note

Please read more information about placeholder evaluation here.

REMARKS

• The configNames parameter should be separated by commas. If omitted, PDMShell uses @ for configuration-supported documents.
• The search parameter searches the current directory and does not drill down. The search query is a PDM one, so you can use % for wildcard.
• The stringformat parameter allows you to format the value of the variable using predefined string formatting options. The following formats are supported:
  • UpperCase: Converts the entire string to uppercase.
  • LowerCase: Converts the entire string to lowercase.
  • CamelCase: Converts the string to camel case, where the first word is lowercase, and subsequent words are capitalized (e.g., exampleString).
  • FirstLetterCase: Capitalizes the first letter of the string and converts the rest to lowercase (e.g., Example).

TUTORIAL:

CHANGELOGS

• As of version 3.0.9, we have added support for setting folder daracard variables