FORMULA LANGUAGE


@Name
Example

Allows you to manipulate hierarchical names. You can abbreviate the canonical format of a name, expand an abbreviated name to its canonical format, identify particular components within the name, and reverse the order of the components so that you can categorize a view by hierarchical names.

Enables you to convert a name between the Domino and LDAP formats.

Note LDAP conversion is new with Release 6.

Syntax

@Name( [ action ] ; name )

Parameters

[ action ]


name
Usage

@Name is particularly useful for abbreviating hierarchical names in a view.

A hierarchical name is qualified with a series of components identifying the full name, organizational unit, organization, and country or region. Using hierarchical names guarantees that each user and server has a unique name.

As the database designer, you are responsible for controlling how user names are entered and displayed within Notes applications. For simplicity, you should allow users to enter names in abbreviated form; then you can use @Name to expand the name to its canonical format. You should also display names in abbreviated form, using @Name to convert the stored canonical format of the name to its abbreviated form.

When you use a Names, Readers, or Authors field, Lotus Notes/Domino automatically converts hierarchical names to an appropriate format for display and storage. If the user enters an abbreviated name, Lotus Notes/Domino expands it to canonical format when storing it; the name is always displayed on a form in abbreviated format.

When you display the contents of a hierarchical name field in a view there is no automatic conversion; the entire canonical format of the name is displayed. You may want to convert the name to its abbreviated form with @Name.

If you are using @Name to parse an Internet address, the address must conform to the format based on the standard RFC 821 or RFC 822 Address Format Syntax.

Note If you attempt to use the parameters A, G, I, P, Q, or S in Lotus Notes/Domino with existing user IDs, it may appear as though the parameters do not work. These parameters were added to take advantage of the addressing used for external mail and gateway products. When a mail message is received within Lotus Notes/Domino from an external mail source, the naming convention can include additional components. The @Name function can be used to manipulate the hierarchical name, including these additional components. Domino IDs and names do not use these additional components, therefore, it is not possible to use these six parameters with a standard Domino ID and name.

Below is an example of a full hierarchical name that takes advantage of every parameter.

G=Joe/I=JS/S=Smith/Q=Jr/CN=Joseph Smith/OU=Assembly/OU=Engineering/O=Acme/P=PrivAdmin/ A=PubAdmin/C=US

Language cross-reference

LotusScript NotesName class

Java Name class

Example
See Also