FORMULA LANGUAGE
Permite manipular nombres jerárquicos. @Name le permite abreviar el formato canónico de un nombre, ampliar a su formato canónico un nombre abreviado, identificar cada uno de los componentes del nombre e invertir su orden para que pueda organizarse una vista por nombres jerárquicos.
Permite convertir nombres entre los formatos de Domino y LDAP.
Nota La conversión de LDAP es una novedad de la Versión 6.
Sintaxis
@Name( [ acción ] ; nombre )
Parámetros
[ acción ]
@Name le permite realizar las operaciones siguientes:
[A]
Da como resultado el componente ADMD (nombre del dominio de gestión de administración) de un nombre jerárquico.
[ABBREVIATE]
Abrevia un nombre jerárquico completo (suprime los rótulos de los componentes). Esto ahorra espacio durante la visualización y permite leer el nombre con más facilidad.
[ADDRESS821]
Nota Esta palabra clave es una novedad de la Versión 5.
Da como resultado una dirección de Internet basada en la sintaxis de formato de direcciones RFC 821 independientemente de si la dirección original se encontraba en formato RFC 821 o RFC 822. Las mayúsculas y minúsculas deben ser exactas.
[C]
Da como resultado el componente de un nombre jerárquico correspondiente al país/región.
[CANONICALIZE]
Amplía un nombre abreviado y añade los componentes que faltan, así como sus rótulos. Los componentes se toman del ID de usuario actual, no del Directorio de Domino.
[CN]
Da como resultado el componente de un nombre jerárquico correspondiente al nombre.
[HIERARCHYONLY]
Retira el componente nombre común de un nombre jerárquico y muestra los componentes restantes.
[I]
Da como resultado el componente de un nombre jerárquico correspondiente a las iniciales.
[LP]
Da como resultado el componente LocalPart de las direcciones de Internet estándar basadas en la sintaxis de formato de direcciones RFC 822.
[O]
Da como resultado el componente de un nombre jerárquico correspondiente a la organización.
[OUn]
Da como resultado el componente de un nombre jerárquico correspondiente a la unidad organizativa especificada; n puede ser cualquier valor del 1 al 4; por ejemplo: OU1. En el formato canónico del nombre, los componentes OU no se numeran, sino que se cuentan de derecha a izquierda, de modo que la primera vez que aparece el rótulo OU, se considera que es OU1, la segunda OU2, y así sucesivamente. Notes/Domino no acepta [OU] (sin un número) como palabra clave.
[P]
Da como resultado el componente PRMD (nombre del dominio de administración privado) de un nombre jerárquico.
[PHRASE]
Da como resultado el componente Phrase de las direcciones de Internet estándar basadas en la sintaxis de formato de direcciones RFC 822.
[Q]
Da como resultado el componente de un nombre jerárquico correspondiente a la generación "Jr").
[S]
Da como resultado el componente de un nombre jerárquico correspondiente al apellido.
[TOAT]
Nota Esta palabra clave es una novedad de la Versión 6.
Da como resultado el nombre de tipo de atributo de LDAP (AttributeType) cuando se proporciona un nombre de campo de Domino.
[TODATATYPE]
Da como resultado nombre de tipo de datos de Domino cuando se proporciona un nombre de sintaxis de LDAP (Syntax).
[TOFIELD]
Da como resultado el nombre de campo de Domino cuando se proporciona un nombre de tipo de atributo de LDAP (AttributeType).
[TOFORM]
Da como resultado el nombre de formulario de Domino cuando se proporciona un nombre de clase de objeto de LDAP (ObjectClass).
[TOKEYWORD]
Invierte el orden en que se visualizan los componentes del nombre y sustituye las barras inclinadas por barras invertidas: País\Organización\Unidad organizativa...Esto resulta útil cuando se desea organizar por categorías una vista de acuerdo con los componentes de los nombres jerárquicos (las barras invertidas representan subcategorías en las vistas). La opción [TOKEYWORD] no incluye en el resultado el elemento correspondiente al nombre común de un nombre.
[TOOC]
Da como resultado el nombre clase de objeto de LDAP (ObjectClass) cuando se proporciona un nombre de formulario o subformulario de Domino.
[TOSYNTAX]
Da como resultado el nombre de sintaxis de LDAP (Syntax) cuando se proporciona un nombre de tipo de datos de Domino.
@Name resulta especialmente útil para abreviar nombres jerárquicos en una vista.
Un nombre jerárquico consta de varios componentes: un nombre completo (nombre y apellidos), una o varias unidades organizativas, una organización y un país o región. El uso de nombres jerárquicos impide que puedan existir dos usuarios o servidores con el mismo nombre.
Como diseñador de bases de datos, usted es responsable de controlar el modo en que los nombres de los usuarios se introducen y se visualizan en las aplicaciones de Notes. Para simplificar las cosas, siempre debe permitir a los usuarios que introduzcan los nombres de manera abreviada; después puede utilizar @Name para ampliarlos a su formato canónico. Del mismo modo, conviene que sus aplicaciones muestren los nombres de forma abreviada, por lo que deberá emplear @Name para convertir a formato abreviado el formato canónico contenido en los campos.
Cuando se emplean campos de nombres, de autores o de lectores, Lotus Notes/Domino convierte automáticamente los nombres jerárquicos en un formato adecuado para su visualización y su almacenamiento. Si el usuario introduce un nombre abreviado, Lotus Notes/Domino lo amplía a su formato canónico para almacenarlo, pero, en un formulario, siempre lo muestra en forma abreviada.
Cuando se visualiza en una vista el contenido de un campo con nombres jerárquicos, no se produce la conversión automática, sino que se muestra todo el formato canónico del nombre. Probablemente le convendrá convertir el nombre en su forma abreviada por medio de @Name.
Si usa @Name para analizar una dirección de Internet, la dirección debe ajustarse al formato basado en la sintaxis de formato de direcciones estándar RFC 821 o RFC 822.
Nota Si intenta utilizar los parámetros A, G, I, P, Q o S en Lotus Notes/Domino con archivos ID de usuario existentes podría dar la impresión de que los parámetros no funcionan. Estos parámetros han sido agregados para aprovechar la asignación de direcciones usada por productos de gateway y de correo externos. Cuando se recibe un mensaje de correo en Lotus Notes/Domino desde una fuente de correo externa, los nombres pueden incluir componentes adicionales. La función @Name puede utilizarse para manipular el nombre jerárquico, incluidos los componentes adicionales. Los ID y nombres de Domino no utilizan estos componentes adicionales, por lo que no es posible usar estos seis parámetros con nombres y archivos ID de Domino estándar.
A continuación se muestra un ejemplo de nombre jerárquico completo que aprovecha cada uno de estos parámetros.
G=Jorge/I=JS/S=Salgado/Q=Jr/CN=José Salgado/OU=Asamblea/OU=Ingeniería/O=MyC/P=AdminPriv/ A=AdminPub/C=ES
Equivalencias en otros lenguajes
Clase NotesName de LotusScript
Clase Name de Java
Ejemplo Véase también