Novell Doc: Novell ZENworks 7 Desktop Management Administration Guide

49.4 eDirectory Attribute Macros

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

The following sections explain the macro syntax and provide examples:

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

49.4.1 Syntax

eDirectory attribute macros use the following syntax:

%object_name.container;eDirectory_attribute%

Table 49-4 Macro Syntax

Element	Description
%	Flags the text as a macro. The entire macro must be enclosed in% characters.
.object_name.container;	Indicates the eDirectory 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.
eDirectory_attribute	Defines the attribute to be read. You can use the ConsoleOne Schema Manager (available from the Tools menu) to view an eDirectory 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 eDirectory 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.

eDirectory_attribute

Defines the attribute to be read.

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

49.4.2 Examples

The following table provides examples of eDirectory attribute macros.

Table 49-5 Macro Examples

Macro	Description
%CN%	Returns the common name of the currently logged-in user.
%DN%	Returns the distinguished name of the currently logged-in user.
%Full Name%	Returns the full name of the currently logged-in user. This is the name defined in User object > General tab > Identification page > Full Name field.
%Given Name%	Returns the first name of the currently logged-in user. This is the name defined in User object > General tab > Identification page > Given Name field.
%Surname%	Returns the last name of the currently logged-in user. This is the name defined in the User object > General tab > Identification page > Last Name field.
%*;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. This is the title defined in the Application object > Identification tab > Icon page > Application Icon Title field.
*;App:Path%	Returns the path to the application's executable as defined for the Application object. This is the path defined in the Application object > Run Options tab > Application page > Path to File field.
%*;App:GUID%	Returns the Application object's global unique identifier (GUID). This is the GUID defined in the Application object > Distribution Options tab > Options page > GUID field.
%.JSmith.Novell;Description%	Returns the description for the JSmtih User object located in the Novell container. This is the description defined in the User object > General tab > Identification page > Description field.