Novell Documentation: ZENworks 7 - eDirectory 屬性巨集

49.4 eDirectory 屬性巨集

應用程式啟動器支援從目前登入的使用者和目前的應用程式物件的屬性，或從其他 eDirectory 物件的屬性取得資訊的巨集。

以下各節說明巨集語法並提供範例：

如需有關在有效的應用程式物件內容中使用巨集的資訊，請參閱節 49.8, 可以使用巨集的應用程式物件內容。

49.4.1 語法

eDirectory 屬性巨集使用以下語法：

%object_name.container;eDirectory_attribute%

表 49-4 巨集語法

元件	描述
`%`	將文字標記為巨集。整個巨集必須用 % 字元圍住。
.object_name.container;	表示要從中讀取屬性的 eDirectory 物件。若要使用目前登入使用者的屬性，則省去此元件。例如，%CN% 將傳回目前登入使用者的公用名稱。若要使用應用程式物件的屬性，請將 .object_name.container 替換為星號 ()。例如，%;DN% 將傳回應用程式物件的可辨識名稱。
eDirectory_attribute	定義要讀取的屬性。您可以使用 ConsoleOne 綱要管理員 (可從「工具」功能表存取) 來檢視 eDirectory 物件的可用屬性。

元件

描述

%

將文字標記為巨集。整個巨集必須用 % 字元圍住。

.object_name.container;

表示要從中讀取屬性的 eDirectory 物件。

若要使用目前登入使用者的屬性，則省去此元件。例如，%CN% 將傳回目前登入使用者的公用名稱。

若要使用應用程式物件的屬性，請將 .object_name.container 替換為星號 (*)。例如，%*;DN% 將傳回應用程式物件的可辨識名稱。

eDirectory_attribute

定義要讀取的屬性。

您可以使用 ConsoleOne 綱要管理員 (可從「工具」功能表存取) 來檢視 eDirectory 物件的可用屬性。

49.4.2 範例

下表提供 eDirectory 屬性巨集範例。

表 49-5 巨集範例

巨集	描述
`%CN%`	傳回目前登入使用者的公用名稱。
`%DN%`	傳回目前登入使用者的可辨識名稱。
`%Full Name%`	傳回目前登入使用者的全名。即在使用者物件 >「一般」索引標籤 >「識別資料」頁 >「全名」欄位中定義的名稱。
`%Given Name%`	傳回目前登入使用者的名。即在使用者物件 >「一般」索引標籤 >「識別資料」頁 >「名」欄位中定義的名稱。
`%Surname%`	傳回目前登入使用者的姓。即在使用者物件 >「一般」索引標籤 >「識別資料」頁 >「姓」欄位中定義的名稱。
`%*;DN%`	傳回應用程式物件 (正在其中使用巨集的物件) 的可識別名稱。
`%*;App:Caption%`	傳回應用程式物件的應用程式圖示標題。即在應用程式物件 >「識別資料」索引標籤 >「圖示」頁 >「應用程式圖示標題」欄位中定義的標題。
`*;App:Path%`	傳回為應用程式物件定義的應用程式可執行檔的路徑。即在應用程式物件 >「執行選項」索引標籤 >「應用程式」頁 >「檔案的路徑」欄位中定義的路徑。
`%*;App:GUID%`	傳回應用程式物件的全域唯一識別碼 (Global Unique Identifier, GUID)。即在應用程式物件 >「配送選項」索引標籤 >「選項」頁 >「GUID」欄位中定義的 GUID。
`%.JSmith.Novell;Description%`	傳回位於 Novell 容器中 JSmtih 使用者物件的描述。即在使用者物件 >「一般」索引標籤 >「識別資料」頁 >「描述」欄位中定義的描述。