NDS Attribute Macros

Application Launcher/Explorer supports macros that pull information from the attributes of the currently logged-in user, the current Application object, or from the attributes of other NDS objects.

The following sections explain the macro syntax and provide examples:

For information about using the macros in a valid Application object property, see Application Object Properties Where Macros Can Be Used.

Syntax

NDS attribute macros use the following syntax:

%object_name.container;NDS_attribute%

Element	Description
%	Flags the text as a macro. The entire macro must be enclosed in % characters.
.object_name.container;	Indicates the NDS object from which to read the attribute. To use an attribute from the currently logged in user, leave this element out. For example, %CN% would return the common name of the currently logged in user. To use an attribute from the Application object, replace .object_name.container with an asterisk (). For example, %;DN% would return the distinguished name of the Application object.
NDS_attribute	Defines the attribute to be read. You can use the ConsoleOne Schema Manager (available from the Tools menu) to view an NDS object's available attributes.

Element

Description

Flags the text as a macro. The entire macro must be enclosed in % characters.

.object_name.container;

Indicates the NDS object from which to read the attribute.

To use an attribute from the currently logged in user, leave this element out. For example, %CN% would return the common name of the currently logged in user.

To use an attribute from the Application object, replace .object_name.container with an asterisk (*). For example, %*;DN% would return the distinguished name of the Application object.

NDS_attribute

Defines the attribute to be read.

You can use the ConsoleOne Schema Manager (available from the Tools menu) to view an NDS object's available attributes.

Examples

The following table provides examples of NDS attribute macros.

Macro	Description
%CN%	Returns the common name of the currently logged-in user.
%DN%	Returns the distinguished name of the currently logged-in user.
%Given Name%	Returns the first name of the currently logged-in user.
%Surname%	Returns the last name of the currently logged-in user.
%Full Name%	Returns the full name of the currently logged-in user.
%Email Address%	Returns the e-mail address of the currently logged-in user.
%*;DN%	Returns the distinguished name of the Application object (the one in which the macro is being used).
%*;App:Caption%	Returns the application icon title given the Application object.
*;App:Path%	Returns the path to the application's executable as defined for the Application object.
%*;App:GUID%	Returns the Application object's global unique identifier (GUID).
%.JSmith.Novell;Description%	Returns the description for the JSmtih User object located in the Novell container.
%.ABurrough.Novell;Email Address%	Returns the e-mail address for the ABurrough User object located in the Novell container.