FORMULA LANGUAGE
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 ]
With @Name, you can perform the following actions:
[A]
Returns the ADMD component (administration management domain name) of a hierarchical name.
[ABBREVIATE]
Abbreviates a hierarchical name, removing the component labels. This saves space in the display, and looks friendlier.
[ADDRESS821]
Note This keyword is new with R5.
Returns an Internet address in the format based on RFC 821 Address Format Syntax regardless of whether the original address was in RFC 821 or RFC 822 form. Case must be exact.
[C]
Returns the country/region component of a hierarchical name.
[CANONICALIZE]
Expands an abbreviated name, adding in whatever components are missing, as well as their labels. Missing components are taken from the current user ID, not from the Domino Directory.
[CN]
Returns the given name component (the first name) of a hierarchical name.
[HIERARCHYONLY]
Strips the CN component of a hierarchical name and returns the remaining components.
[I]
Returns the initials component of a hierarchical name.
[LP]
Returns the LocalPart of a standard Internet address based on RFC 822 Address Format Syntax.
[O]
Returns the organization component of the hierarchical name.
[OUn]
Returns the specified organizational unit component of a hierarchical name; n can be from 1 to 4, as in OU1. In the canonical form of the name, the OU components are not numbered; however, they are counted from right to left so that the first occurrence of the OU label is treated as OU1, the second occurrence is treated as OU2, and so on. Notes/Domino does not accept [OU] as a keyword.
[P]
Returns the PRMD component (private management domain name) of a hierarchical name.
[PHRASE]
Returns the Phrase part of a standard Internet address based on RFC 822 Address Format Syntax.
[Q]
Returns the generation component (such as "Jr") of a hierarchical name.
[S]
Returns the surname component (the last name) of a hierarchical name.
[TOAT]
Note This keyword is new with Release 6.
Returns the LDAP AttributeType name when a Domino field name is provided.
[TODATATYPE]
Returns the Domino data type name when an LDAP Syntax name is provided.
[TOFIELD]
Returns the Domino field name when an LDAP AttributeType name is provided.
[TOFORM]
Returns the Domino form name when an LDAP ObjectClass name is provided.
[TOKEYWORD]
Reverses the order in which the naming components are displayed, and replaces slashes with backslashes: Country\Organization\Organization Unit... This is useful when you want to categorize a view by the components of a user's hierarchical name (backslashes represent subcategories in views). The [TOKEYWORD] option does not return the Common Name portion of the user name.
[TOOC]
Returns the LDAP ObjectClass name when a Domino form or subform name is provided.
[TOSYNTAX]
Returns the LDAP Syntax name when a Domino data type name is provided.
formattedname
@Name is particularly useful for abbreviating hierarchical names in a view.
If the second parameter is a list, the function operates on each element of the list, and the return value is a list with the same number of elements.
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