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: 标签,方法如下所示:

  1. 转至入口小程序的自选设置,访问 HTML 编辑器。

  2. 单击《查看来源》

  3. 使用 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(具有所需的权限)编辑自己的信息时细节入口小程序可能显示的内容:

说明:说明: 图示

注:对于布尔特性,如果两个单项选择按钮都未选中,则表示用户不具有该特性。 选中 TrueFalse 单项选择按钮,可以同时为用户创建此特性并设置值。

确定要显示的特性

在编辑模式下,细节入口小程序仅显示以下特性:

  • 目录提取层数据定义提供用于查看的特性

    有关数据定义的更多信息,请参见部分 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, 入口小程序管理