细节入口小程序为用户提供了实体的特性及特性值的细节视图。 入口小程序有以下两种模式: 显示模式和编辑模式。 访问细节入口小程序时,用户可以利用其内置功能处理这些信息,这些功能包括:
访问细节入口小程序时,将显示选定实体,如用户或组的特性数据。 例如,下面是用户 Bill Brown 查看自己的信息时,细节入口小程序可能显示的内容:
用户图像 默认情况下,细节入口小程序的配置包括 User Photo 特性。 但如果 Identity Vault 中不包括此特性或未填充此特性,运行时会显示默认图像。 如果将用户图像储存在其它位置,可以通过配置入口小程序来显示它们。
有关更多信息,请参见动态装载图像。
细节入口小程序仅显示以下特性:
有关 VDD 配置的更多信息,请参见部分 4.0, 配置目录提取层。
要了解细节入口小程序中指定将显示的特性,请参见部分 17.5, 设置自选设置。
例如,对薪水特性有权限的经理将看到这些数据,但其他用户看不到。
有关更多信息,请参见部分 17.2.2, 指派实体权限。
显示特性时,细节入口小程序会将数据格式设置为文本,但以下情况除外:
可以使用标准 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 + ...]]
细节入口小程序自动提供编辑链接(如《编辑您的信息》、《编辑用户》或《编辑设备》),以便从显示模式切换到编辑模式。 这样用户就对当前实体具有适当的权限,可以更改其特性值并保存这些更改。
例如,以下是用户 Bill Brown(具有所需的权限)编辑自己的信息时细节入口小程序可能显示的内容:
注:对于布尔特性,如果两个单项选择按钮都未选中,则表示用户不具有该特性。 选中 True 或 False 单项选择按钮,可以同时为用户创建此特性并设置值。
在编辑模式下,细节入口小程序仅显示以下特性:
有关数据定义的更多信息,请参见部分 4.0, 配置目录提取层。
例如,对薪水特性有权限的经理将看到这些数据,但其他用户看不到。
有关更多信息,请参见部分 17.2.2, 指派实体权限。
特性必须满足上述所有准则,才能在编辑模式中显示。
在编辑模式下,细节入口小程序将每个可编辑的特性格式化为文本框,但以下情况除外:
无法编辑的特性(由于定义或由于用户权限不足)将显示为禁用或只读。
在编辑期间,将自动执行以下特性类型规范的数据验证:
使用本地列表或全局列表控制类型时,显示的列表中可能包括特性指定界限以外的值。 但这些值将被标记为超出范围,验证将阻止其提交。
在目录提取层定义实体时,可以指定默认的我的简报实体的值(在目录提取层编辑器的 Configuration 要素中),以指定用于编辑的其它实体定义。 从显示模式切换到编辑模式时,细节入口小程序始终检查是否已指定此要素,然后使用适当的实体定义显示特性。
例如,假定学生的实体定义包括作为默认的我的简报实体值的用户。 在这种情况下,显示模式将使用学生实体定义,但编辑模式将使用用户实体定义。
细节入口小程序自动提供名为《发送身份信息》的链接。 用户可以单击它,将当前实体《细节》的 URL 通过电子邮件发送至一个或多个用户。 通过电子邮件发送细节 URL(而不是实际信息),可以维护安全性(因为任何收到此 URL 的人都需要适当授权才能使用它)。
细节入口小程序自动提供名为《显示组织结构图》的链接。 用户可以单击它,以显示当前实体的组织结构图入口小程序。
例如,如果要查看用户 Bill Brown 的《细节》,单击此链接将显示:
有关组织结构图入口小程序的更多信息,请参见部分 18.0, 组织结构图入口小程序参照。
配置细节入口小程序时,可能希望用户能够从当前实体链接到相关实体。 将使用控制类型 DNLookup 在目录提取层中定义的特性包括在内即可实现。
如果 Manager 特性显示在用户的《细节》中,将显示为链接。 单击该链接将显示该用户的经理的《细节》。
有关目录提取层的更多信息,请参见部分 4.0, 配置目录提取层。
要了解细节入口小程序中显示哪些特性,请参见部分 17.5, 设置自选设置。
默认情况下,细节入口小程序的显示设置会在入口小程序的标题栏上启用《打印》选项。 如果启用《打印》,用户可以单击它,以显示细节内容的打印机友好版本:
若要更改细节入口小程序的此项设置或其它设置,请使用《管理》选项卡更新 DetailPortlet 的入口小程序注册(在《入口小程序管理》页上)。
有关更多信息,请参见部分 9.0, 入口小程序管理。