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.
@Name( [ action ] ; name )
[ action ]
Keyword. Indicates what you want done to the name -- whether you want to expand it, abbreviate it, convert it, and so on (see list of possible actions).
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]
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]
[G]
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.
[OU n ]
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 first to last 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]
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.
name
Text or names, or text or names list. A user or server name, entered in any form (Notes/Domino determines the full hierarchical name and then returns the requested components) or an LDAP AttributeType, ObjectClass, or Syntax name or a Domino form, subform, field, or data type name to be converted from LDAP to Domino format or vice-versa.
formattedname
Text or names, or text or names list. The second parameter formatted according to the first parameter.
@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, Notes/Domino automatically converts hierarchical names to an appropriate format for display and storage. If the user enters an abbreviated name, 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.
The following 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
@Name([ABBREVIATE];AUTHOR)
@Name([CANONICALIZE];"Mary Tsen")
Since there is no slash following the name, it is a nonhierarchical name and has no additional components.
@Name([CANONICALIZE];"Mary Tsen/")
@Prompt([Ok]; "Common Name"; @Name([CN]; AUTHOR))
@Name([OU2];AUTHOR)
@Name([TOKEYWORD];AUTHOR)
@Name([LP];User_Name)
@Name([Phrase];User_Name)
@Name([ADDRESS821];User_Name)
@Name([HIERARCHYONLY];User_Name)
@Name([TOAT];"assistant")
@Name([TOFIELD];"mail")
@Name([TODATATYPE];"Integer")
@Name([TOSYNTAX];"Text")
@Name([CN]; "Mary Tsen/Acme/US" : "Jacques Blanc/Acme/FR")