窗口小部件目录选项和访问权

目录文档

每个窗口小部件在目录中都表示为一个包含以下元素的 Notes® 文档。

• 用于显示在目录文档中的窗口小部件图形

  注： 可以使用缺省图形，也可以指定其他用于显示在目录文档中的图形。然而，指定用于目录文档的图形不会影响“我的窗口小部件”侧边栏面板中使用的窗口小部件缩略图。窗口小部件缩略图使用 imageUrl 变量在 .XML 文件附件中指定。

• 标题、描述和详细信息

  使用缺省窗口小部件名称或指定其他目录文档标题使用描述和详细信息字段可描述窗口小部件。

• 类别

  根据窗口小部件类别分组（如工作组名称或作业）来控制窗口小部件的访问权。这是指定哪些用户有权访问哪些窗口小部件的方式。对于其“类别”策略或首选项允许访问特定类别名称的窗口小部件的用户，将为其自动供应这些窗口小部件。

• 平台

  （可选）指定平台类型，例如 Sametime®_version 或 Notes®_version。

• 类型

  （可选）指定窗口小部件类型，例如仅内容类型、仅识别器，或者组件、功能部件或插件，或各类型的任意组合。您可以将类型用作对目录视图中所显示的窗口小部件进行排序的方法。

• XML 扩展附件

  这包含窗口小部件本身，可用于在为用户供应窗口小部件时通知用户，例如从指定更新站点部署插件或安装小配件。

如果要将目录用作 XPages 应用程序，配置为执行此操作的用户可以对窗口小部件文档进行评级、标记或备注。

目录视图

目录可采用以下视图：

• 所有窗口小部件
• 按作者
• 按分类
• 按类型

还提供了其他若干管理目录视图选项。

如果要将目录用作 XPages 应用程序，那么此目录具有扩展的视图和搜索功能。您可以按作者、类别或类型查看窗口小部件目录中的条目，或者简单查看所有窗口小部件。您可以显示特定产品的窗口小部件，例如 HCL Notes® 或 HCL Sametime®。在浏览窗口小部件目录时，您可以向窗口小部件添加备注、标记并评级。

目录访问权

管理员可以使用 Notes® 应用程序 ACL 和策略或首选项设置的组合，根据用户类型来分配目录访问权。

• 使用目录应用程序 ACL

  对目录具有读写访问权并分配有 [WidgetAuthor] 角色的用户可以在目录中创建和编辑窗口小部件。与策略或首选项结合使用，用户可以更改或向目录文档添加窗口小部件类别，目录文档会强制部署到特定用户或组。另外，用户还能创建、编辑或除去窗口小部件，以及从“我的窗口小部件”侧边栏面板将新的窗口小部件发布到目录。

  注： 对目录具有“编辑者”或更高级别访问权以及分配有 [Admins] 和 [WidgetAuthor] 角色的用户可以在目录中创建、编辑和除去窗口小部件。
  注： 如果在目录 ACL 中为您分配了 [Admins] 角色，但在本地副本中没有为您提供管理员功能，那么可能需要在本地副本的 ACL 中启用强制各副本使用一致的访问权。
• 使用策略或 plugin_customization.ini 文件首选项

  管理员可以使用策略来控制各种窗口小部件和实时文本及目录访问设置。如果是在服务器管理的环境之外使用窗口小部件和实时文本，那么在 plugin_customization.ini 文件中有等效设置。例如，管理员可以根据类别控制窗口小部件的部署。类别在目录中创建，但通过用户策略或首选项设置进行管理。特定窗口小部件可根据给定窗口小部件的所属类别以及为给定用户指定的类别部署到特定用户。

目录操作按钮

目录经典视图包含以下操作按钮：

• 导入
  通过此操作，管理员可以从窗口小部件 xml 文件轻松创建窗口小部件文档。如果窗口小部件是 OpenSocial 窗口小部件类型，那么“导入”操作可以导入窗口小部件的代理数据和 OAuth 数据。将使用不同的文件来分别存储窗口小部件定义、代理规则和 OAuth 信息，如下所示：

  • 窗口小部件 xml 包含在名为 widget_name.extension.xml 的文件中。
  • 代理规则包含在名为 widget_name.proxy.xml 的文件中。
  • OAuth 信息包含在名为 widget_name.oauth.xml 的文件中。

  选择“导入”操作时，管理员需要浏览以查找要导入的窗口小部件 xml 文件。“导入”操作将自动找到位于同一目录中的代理和 OAuth 文件。

  下面是代理定义文件的样本。可以指定小配件代理规则以及内容代理规则。gadget 元素的 ContentProxy 属性用于标识它是小配件代理规则还是内容代理规则。

  <proxyrules>

  <gadget url="http://server.com/directory/GadgetFile.xml">

  <allow ip="9.6.1.0/255.255.255.0,9.6.1.1/255.255.255.0" /><!-- Multiple values are separated by comma -->

  <deny ip="9.6.0.0/255.255.0.0,9.6.1.4" /><!-- Multiple values are separated by comma -->

  <ProxyRule url="*" actions="GET,POST,PUT,HEAD,DELETE" headers="*" mime_types="" cookies=""></ProxyRule><!-- can be multiple-->

  </gadget>

  <gadget ContentProxy="true" url="http://server.com/directory/GadgetFile.xml">

  <allow ip="9.6.1.0/255.255.255.0,9.6.1.1/255.255.255.0" /><!-- Multiple values are separated by comma -->

  <deny ip="9.6.0.0/255.255.0.0,9.6.1.4" /><!-- Multiple values are separated by comma -->

  <ProxyRule url="*" actions="GET,POST,PUT,HEAD,DELETE" headers="*" mime_types="" cookies=""></ProxyRule><!-- can be multiple-->

  </gadget>

  </proxyrules>

  下面是 OAuth 定义文件的样本。所有 OAuth2 信息都在 OAuth2 元素下进行定义。所有 OAuth1.0a 信息都在 OAuth1a 元素下进行定义。可以在同一 OAuth 定义文件中定义多个 OAuth 服务。

  <App ID="http://server.com/directory/GadgetFile.xml">

  <OAuth2 ServiceName="OAuth2ServiceName"

  AllowModuleOverides="false"

  OAuth_Authorization_URI="http://server.com/oauth2/endpoint/provider/authorize"

  OAuth_Access_Token_URI="http://server.com/oauth2/endpoint/provider/token"

  Consumer_Key="key"

  Consumer_Secret="secret"

  Client_Type="CONFIDENTIAL"

  Grant_Type="AUTHORIZATION_CODE"

  Client_Auth_Type="STANDARD"

  Use_Authorization_Header="false"

  Use_Url_Parameter="true"

  Shared="true"

  />

  <OAuth1a ServiceName="OAuthServiceName"

  OAuth_Request_Token_URI="request token"

  OAuth_Authorization_URI="http://server.com/oauth/endpoint/authorize"

  OAuth_Access_Token_URI="http://server.com/oauth/endpoint/token"

  Consumer_Key="key"

  Signature_Method="RSA-SHA1"

  Consumer_Secret="secret"

  Include_Body_Hash="true"

  />

  </App>

• 打开

  此操作允许您打开和查看所选目录文档，以用于查看该文档和（可选）将其添加到“我的窗口小部件”侧边栏面板。如果对该文档具有编辑权限，还可以打开文档进行编辑。

• 将窗口小部件添加到目录

  使用此操作可向目录添加窗口小部件、内容类型或识别器。该操作将打开一个对话框，您可以在其中添加 .XML 文件并添加标题、类别名称（可选）、类型名称、简短描述和详细描述。

  注： 对于 Notes® 客户机，要在目录中为“我的窗口小部件”侧边栏面板中的特定窗口小部件自动创建新文档，如果策略或首选项允许，那么可以在“我的窗口小部件”侧边栏面板中右键单击该窗口小部件，然后选择发布到目录。

  如果要将目录作为 XPages 应用程序运行，那么视图会包含添加窗口小部件操作按钮。使用此操作可向目录添加窗口小部件、内容类型或识别器。