XS_DRAWING_PLOT_FILE_NAME

Tekla Structures
Modificado: 31 Out 2025
2026
Tekla Structures

XS_​DRAWING_​PLOT_​FILE_​NAME

This advanced option must be set in an initialization (.ini) file.

Use this advanced option to define print file names for drawings if the file name is missing from the Print drawings dialog. This advanced option is used if you have not entered a value for some of the following advanced options: XS_DRAWING_PLOT_FILE_NAME_A, XS_DRAWING_PLOT_FILE_NAME_C, XS_DRAWING_PLOT_FILE_NAME_G, XS_DRAWING_PLOT_FILE_NAME_W, or XS_DRAWING_PLOT_FILE_NAME_M. This advanced option also affects how the exported DWG/DXF/DGN files are named.

Enter any combination of text and options:

Value

Example of the result in the print file name

Description

%NAME%

%DRAWING_NAME%

P_1

Part, assembly, or cast unit position, using the file name format prefix_number.

%NAME.-%

%DRAWING_NAME.-%

P-1

Part, assembly, or cast unit position, using the file name format prefix-number.

%NAME.%

%DRAWING_NAME.%

P1

Part, assembly, or cast unit position, using the file name format prefixnumber.

%REV%

%REVISION%

%DRAWING_REVISION%

2

Drawing revision number.

%REV_MARK%

%REVISION_MARK%

%DRAWING_REVISION_MARK%

B

Drawing revision mark.

%TITLE%

%DRAWING_TITLE%

PLATE

Drawing name from the drawing properties dialog.

%UDA:<drawing user-defined attribute>%

Painted

Value of a user-defined drawing attribute, f For example, UDA:DRAWING_USERFIELD_1. The user-defined drawing attributes are defined in objects.inp. The actual values for the user-defined attributes are entered in the drawing-specific user-defined attributes dialog.

%REV? - <text>%

2 - Rev

Adds conditional prefixes. In this example, if REV exists, Tekla Structures adds the text between ? and % to the file name.

The question mark (?) can be used for querying if a <variable> is set, and if it is not set, the <text> after the question mark until the last % will be printed.

%TPL:<template attribute>%

Base plate

You can use template attributes that can be found in Template Editor. The actual values for these attributes are entered in the drawing properties dialog. Examples:

  • %TPL:TITLE1%

  • %TPL:TITLE2%

  • %TPL:TITLE3%

  • %TPL:DR_DEFAULT_HOLE_SIZE%

  • %TPL:DATE%

  • %TPL:TIME%

  • %TPL:DR_DEFAULT_WELD_SIZE%

This advanced option is model specific and the setting is saved in the options database.

Example

%DRAWING_NAME.% - %DRAWING_TITLE%%DRAWING_REVISION? - Rev %%REVISION_MARK%

If you define %DRAWING_NAME.% - %DRAWING_TITLE%%DRAWING_REVISION? - Rev %%REVISION_MARK%, a .pdf file with a name P1 - PLATE - Rev A.pdf will be created from a single part drawing, for example, where

DRAWING_NAME. = P1, which is the part position without punctuation.

DRAWING_TITLE = PLATE, which is the name that you have entered in the Name box in drawing properties.

DRAWING_REVISION? = Empty, if there are no revisions. If a revision exists, the text after the question mark (?) together with the revision value according to the revision information defined in Rev.No. in the Revision handling dialog are written in the plot file name.

- Rev is the text to be printed, if DRAWING_REVISION gives a value. If DRAWING_REVISION does not give a value, the text - Rev will not be printed. In this case, the plot file name will not have REVISION_MARK either because the drawing has not been revised.

REVISION_MARK = A, because A has been defined as the revision mark in the Revision handling dialog.

Note:

The print file name switches %DRAWING_NAME% and %NAME% that should produce an underscore in the print file name (P_1) do not work if XS_ASSEMBLY_POSITION_NUMBER_FORMAT_STRING does not use a separator between the values (for example, %ASSEMBLY_PREFIX%%ASSEMBLY_POS%), or if XS_USE_ASSEMBLY_NUMBER_FOR is set.

To make the switches work, do the following:

  • If you want to use XS_ASSEMBLY_POSITION_NUMBER_FORMAT_STRING, use a dot (.) slash (/) or hyphen (-) between the values, for example, %ASSEMBLY_PREFIX%.%ASSEMBLY_POS%, or similar.
  • Leave XS_USE_ASSEMBLY_NUMBER_FOR empty.
Note:

When you define a switch in the Advanced options dialog, you only use single percent signs around the switch %xxx%. When you define a switch for an advanced option in an .ini file, you need to use double percent signs around the switch %%xxx%%. For example, type %%BOLT_NUMBER%%*D%%HOLE.DIAMETER%% for the advanced option XS_​BOLT_​MARK_​STRING_​FOR_​SIZE when you define it in an .ini file.

Esta informação foi útil?
Enviar
Anterior
Seguinte