17.1 關於詳細資料入口網站應用程式
「詳細資料」入口網站應用程式會為使用者提供實體屬性及其值的詳細檢視窗。 入口網站應用程式具有兩種模式： 顯示和編輯。 存取「詳細資料」入口網站應用程式時，使用者可以利用其內建功能來處理此資訊，包含：
- 節 17.1.1, 顯示實體資料
- 節 17.1.2, 編輯實體資料
- 節 17.1.3, 以電子郵件傳送實體資料 (僅限顯示模式)
- 節 17.1.4, 連結至組織圖
- 節 17.1.5, 連結至其他實體的詳細資料 (僅限顯示模式)
- 節 17.1.6, 列印實體資料 (僅限顯示模式)
17.1.1 顯示實體資料
存取它時，「詳細資料」入口網站應用程式會顯示選定實體的屬性資料，例如使用者或群組。 例如，下面是使用者 Bill Brown 檢視自己的資訊時，「詳細資料」入口網站應用程式可能會顯示的內容：
使用者影像 在預設狀態下，「詳細資料」入口網站應用程式的組態會設定為包含「使用者照片」屬性。 然而，如果您的身份儲存區不包含或未填入此屬性，則在執行時期會顯示預設的影像。 如果您將使用者影像儲存在不同的位置，則可以將入口網站應用程式的組態設定為顯示這些影像。
如需相關資訊，請參閱動態載入影像。
決定要顯示的屬性
「詳細資料」入口網站應用程式僅顯示符合下列條件的屬性：
- 目錄抽象層資料定義可以檢視的屬性
如需 VDD 組態的相關資訊，請參閱節 4.0, 設定目錄抽象層的組態。
- 在「詳細資料」優先設定中指定的屬性
若要瞭解指定「詳細資料」入口網站應用程式中顯示的屬性，請參閱節 17.5, 設定優先設定。
- 目前使用者具有檢視權限的屬性
例如，具有薪水屬性檢視權限的管理員可以查看薪水資料，但是其他使用者無法查看。
如需相關資訊，請參閱節 17.2.2, 指定實體的權限。
- 目前已填入值的屬性
決定屬性的顯示方式
顯示屬性時，「詳細資料」會將資料格式化為文字，但是在下列情況中例外：
決定標題區域顯示的內容
您可以使用標準的 HTML 功能，配置「詳細資料」入口網站應用程式的標題區域：
「詳細資料」優先設定會提供HTML 配置編輯器，您可以使用它來建立想要的外觀和內容：
使用 HTML 配置編輯器
「HTML 配置編輯器」會提供定義文字格式和清單，以及指定錨點和影像等 HTML 編輯器的一般功能。
關鍵字 設計配置時，您可以使用「關鍵字」下拉式功能表，將變數插入至「詳細資料」入口網站應用程式的標題區域內，這些變數會在執行時期由特定的屬性值取代。 您還可以使用下列語法進行輸入：
$[[keyword]]
其中，keyword 是屬性 (例如 LastName) 的值。
您可以使用此語法來串連屬性：
$[[keyword+keyword]]
例如：
$[[FirstName+LastName]]
您可以視需要串連多個屬性，也可以併入用引號括住的字串，如下所示：
$[[keyword+”sample text”+keyword]]
這樣會轉換用引號括住的文字和關鍵字的值。
附註：如果配置中的關鍵字輸入錯誤，則會在執行時期按原樣轉換 (包含 $[[]])。
動態載入影像 若要顯示影像，例如顯示身份儲存區中儲存的使用者照片，您可以使用「HTML 配置編輯器」新增屬性名稱。 例如，新增「使用者照片」屬性會顯示使用者的照片。 如果您將影像儲存在身份儲存區外部，則需要使用 IMG: 標籤 (在「HTML 編輯器」的「檢視來源」模式中)，如下所示：
-
移至入口網站應用程式的優先設定，並存取「HTML 編輯器」。
-
按一下「檢視來源」。
-
使用 IMG: 標籤利用下列語法結合位置、屬性鍵和副檔名，如下所示：
$[[IMG:”URL” + attribute-key-name + ”fileextension”]]
如果您將員工照片做為 JPG 影像按照「姓」儲存在應用程式伺服器的 /images 子目錄中，則下列範例會顯示您所使用的語法：
$[[IMG:"http://myhost:8080/images/"+LastName+".jpg"]]
在執行時期，入口網站應用程式會串連 URL 與 LastName 屬性和副檔名 .jpg。
請注意，「HTML 編輯器」支援靈活的語法。 它支援文字和屬性的任何組合，因此語法可以是：
$[[IMG:”some text” + attribute-key-name + ...]]
17.1.2 編輯實體資料
「詳細資料」入口網站應用程式會自動提供「編輯」連結 (例如「編輯您的資訊」或「編輯使用者」或「編輯設備」)，以從顯示模式切換至編輯模式。 這可讓具有目前實體適當權限的使用者變更其屬性值並儲存這些變更。
例如，下面是使用者 Bill Brown (具有必要的權限) 編輯自己的資訊時，「詳細資料」可能會顯示的內容：
附註：若為布林值屬性，同時不選這兩個選項圓鈕表示使用者的屬性不存在。 核取 true 或 false 選項圓鈕都會針對使用者建立屬性並設定其值。
決定會顯示的屬性
在編輯模式中，「詳細資料」入口網站應用程式僅顯示符合下列條件的那些屬性：
- 目錄抽象層資料定義使屬性可以檢視
如需資料定義的相關資訊，請參閱節 4.0, 設定目錄抽象層的組態。
- 目前使用者具有檢視屬性的權限
例如，具有薪水屬性檢視權限的經理可以查看資料，但是其他使用者無法查看。
如需相關資訊，請參閱節 17.2.2, 指定實體的權限。
屬性必須滿足上述全部的條件，才能以編輯模式顯示。
決定屬性的顯示方式
在編輯模式中，「詳細資料」會將每個可編輯的屬性格式化為文字方塊，但是在下列情況中例外：
無法編輯 (依定義或由於使用者權限不足) 的屬性會顯示為已停用或唯讀。
驗證變更
在編輯期間，系統會針對下列屬性類型規格自動執行資料驗證：
- 格式： 電子郵件
- 資料類型： 整數
- 控制項類型： 範圍
使用本地或全域清單的控制項類型時，顯示的清單可能包含屬性指定邊界之外的值。 但是此類值會設旗標為超出範圍，且驗證會阻止提交這些值。
定義預設我的設定檔實體
在目錄抽象層定義實體時，您可以指定「預設我的設定檔實體」(在目錄抽象層編輯器的「組態」元素中) 的值，以指定要使用其他實體定義進行編輯。 從顯示模式切換至編輯模式時，「詳細資料」入口網站應用程式會一直檢查是否已指定此元素，然後使用適當的實體定義呈現屬性。
例如，假設「學生」的實體定義包含 user 做為「預設我的設定檔實體」的值。 在此情況下，顯示模式會使用「學生」實體定義，但是編輯模式會使用使用者實體定義。
17.1.3 以電子郵件傳送實體資料
「詳細資料」入口網站應用程式會自動提供名稱為「傳送身份資訊」的連結。 使用者可以按一下該連結，將目前實體「詳細資料」的 URL 以電子郵件傳送給一或多個其他使用者。 因為電子郵件傳送的是「詳細資料」URL 而不是實際的資訊，所以可以維護安全性 (因為收到 URL 的人員需要適當的權限才能使用它)。
17.1.4 連結至組織圖
「詳細資料」入口網站應用程式會自動提供名稱為「顯示組織圖」的連結。 使用者可以按一下此連結，以顯示目前實體的「組織圖」入口網站應用程式。
例如，如果您檢視使用者 Bill Brown 的「詳細資料」，按一下此連結即會顯示：
如需「組織圖」入口網站應用程式的相關資訊，請參閱節 18.0, 組織圖入口網站應用程式參考資訊。
17.1.5 連結至其他實體的詳細資料
設定「詳細資料」入口網站應用程式的組態時，建議您讓使用者從目前的實體連結至相關實體。 您可以藉由併入以控制項類型 DNLookup定義 (在目錄抽象層中) 的屬性，來執行此操作。
當「管理員」屬性顯示在使用者的「詳細資料」中時，它會顯示為連結。 按一下該連結，即會顯示「管理員」的「詳細資料」。
如需目錄抽象層的相關資訊，請參閱節 4.0, 設定目錄抽象層的組態。
若要瞭解指定「詳細資料」入口網站應用程式中顯示的屬性，請參閱節 17.5, 設定優先設定。
17.1.6 列印實體資料
在預設狀態下，「詳細資料」入口網站應用程式的顯示設定會啟用入口網站應用程式標題列上的「列印」選項。 如果保持「列印」為啟用狀態，使用者可以按一下該項，以顯示「詳細資料」內容的友善列印格式版本：
若要變更「詳細資料」入口網站應用程式的此設定或其他設定，請使用「管理員」索引標籤更新 DetailPortlet (在「入口網站應用程式管理」頁面上) 的「入口網站應用程式註冊」。
如需相關資訊，請參閱節 9.0, 入口網站應用程式管理。