18.2 配置组织结构图入口小程序

要配置组织结构图入口小程序，需执行以下任务：

步骤

任务

说明

1

定义要显示的关系

可以使用与 Identity Manager 用户应用程序一起安装的某个预定义关系，或创建自己的关系。

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

2

验证目录提取层中是否提供要在关系中使用的实体和特性

有关定义关系的更多信息，请参见部分 18.2.1, 目录提取层设置。

3

确定要显示此关系的位置

是希望新建一个页来起动组织结构图， 还是希望从细节入口小程序或从其它组织结构图起动该组织结构图？

有关创建页和向这些页中添加入口小程序的更多信息，请参见部分 7.0, 页管理。

4

设置入口小程序的自选设置

可使用自选设置定义：

  • 要显示的特性
  • 显示特性的方式（特性的 HTML 布局）

有关更多信息，请参见部分 18.2.2, 设置组织结构图自选设置。

5

测试

测试关系定义和布局

6

设置 eDirectory 权限并建立增强性能所需的所有索引

有效权限 - 要显示由入口小程序定义的特性，用户对这些特性必须拥有读权限。

性能增强 - 由于关系的子特性用于执行 LDAP 搜索，因此可以通过向该子特性添加 eDitectory 值索引来增强组织结构图的显示性能。

18.2.1 目录提取层设置

必须在目录提取层中定义显示在组织结构图内的实体和特性。 下表显示了必须为显示在组织结构图内的每个实体和特性设置的特性和属性。

定义类型

设置

值

实体

查看

选中 (True)

特性

读

选中 (True)

搜索

选中 (True)

《查找》链接要求 《查找》链接允许用户通过搜索与父实体关键字类型相同的其它对象来定位组织结构图。 它要求父实体关键字至少有一个特性的《要求》和《搜索》访问属性设置为 True（在目录提取层编辑器中选中）。 如未设置，则不能填充《查找》链接的《对象查找》对话框，因此将显示为空对话框。

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

18.2.2 设置组织结构图自选设置

可以定义两种类型的自选设置：

组织结构图关系自选设置

组织结构图关系自选设置包括在一个自选设置页中。

说明：说明： 图示

.

.

.

说明：说明： 图示

自选设置

操作

显示布局

单击《查看/编辑自定义自选设置》以访问布局自选设置。这些内容在组织结构图布局自选设置中有所介绍。

关联关键字

键入关联关键字。 此值必须对应于目录提取层中指定的某个关联关键字。

父实体关键字

键入实体（表示要显示的组织结构图的根节点）的 DN 或键入 ${User/id} 以显示当前用户的组织结构图。 （${User/id} 参数解析到当前用户的 DN。）

该值不得超出目录提取层中 search-root 属性所指定的节点，否则将导致 LDAP 搜索失败。

以下是有效 DN 的一些示例（使用样本数据）：

  • 要显示 user2users 关联关键字且以名为 Jack Miller 的员工为组织结构图的根节点，则必须指定：

cn=jmiller,ou=users,ou=sample,o=novell
  • 要显示 group2users 关联关键字且以会计组为根节点，则必须指定：

cn=Accounting,ou=groups,ou=sample,o=novell

默认深度

指定首次显示组织结构图的深度。

  • 0 - 仅显示根
  • 1 - 显示根及其子级
  • 2 - 显示根、子级和孙级

依此类推。 如果此值递增到大于《最大深度》（见下文），则《最大深度》值优先。

最大深度

定义用户在组织结构图中能向下钻取的最大深度。 这与浏览受有效权限限制的组织结构图的能力不同。

OrgChart 外观

名片

eGuide

Novell.com

连线

纯蓝

对项目进行连线

指定是否用连线连接组织结构图卡。 False 意味着不连接。

菜单超时

当前显示菜单（对于内置链接）消失前的毫秒数。

树显示

定义 OrgChart 的排列方向、分布状态以及每个深度级别的外观。

开头的 n 个值将定义排列方向、分布状态和从 0 到 n-1 级别的外观。 最后一个值将反复用于深度大于 n-1 的级别。 值必须在 0 到 5 之间。

值为：

0: 将名片置于项的垂直列表上方

1: 在项的垂直列表上方连线

2: 将名片置于项的水平列表上方

3: 在项的水平列表上方连线

4: 将名片置于项的垂直列表之前

5: 在项的垂直列表之前连线

树叶显示

定义 OrgChart 的排列方向、分布状态以及单个 OrgChart 分支最大深度的外观

最小项目宽度

此值应等于 round('item min height' * 1.618)

最小项目高度

此值应等于 round('item min width' / 1.618)

用于多值特性的分隔符

用作多值特性的分隔符的字符。

组织结构图布局自选设置

使用组织结构图布局自选设置可以定义组织结构图项的 HTML 显示布局。 可以使用所选的 HTML 编辑器来进行更准确地编辑。请参见使用外部编辑器。

说明：说明： 图示

名片的 HTML 布局 - 默认布局。

用于简单显示的 HTML 布局 - 树显示自选设置设置为 1 时所显示的布局。

HTML 编辑器 单击《编辑》按钮可访问 HTML 编辑器。 HTML 编辑器如下所示：

说明：说明： 图示
使用 HTML 编辑器

HTML 编辑器提供了用于定义组织结构图的叶布局的 WYSIWYG 界面。 它提供了 HTML 编辑器的常用功能，可定义文本格式和列表，以及指定定位点和图像等。 使用《关键字》下拉列表可在布局区域内放置特性、命令和导航 URL。 从下拉列表中选择关键字时，此关键字会以合适的语法插入，但是也可以在布局区域内添加 HTML。

关键字 设计布局时，可以使用《关键字》下拉列表来插入变量，在运行时会用特定特性值来代替这些变量。 或者使用以下语法来键入它们的参照：


$[[keyword]]

其中关键字是实体特性的值，如 LastName。

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


$[[keyword+keyword]]

例如： 


$[[FirstName+LastName]]

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


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

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

注：如果布局中关键字键入有误，则它将在组织结构图中按原样显示（包括 $[[]]）。

HTML 编辑器功能和关键字用法 要使用 HTML 编辑器功能和《关键字》下拉列表，请执行以下操作：

功能

提示

《插入链接》按钮

要插入链接，请执行以下操作：

在 Mozilla 中：

  1. 突出显示要超级链接的文本并单击《插入链接》。
  2. 键入 URL 并单击《创建链接》。
  3. 保存自选设置。

在 IE 中：

  1. 单击《插入链接》。
  2. 在弹出窗口中键入 URL。
  3. 突出显示要超级链接的文本并单击《创建链接》（在弹出窗口中）。
  4. 保存自选设置。

注：如果图像或 URL 位于 HTML 编辑器的左上方，则弹出窗口会与之重叠。 由于弹出窗口无法移动，因此必须在编辑器的其它地方创建所需文本，然后将其剪切并粘贴到正确位置。

《添加图像》按钮

在 Mozilla 中：

  1. 将鼠标焦点放置到要插入图像的位置，然后单击《添加图像》。
  2. 键入 URL 和文本，然后在弹出窗口中单击《创建图像》。
  3. 保存自选设置。

在 IE 中：

  1. 单击《添加图像》。
  2. 在弹出窗口中键入 URL 和文本，然后将鼠标焦点放置到要插入图像的位置，并在弹出窗口中单击《创建图像》。
  3. 保存自选设置。

注：如果图像或 URL 位于 HTML 编辑器的左上方，则弹出窗口会与之重叠。 由于弹出窗口无法移动，因此必须在编辑器的其它地方创建所需文本，然后将其剪切并粘贴到正确位置。

《关键字》下拉列表：特性

这些是可用于此实体的特性集。

《关键字》下拉列表：命令

这些命令允许组织结构图入口小程序起动其它身份入口小程序或内置功能，如 IM 或电子邮件工具。

  • IM 操作按钮 - 创建发送 IM 的按钮
  • 邮件操作按钮 - 创建发送电子邮件的按钮
  • 组织结构图操作按钮 - 创建按钮以切换到另一关系，且以所选实体实例为父实例
  • 信息操作按钮 - 起动细节入口小程序

有关生成的按钮的示例，请参见内置链接。

URL

OrgChart 导航 URL 链接 - 允许指定要显示为链接的 URL 或实体特性。 用户单击此链接时，组织结构图入口小程序会重新显示，且单击的实体会成为根节点。

限制：

此功能仅在关系中的父实体和子实体是相同对象类型时才有效。 例如，在经理 - 员工关系中，两者都是用户。

用法提示：

要使用此关键字，请执行以下操作：

  1. 单击《查看来源》。
  2. 使用以下语法键入 @NavUrl 关键字：

<a href="javascript:$[[@NavUrl]]">someText</a>

其中 someText 是运行时显示的链接或实体特性。 在下面的示例中，《单击此处》将成为可单击的链接。


<a href="javascript:$[[@NavUrl]]">Click here</a>

在下面的示例中，FirstName 特性将成为可单击的链接：


<a href="javascript:$[[@NavUrl]]">$[[FirstName]]</a>

用法限制：

在 Internet Explorer 中，不能使用以下语法。


<a href="$[[@NavUrl]]">someText</a>

保存操作时，Internet Explorer 会添加以下内容：


http://context before $[[@NavUrl]]

这就意味着 


<a href="$[[@NavUrl]]">someText</a>

会变成


<a href="http://localhost/.../$[[@NavUrl]]">someText</a>

并且在运行时这将不能正确显示。

 

组织结构图导航单击链接 - 对 onClick 事件使用此关键字。 （仅可刷新组织结构图入口小程序区域，而不是整个页。）

用法提示：

要使用此关键字，，请执行以下操作：

  1. 单击《查看来源》。
  2. 使用以下语法键入 @NavClick 关键字：

<A href="javascript:return false;" onClick="$[[@NavClick]]">$[[SomeAttribute]]</A>

其中 SomeAttribute 是将成为可单击链接的实体特性。

《javascript:return false;》是必需的。 省略它会导致错误。

要保存定义的布局，请单击《提交》。

使用外部编辑器 可以通过以下方法使用 HTML 外部编辑器：

  1. 使用自选设置中可用的 HTML 布局编辑器创建实体特性、命令和关键字的 HTML 源文件。

  2. 将 HTML 源文件复制到所选编辑器中。

  3. 根据需要进行更改。

  4. 编辑完成后，将 HTML 源文件复制回 HTML 布局编辑器自选设置。

18.2.3 动态装载图像

要显示储存在 Identity Vault 中的图像（如用户照片），可以将特性名称添加到名片中。 例如，将 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 + ...]]