RootName

Use this function to extract and return the root name, or the original part of the name, of a string you specify. This function strips off the #nnn portion of a field name to get the root field name.

Note Documaker requires that all fields on a section be uniquely named. Studio forces a unique name if a field is duplicated. Appending #002 or #003, for example, to the end of the field name creates unique names. In some cases you may want to use the name of a field to supply the name of a data dictionary symbol to use to fill that field. If each unique instance of a field is to use the same name, this can present a problem.

Syntax

RootName (Field)

Parameter

Description

Field

Enter the name of the field for which you want the system to return the root portion of that name.

Example

Here are some examples:

RootName("Street address #002")

This returns Street address.

MYFIELDNAME = "Comment #003"
  RootName(MYFIELDNAME)

This returns Comment.

RootName(FieldName())

This returns the root name of the current field.

See also