ProjectWise Administrator Help

Define a Format Dialog

The Define a Format dialog can be used to define an enumerator format string for the string properties document name, file name, and version, for which uniqueness must be ensured.

String properties that include enumerator format substrings define a sequence of valid string values (for example, aaa%3s.pfd defines values: "aaa a.pfd", "aaa b.pfd", "aaa c.pfd", and so on), from which the first non-repetitive in the context value is regarded as a unique value.

Enumerator format string has the following format (brackets denote optional values):

%[-][0][width]type
Option Description Example
[-] Denotes left alignment of the generated string. If %3d produces " 5", then %-3d will produce "5 "
[0] Denotes that the generated number has to be filled with trailing zeroes. This is valid only when type is set to d or u and left alignment not specified. If %3d produces " 5", %03d will produce "005"
[width] A natural number that specifies mandatory enumerator length, if it is present. If %d produces "5", %3d will produce " 5"
type Can be one of:
  • u — unsigned decimal number
  • d — signed decimal number
  • s — string
  • O — lowercase string
  • S — uppercase string
Types u and d denote that enumerator format string should be processed to a decimal number. In all Define a Format dialog usage cases, these types are actually equivalent, as enumerator is being processed to a number starting with 1, which can result in unsigned sequence only – 1,2,3,4... (this distinction is most likely an obsolete functionality).

Types s, O and S denote that enumerator format string should be processed to a string. Type O results in a sequence like this: a, b, c..., aa, ab,... Type S results in a sequence like this: A, B, C..., AA, AB,... Type s can result in both uppercase and lowercase strings, depending on the context.

The Define a Format dialog can be opened:

  • From the Advanced Document Creation Wizard's Document Properties page. In this case the Define a Format dialog is used to assist in defining document name, description and file name. The Format button that launches the dialog is only enabled when the Advanced Document Creation Wizard is being used for multiple document creation (whether by creating new documents, dragging and dropping existing documents from another folder, or importing multiple documents).
  • From the Create a Document dialog that opens when a document name or file name conflict occurs when you attempt to create, copy, or move a document to a folder that already contains a document with the same document or file name.
  • From the Define Version Rules dialog that opens when you select multiple documents and select Document > New > Version.
  • On the Settings tab of the User Properties dialog (Tools > Options) by double-clicking items:

    Document Creation Conflicts > New Version > Version string format > format string

    Document Creation Conflicts > New Document > Document name format > format string

    Document Creation Conflicts > New Document > File name format > format string

SettingDescription
Type - Decimal number
  • Options - Unsigned
  • Preview
  • Width
  • Precision
  • Left Aligned
  • Filled with leading zeros
Type - String Sets text strings as the type of data to be formatted.
  • Options - Upper case or Lower case
  • Preview — When Type is set to String and neither case option is selected, text will be formatted to display words with the initial letter of each word capitalized, as shown in the Preview field example, Text Sample. When Type is set to String and the Upper case option is selected, text will be formatted to display words in all capital letters, as shown in the Preview field example, TEXT SAMPLE. When Type is set to String and the Lower case option is selected, text will be formatted to display words in all lower case letters, as shown in the Preview field example, text sample.
  • Width
  • Precision
  • Left Aligned