Using Variables in Rendition Profile Components

When creating rendition profile components, you can use both system and ProjectWise variables to define:

the output destination folder on the Output Destination Folder dialog
the relative path on the Output Destination Folder dialog
the file naming pattern on the Output File Naming Convention dialog
the settings file name on the Source File Presentation Settings dialog

When variables are used, the system will dynamically replace the variable with the appropriate real value when the rendition is created.

To add a variable, click the Add Symbol button from any of the dialogs above, which opens the Add Symbol dialog from which you can select the variable you want, from any of the following categories:

Document
Folder
Work Area
Environment
Print Definition
General

The following examples demonstrate how system and ProjectWise variables can be used in various rendition profile components.

Note: In addition to using the system and ProjectWise variables provided in the Add Symbol dialog, you can specify <Folder.ProjectUrl> as a valid ProjectWise variable. For example, if you specify <Folder.ProjectUrl>/Resources/project.set in a settings file path, the system searches for a work area and replaces <Folder.ProjectUrl> with the URL of the work area. The search starts in the folder where the original document resides and moves up the tree until it locates the first work area.

Using variables as part of the relative path in the Output Destination Folder dialog

In this example, the system variables User Name and Date are used for the relative path. The User Name is "admin" and the date is "October 13, 2015".

Relative Path	Result
`<UserName>/<Date?format=ddMMMyyy>`	`admin/13Oct2015`

Using variables as part of a specified folder in the Output Destination Folder dialog

In this example, the ProjectWise variable Department is used as part of the specified folder. The Department for the input file is "H".

Specified Folder	Result
`pw://mystry:DCSsource/Documents/Distributions/<Document.Department>`	`pw://mystry:DCSsource/Documents/Distributions/H`

Using variables as part of a settings file path in the Source File Presentation Settings dialog

In this example, the Folder Url variable is used to provide the ProjectWise URL settings file path and "/project.set" was appended at the end. The system will look for a settings file named project.set in the same folder as the input files. For this example, the input files reside in the Documents/User Projects/Civil folder.

Settings File Name	Result
`<Folder.Url>/project.set`	`pw://mystry:DCSsource/Documents/User Projects/Civil/project.set`

Using variables for the file name pattern in the Output File Naming Convention dialog

In this example, the Base Name variable is used as the file naming pattern. For example, if the input file name is AR1.dgn, the system will remove the ".dgn" from the file name and use AR1 for the rendition name.

File name pattern	Result
`<Document.BaseName>`	`AR1`