@DocParentNumber (Formula Language)

In a column or window title formula, returns a string that represents the entry number of the parent view entry. Both the current view entry and the parent can be either documents or categories.

Syntax

@DocParentNumber @DocParentNumber( separator ) @DocParentNumber( "" )

Parameters

separator

Text. Optional. Indicates a separator to be used in the parent document number instead of ".".

""

Empty string argument. Optional. Tells the function to return the least significant item of the parent document number (in other words, its rightmost component).

Return value

docNum

Special text. The value that represents the document number of the document or category in the view. You cannot convert special text to a number.

Usage

Use @DocParentNumber in column and window title formulas. If you use it in a field formula or window title formula, no result is displayed until the document has been saved and reopened. This function does not work in any other formula.

To determine the number for the current entry, use @DocNumber instead.

You cannot use this function in Web applications, except in column formulas.

Examples

  1. This example returns 37.1.3 for the document or category for which the parent is entry 37.1.3.
    @DocParentNumber
  2. This example returns 37-1-3 for the document or category for which the parent is entry 37.1.3.
    @DocParentNumber("-")
  3. This example returns 3 for the document or category for which the parent is entry 37.1.3.
    @DocParentNumber("")