MicroStation CONNECT Edition Help

Text Substitutions Dialog

Used to generate substitution text string pairs; each pair consists of an actual text string and a replacement text string.

You can access this dialog from the following:
  • Modify Pen Table dialog: click the Text Substitutions button


The replacement text can be the value of one of several tokens provided by the pen table:

  • A literal text string
  • Predefined replacement tokens such as, design file name and pen table file name
  • The value(s) of one or more environment variables in conjunction with literal text
  • The <expr?name=...> token to reference a named expression
  • Printing accounting variables

The list of predefined replacement tokens appears on the Edit menu. Proposed replacement strings for these items are special strings that are converted to the required information during processing for printing.

Additionally, if a replacement string, or a portion of a replacement string, has the format of a MicroStation configuration macro — that is, has format $(text) — it undergoes substitution automatically to a preset value. This automatic substitution is called expansion. For example the replacement string User: $(USERNAME) might expand to User: Johnsmith. If a replacement string has configuration macro format and is expanded to another configuration macro, and so on, then substitution is iterative until expansion to a string which is not a configuration macro.

SettingDescription
List box Displays list of substitution string pairs, with each pair consisting of:
  • an actual string — the string in the design file which is to be replaced;
  • a replacement string — the string which is to replace the actual string.
Actual This text box lets you modify an actual string in the list box. Actual text strings are added to the list box by using one of the Edit menu's Insert menu items. If an Actual string is highlighted in the list box it is displayed in the Actual field, where you can rename it by typing a new name and pressing <Enter>.
Replacement This text box lets you modify a replacement string in the list box. If a replacement text string is highlighted in the list box it is displayed in the Replacement field, where you can rename it by typing a new name and pressing <Enter>.
Edit > Insert New Starts the process of entering a new substitution text pair in the list box. Inserts "Original" in the Actual list box column and in the Actual text box. To modify the actual string, type a new name and press <Enter>. This menu item does not generate a replacement text string; therefore, you are required to type in one of the valid replacement tokens.
Edit > Delete Removes the highlighted text pair from the list box.
Edit > Insert Design File > Short Inserts $FILES$ into the Actual text box and _FILES_ into the Replacement text box. The replacement string _FILES_ is a variable that instructs the printing process to insert the short name of the design file as a replacement for the text string $FILES$ in the design file. That is, it inputs the name of the design file only, without its path.
Edit > Insert Design File > Abbrev Inserts $FILEA$ into the Actual text box and _FILEA_ into the Replacement text box. The replacement string _FILEA_ is a variable that instructs the printing process to insert the abbreviated name of the design file as a replacement for the text string $FILEA$ in the design file. That is, where the name of the design file plus its path exceeds 30 characters, the path is truncated.
Edit > Insert Design File > Long Inserts $FILEL$ into the Actual text box and _FILEL_ into the Replacement text box. The replacement string _FILEL_ is a variable that instructs the printing process to insert the long name of the design file as a replacement for the text string $FILEL$ in the design file. That is, it inputs the name of the design file along with its full path.
Edit > Insert Pen Table > Short Inserts $PENTBLS$ into the Actual text box and _PENTBLS_ into the Replacement text box. The replacement string _PENTBLS_ is a variable that instructs the printing process to insert the short name of the pen table file as a replacement for the text string $PENTBLS$ in the design file. That is, it inputs the name of the pen table file only, without its path.
Edit > Insert Pen Table> Abbrev Inserts $PENTBLA$ into the Actual text box and _PENTBLA_ into the Replacement text box. The replacement string _PENTBLA_ is a variable that instructs the printing process to insert the abbreviated name of the pen table file as a replacement for the text string $PENTBLA$ in the design file. That is, where the name of the pen table file plus its path exceeds 30 characters, the path is truncated.
Edit > Insert Pen Table > Long Inserts $PENTBLL$ into the Actual text box and _PENTBLL_ into the Replacement text box. The replacement string _PENTBLL_ is a variable that instructs the printing process to insert the long name of the pen table file as a replacement for the text string $PENTBLL$ in the design file. That is, it inputs the name of the pen table file along with its full path.
Edit > Insert Printer Driver Configuration File > Short Inserts $PLTDRVS$ into the Actual text box and _PLTDRVS_ into the Replacement text box. The replacement string _PLTDRVS_ is a variable that instructs the printing process to insert the short name of the printer driver configuration file as a replacement for the text string $PLTDRVS$ in the design file. That is, it inputs the name of the printer driver configuration file only, without its path.
Edit > Insert Printer Driver Configuration File > Abbrev Inserts $PLTDRVA$ into the Actual text box and _PLTDRVA_ into the Replacement text box. The replacement string _PLTDRVA_ is a variable that instructs the printing process to insert the abbreviated name of the printer driver configuration file as a replacement for the text string $PLTDRVA$ in the design file. That is, where the name of the printer driver configuration file plus its path exceeds 30 characters, the path is truncated.
Edit > Insert Printer Driver Configuration File > Long Inserts $PLTDRVL$ into the Actual text box and _PLTDRVL_ into the Replacement text box. The replacement string _PLTDRVL_ is a variable that instructs the printing process to insert the long name of the printer driver configuration file as a replacement for the text string $PLTDRVL$ in the design file. That is, it inputs the name of the printer driver configuration file along with its full path.
Edit > Insert Date Inserts $DATE$ into the Actual text box and _DATE_ into the Replacement text box. The replacement string _DATE_ is a variable that instructs the printing process to insert the system date as a replacement for the text string $DATE$ in the design file. The Windows Regional and Language Settings are used to format the time and date for printed output in a locale-sensitive manner.
Edit > Insert Time Inserts $TIME$ into the Actual text box and _TIME_ into the Replacement text box. The replacement string _TIME_ is a variable that instructs the printing process to insert the system time as a replacement for the text string $TIME$ in the design file. The Windows Regional and Language Settings are used to format the time and date for printed output in a locale-sensitive manner.
Edit > Insert Scale > Long Inserts $SCALE$ into the Actual text box and _SCALE_ into the Replacement text box. The replacement string _SCALE_ is a variable that instructs the printing process to insert the scale used for the print, including units (for example, 70.0739 m:cm / IN), as a replacement for the text string $SCALE$ in the design file.
Edit > Insert Scale > Short Inserts $SCALESHORT$ into the Actual text box and _SCALESHORT_ into the Replacement text box. The replacement string _SCALESHORT_ is a variable that instructs the printing process to insert the shortened version of the scale used for the print as a replacement for the text string $SCALESHORT$ in the design file. The shortened version does not include the units and the precision is limited to six characters.
Edit > Insert Paper Size Name Inserts $SHEETNAME$ into the Actual text box and _SHEETNAME_ into the Replacement text box. The replacement string _SHEETNAME_ is a variable that instructs the printing process to insert the name of the paper size being used (for example, ISO A3) as a replacement for the text string $SHEETNAME$ in the design file.
Edit > Insert Paper Size Inserts $SHEETSIZE$ into the Actual text box and _SHEETSIZE_ into the Replacement text box. The replacement string _SHEETSIZE_ is a variable that instructs the printing process to insert the size of the paper being printed (for example, 11x17 [in]) as a replacement for the text string $SHEETSIZE$ in the design file.
Edit > Insert Model Name Inserts $MODELNAME$ into the Actual text box and _MODELNAME_ into the Replacement text box. The replacement string _MODELNAME_ is a variable that instructs the printing process to insert the name of the model being printed as a replacement for the text string $MODELNAME$ in the design file.
Edit > Insert Last Saved Date Inserts $LASTSAVEDDATE$ into the Actual text box and _LASTSAVEDDATE_ into the Replacement text box. The replacement string _LASTSAVEDDATE_ is a variable that instructs the printing process to insert the date the design file was last saved as a replacement for the text string $LASTSAVEDDATE$ in the design file.
Edit > Insert Last Saved Time Inserts $LASTSAVEDTIME$ into the Actual text box and _LASTSAVEDTIME_ into the Replacement text box. The replacement string _LASTSAVEDTIME_ is a variable that instructs the printing process to insert the time the design file was last saved as a replacement for the text string $LASTSAVEDTIME$ in the design file. The format for the time string is obtained from the Windows regional settings.
Edit > Insert Last Saved Date and Time Inserts $LASTSAVEDDATETIME$ into the Actual text box and _LASTSAVEDDATETIME_ into the Replacement text box. The replacement string _LASTSAVEDDATETIME_ is a variable that instructs the printing process to insert the date and time the design file was last saved as a replacement for the text string $LASTSAVEDDATETIME$ in the design file.
Edit > Insert System Printer Name Inserts $SYSPRINTER_NAME$ into the Actual text box and _SYSPRINTER_NAME_ into the Replacement text box. The replacement string _SYSPRINTER_NAME_ is a variable that instructs the printing process to insert the system printer name as a replacement for the text string $SYSPRINTER_NAME$ in the design file. If the system printer driver is being used, this is the name of the Windows printer.
Edit > Insert Print Set Item > Number of Definitions in Print Set Inserts $DOCSET_NUMSETDOCS$ into the Actual text box and _DOCSET_NUMSETDOCS_ into the Replacement text box. The replacement string _DOCSET_NUMSETDOCS_ is a variable that instructs the printing process to insert the number of print definitions in the print set as a replacement for the text string $DOCSET_NUMSETDOCS$ in the design file. If you are using Variable print definitions, please see Guidelines for Using Page Numbering and Total Page Tokens With Variable Print Definitions.
Edit > Insert Print Set Item > Print Definition Number within Set Inserts $DOCSET_CURRENTSETDOC$ into the Actual text box and _DOCSET_CURRENTSETDOC_ into the Replacement text box. The replacement string _DOCSET_CURRENTSETDOC_ is a variable that instructs the printing process to insert the print definition number currently being processed as a replacement for the text string $DOCSET_CURRENTSETDOC$ in the design file. If you are using Variable print definitions, please see Guidelines for Using Page Numbering and Total Page Tokens With Variable Print Definitions.