Novell Documentation: Novell Identity Manager 3

17.1 关于细节入口小程序

细节入口小程序为用户提供了实体的特性及特性值的细节视图。入口小程序有以下两种模式：显示模式和编辑模式。访问细节入口小程序时，用户可以利用其内置功能处理这些信息，这些功能包括：

17.1.1 显示实体数据

访问细节入口小程序时，将显示选定实体，如用户或组的特性数据。例如，下面是用户 Bill Brown 查看自己的信息时，细节入口小程序可能显示的内容：

用户图像 默认情况下，细节入口小程序的配置包括 User Photo 特性。但如果 Identity Vault 中不包括此特性或未填充此特性，运行时会显示默认图像。如果将用户图像储存在其它位置，可以通过配置入口小程序来显示它们。

有关更多信息，请参见动态装载图像。

确定要显示的特性

细节入口小程序仅显示以下特性：

目录提取层数据定义提供用于查看的特性
有关 VDD 配置的更多信息，请参见部分 4.0, 配置目录提取层。
在细节自选设置中指定的特性
要了解细节入口小程序中指定将显示的特性，请参见部分 17.5, 设置自选设置。
当前用户具有查看权限的特性
例如，对薪水特性有权限的经理将看到这些数据，但其他用户看不到。

有关更多信息，请参见部分 17.2.2, 指派实体权限。
当前由值填充的特性

确定特性的显示方式

显示特性时，细节入口小程序会将数据格式设置为文本，但以下情况除外：

提取层定义中的格式规格	显示方式
格式：电子邮件	作为 mail-to 链接
格式： GroupWise-IM AOL-IM Yahoo-IM	作为启动交谈和添加该用户的图标
数据类型：二进制格式：图像	作为查看图像的按钮和链接
数据类型：布尔值	作为指示 True 或 False 的已禁用单项选择按钮这些按钮在显示时未指示默认值，这是因为在用户指定值之前，不会实际创建此特性。
多值：选中	作为可重复使用的编辑、添加和去除单个特性值的控件集（以逗号分隔列表的形式）
控制类型：DNLookup	作为链接在上述示例中，显示链接 (`Terry Mellon`) 以访问 Bill Brown 的经理的细节数据。
控制类型：本地列表全局列表	作为显示标签，而不是实际（键）值例如，EmployeeType 特性显示为 `Full Time`，而不是实际值 `ft`。

确定标题区域显示的内容

可以使用标准 HTML 功能对细节入口小程序的标题区域进行布局：

细节自选设置提供了 HTML 布局编辑器，可以使用该编辑器创建所需的外观和内容：

使用 HTML 布局编辑器

HTML 布局编辑器提供了 HTML 编辑器的典型功能，可用于定义文本格式和列表，指定锚和图像等。

关键字 设计布局时，可以使用《关键字》下拉菜单在细节入口小程序的标题区域插入变量，运行时可用特定特性值替换这些变量。也可以使用以下语法键入关键字：

$[[keyword]]

其中，关键字为特性值（如 LastName）。

可以使用以下语法来连结特性：

$[[keyword+keyword]]

例如：

$[[FirstName+LastName]]

可以根据需要连结多个特性，也可以包括引号中的字符串，如下所示：

$[[keyword+”sample text”+keyword]]

将显示关键字的值和引号中的文本。

注：在布局中错误键入关键字时，运行时将显示为其原来的样式（包括 $[[]]）。

动态装载图像 若要显示储存在 Identity Vault 中的图像（如用户照片），可以使用 HTML 布局编辑器添加此特性名称。例如，添加 User Photo 特性可以显示用户的照片。如果图像储存在 Identity Vault 以外，则需要在 HTML 编辑器中的《查看来源》方式下使用 IMG: 标签，方法如下所示：

转至入口小程序的自选设置，访问 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, 指派实体权限。

特性必须满足上述所有准则，才能在编辑模式中显示。

确定特性的显示方式

在编辑模式下，细节入口小程序将每个可编辑的特性格式化为文本框，但以下情况除外：

特性类型规格（在 VDD 文件中）	显示方式
数据类型：二进制格式：图像	作为实体图像上载入口小程序的按钮和链接，用于查看、更新或添加图像
数据类型：布尔值	作为指示 True 或 False 的单项选择按钮
隐藏：选中	作为标为《隐藏》的复选框
多值=选中	作为控件集，用于编辑、添加和去除特性值
控制类型： DNLookup	作为起动参数列表入口小程序的按钮，用于搜索和选择 DN
控制类型：本地列表全局列表	作为下拉列表（如果可用，允许多项选择）

无法编辑的特性（由于定义或由于用户权限不足）将显示为禁用或只读。

验证更改

在编辑期间，将自动执行以下特性类型规范的数据验证：

格式：电子邮件
数据类型：整数
控制类型：范围

使用本地列表或全局列表控制类型时，显示的列表中可能包括特性指定界限以外的值。但这些值将被标记为超出范围，验证将阻止其提交。

定义默认的我的简报实体

在目录提取层定义实体时，可以指定默认的我的简报实体的值（在目录提取层编辑器的 Configuration 要素中），以指定用于编辑的其它实体定义。从显示模式切换到编辑模式时，细节入口小程序始终检查是否已指定此要素，然后使用适当的实体定义显示特性。

例如，假定学生的实体定义包括作为默认的我的简报实体值的用户。在这种情况下，显示模式将使用学生实体定义，但编辑模式将使用用户实体定义。

17.1.3 通过电子邮件发送实体数据

细节入口小程序自动提供名为《发送身份信息》的链接。用户可以单击它，将当前实体《细节》的 URL 通过电子邮件发送至一个或多个用户。通过电子邮件发送细节 URL（而不是实际信息），可以维护安全性（因为任何收到此 URL 的人都需要适当授权才能使用它）。

17.1.4 组织结构图链接

细节入口小程序自动提供名为《显示组织结构图》的链接。用户可以单击它，以显示当前实体的组织结构图入口小程序。

例如，如果要查看用户 Bill Brown 的《细节》，单击此链接将显示：

有关组织结构图入口小程序的更多信息，请参见部分 18.0, 组织结构图入口小程序参照。

17.1.5 其它实体细节的链接

配置细节入口小程序时，可能希望用户能够从当前实体链接到相关实体。将使用控制类型 DNLookup 在目录提取层中定义的特性包括在内即可实现。

如果 Manager 特性显示在用户的《细节》中，将显示为链接。单击该链接将显示该用户的经理的《细节》。

有关目录提取层的更多信息，请参见部分 4.0, 配置目录提取层。

要了解细节入口小程序中显示哪些特性，请参见部分 17.5, 设置自选设置。

17.1.6 打印实体数据

默认情况下，细节入口小程序的显示设置会在入口小程序的标题栏上启用《打印》选项。如果启用《打印》，用户可以单击它，以显示细节内容的打印机友好版本：

若要更改细节入口小程序的此项设置或其它设置，请使用《管理》选项卡更新 DetailPortlet 的入口小程序注册（在《入口小程序管理》页上）。

有关更多信息，请参见部分 9.0, 入口小程序管理。