Service Registry 3 2005Q4 用户指南

第 1 章 使用 Service Registry Web 控制台

本章介绍 Service Registry ("Registry") 的 Web 控制台。本章包含以下各节:

Web 控制台入门

Web 控制台是一种基于 Web 的用户界面,它可用于搜索 Registry 以及将内容发布到 Registry 和系统信息库中。本节介绍了在执行上述操作之前必须先执行的步骤。

启动 Web 控制台

要启动 Web 控制台,请在 Web 浏览器中键入以下 URL:

http://hostname:port/soar/

例如:

http://localhost:6060/soar/

如果系统中安装了 Registry,则 hostnamelocalhost。如果系统中尚未安装 Registry,请使用安装了 Registry 的系统的名称。port 的值通常为 6060,除非发生端口冲突。

Web 控制台包括以下主要部分:

更改默认语言

您可以更改两类信息的默认显示语言:

更改标签和消息的默认语言

Web 控制台的标签和信息可以用表 1–1 中列出的语言显示。

表 1–1 Web 控制台支持的语言

语言 

代码 

简体中文(中国) 

zh_CN

繁体中文(台湾) 

zh_TW

英语(美国) 

en

德语 

de

日语 

ja

朝鲜语 

ko

西班牙语 

es

Procedure更改标签和消息的语言

步骤
  1. 按照 Web 浏览器的说明将语言添加为 Web 浏览器语言首选项。

    对于大多数浏览器,您可以在“Internet 选项”、“选项”或“首选项”对话框的“常规”区域中找到语言设置。

  2. 通过将语言置于语言列表的首位可以使该语言成为首选语言。

  3. 单击“重置语言环境”按钮。

    系统将用相应的语言显示标签。

更改注册表内容的默认语言

您可以用顶部标题区域的“内容语言”下拉式列表中显示的任意一种语言将内容发布到 Registry 中。默认设置为 Web 浏览器中的语言设置。

要更改默认语言,请从“内容语言”下拉式列表中选择语言。

启用注册表内容的版本化

默认情况下,注册表对象的版本化被关闭。所有对象的版本号均为 1.1。如果在修改对象时需要该对象获取一个新的版本号,请选中“启用版本化”复选框。

创建用户帐户

您可以在不登录 Registry 的情况下浏览 Registry 的公开内容。但是,要获得对专用对象的读取权限和对公共对象的写入权限,您必须具有 Registry 的用户帐户。创建用户帐户后,您可以执行诸如发布、修改和删除对象之类的安全操作。

创建用户帐户一般包括以下几个步骤:

  1. 填写新用户的详细信息表单。

  2. 将一套凭证与用户帐户关联起来。您可以通过以下两种方法之一获得这些凭证:

要创建用户帐户,请执行以下任务:

Procedure启动用户注册向导

步骤
  1. 单击左侧菜单区域中的“创建用户帐户”。

  2. 单击“启动注册向导”按钮。

  3. 阅读“步骤 1:要求”中的说明,然后单击“下一步”。

  4. 填写新用户的详细信息表单。

    您必须提供用户的名字和姓氏。所有其他字段均为可选字段。

    登录后,Web 控制台顶部标题区域中的“ 当前用户”标签后将显示名字和姓氏。

  5. 单击“下一步”。

    将显示“用户验证详细信息”页面。

  6. 在“用户验证详细信息”页面中,选择以下单选按钮之一:

    • 如果需要 Registry 为您创建证书,请选择“生成密钥对并下载 PKCS12 密钥库”(默认值)。有关此任务的详细信息,请参见获取注册表生成的证书

    • 如果需要使用现有的第三方证书,请选择“上载 X509 证书 (DER)”。有关此任务的详细信息,请参见使用第三方证书

Procedure获取注册表生成的证书

如果您在“用户验证详细信息”页面中选择了“生成密钥对并下载 PKCS12 密钥库”单选按钮,请执行以下步骤。

步骤
  1. 在“用户验证详细信息”页面的“别名”文本字段中输入用户名。

  2. 在“密码”文本字段中输入密码,然后在“密码(重复)”文本字段中再次输入该密码。

  3. 请在文本字段中输入值(如果尚未填写这些字段)。

    这些文本字段如下所示:

    • 组织单位

    • 组织

    • 省/自治区/直辖市

    • 国家/地区

    “名称”字段中包含的名称是您在“新用户详细信息”表单中指定的姓氏。如果您在“新用户详细信息”表单中指定了“市”、“省/自治区/直辖市”或“国家/地区”,则这些文本字段中将包含相应的值。

    所有字段均为必填项。

  4. 单击“下一步”。

    将显示标有“步骤 4:将密钥装入 Web 浏览器”的页面,并显示一条消息“已成功注册新用户”。

  5. 单击“下载”。

  6. 在对话框中,选择允许您将生成的证书保存到磁盘的选项。在文本选择器对话框中,选择文件的目录和名称。

    该文件必须具有后缀 .p12

    默认操作将把证书保存到主目录下名为 generated-key.p12 的文件中。

接下来的操作

然后,您必须将生成的证书导入到 Web 浏览器中。有关详细信息,请参见将证书装入 Mozilla 或 Firefox Web 浏览器将证书装入 Internet Explorer Web 浏览器

Procedure使用第三方证书

如果您在“用户验证详细信息”页面中选择了“上载 X509 证书 (DER)”单选按钮,请执行以下步骤。通过执行这些步骤,将证书置于 Registry 的服务器密钥库中,并将该证书装入 Web 浏览器中。

开始之前

第三方证书必须为 X.509 格式。通常,此证书位于后缀为 .cer 的文件中。

步骤
  1. 在“用户验证详细信息”页面中,单击“选择证书文件”按钮。

  2. 在“文件上载”对话框中,单击“浏览”按钮以找到要上载的文件,然后单击“上载文件”。

  3. 单击“确定”。

    文件的名称将显示在“用户验证详细信息”页面中的“选择证书文件”按钮旁边。

  4. 单击“下一步”。

  5. 在“步骤 4:将密钥装入 Web 浏览器”页面中,按照说明将该证书导入 Web 浏览器中(如果它不在 Web 浏览器中)。

    有关详细信息,请参见将证书装入 Mozilla 或 Firefox Web 浏览器将证书装入 Internet Explorer Web 浏览器

Procedure将证书装入 Mozilla 或 Firefox Web 浏览器

步骤
  1. 从“编辑”菜单中选择“首选项”。

  2. 单击边栏中的“保密性和安全性”类别以展开选项。

  3. 单击“证书”。

  4. 单击右侧主面板中的“管理证书”按钮。

    将显示“您的证书”选项卡。

  5. 单击“导入”按钮。

  6. 在“要恢复的文件名”文件选择器对话框中,选择 .p12 证书文件,然后单击“打开”。

  7. 在“提示”对话框中,键入软件安全设备主密码的帐户密码。

    此密码是特定于浏览器帐户的,并由浏览器配置文件拥有者指定。通常的作法是在客户机上使用同名的密码和登录帐户。

  8. 在“密码条目”对话框中,键入证书密码。

    此密码用于保护客户机证书。如果使用的是 Registry 生成的证书,请键入您在“用户验证详细信息”页面中指定的密码。

    系统将显示“警报”对话框,该对话框显示消息:“已成功恢复您的安全性证书和专用密钥”。

  9. 单击“确定”。

  10. 关闭“证书管理器”和“首选项”对话框。

接下来的操作

导入证书后,您即可登录到注册表。有关详细信息,请参见登录到注册表

Procedure将证书装入 Internet Explorer Web 浏览器

步骤
  1. 从“工具”菜单中选择“Internet 选项”。

  2. 单击“内容”选项卡。

  3. 单击“证书”。

  4. 单击“导入”以打开“证书导入向导”。

  5. 在“证书导入向导”中,单击“下一步”。

  6. 在“要导入的文件”页面中,单击“浏览”并找到 .p12 文件,然后单击“下一步”。

  7. 在“密码”页面中,执行以下操作:

    1. 键入为该证书指定的密码。

    2. 选中“将密钥标记为可导出”复选框。

    3. 请不要选中“启用强大的专用密钥保护功能”复选框。

    4. 单击“下一步”。

  8. 在“证书库”页面中,选择默认值“将所有证书置于以下库(个人)中”,然后单击“下一步”。

  9. 单击“完成”。

  10. 在显示的信息对话框中单击“确定”。

    新证书连同您指定的名字和姓氏将显示在“证书”窗口中。

  11. 在“证书”窗口中单击“关闭”。

  12. 在“Internet 选项”窗口中单击“确定”。

接下来的操作

导入证书后,您即可登录到注册表。有关详细信息,请参见登录到注册表

Procedure登录到注册表

将证书导入 Web 浏览器后,您即可登录。

步骤
  1. 在“步骤 4:将密钥装入 Web 浏览器”页面中,单击“完成”按钮。

  2. 在 Web 控制台的顶部标题区域中,单击“登录”按钮。

  3. 在对话框中单击“确定”以验证证书。

    登录后,将在顶部标题区域中显示一条消息“验证成功”。

验证注册表

当您登录到 Registry 之后,只要您尝试添加、删除或修改 Registry 对象,就会自动触发验证,因为任何写入请求都会触发基于装入 Web 浏览器的客户机证书的验证。

验证完成后,对注册表的访问就基于 https

如果会话过期,注册表对您的验证不再有效。后续的写入请求将提示 Web 控制台对您进行重新验证。


注 –

如果验证失败,请停止并重新启动 Web 浏览器,然后重试。


搜索注册表

使用菜单区域中的“搜索”和“浏览”链接可以搜索注册表。

使用“搜索”菜单

单击菜单区域中的“搜索”。将打开“搜索”表单。该表单中包含以下组件:

单击“隐藏搜索表单”以关闭“搜索”表单并清除结果区域。

以下几节介绍如何使用这些组件。

选择查询

“选择预定义的查询”下拉式列表中包含表 1–2 中列出的项。

表 1–2 预定义的查询

查询名称 

搜索目标 

基本查询 

默认的通用查询,可用于按对象类型、按名称、按说明和按分类进行搜索 

基本查询 — 区分大小写 

区分大小写的基本查询版本 

FindAllMyObjects 

查找请求查询的用户所拥有(发布)的所有对象。如果该用户拥有许多对象,则可能需要花费较长时间 

GetCallersUser 

为请求查询的用户查找 User 对象

默认选项为“基本查询”。以下各节介绍如何执行基本查询:

使用 FindAllMyObjects 查询可以搜索已发布的所有对象。使用 GetCallersUser 查询可以查看或修改注册时创建的用户数据。

按对象类型搜索

仅按对象类型搜索是最简单的搜索方式。

“对象类型”下拉式列表中的默认选项为 "RegistryObject",该选项用于搜索 Registry 中的所有对象。要缩小搜索范围,请更改对象类型。

"ClassificationNode" 菜单项中列出了 ClassificationScheme 中的概念。ClassificationNode 与 Concept 同义。

Procedure按对象类型搜索

步骤
  1. 从“对象类型”下拉式列表中选择一种对象类型。

  2. 单击“搜索”按钮。

    搜索将返回指定类型的所有对象。您可以通过指定名称、说明或分类缩小搜索范围。

按名称和说明搜索

Procedure按名称或说明搜索

步骤
  1. 从“选择预定义的查询”下拉式列表中选择“基本查询”或“基本查询 -- 区分大小写”。

  2. 在“名称”或“说明”字段中键入一个字符串。

  3. 单击“搜索”。

    默认情况下,该搜索将查找与您键入的整个字符串相匹配的名称或说明。您可以使用通配符来查找一系列对象。

    通配符包括百分号 (%) 和下划线 (_)。

    % 通配符可以代表多个字符:

    • 键入 %off% 将返回包含字符串 off 的名称或说明,例如 Coffee

    • 键入 nor% 将返回以字符串 Nornor 为开头的名称或说明,例如 North northern

    • 键入 %ica 将返回以字符串 ica 为结尾的名称或说明,例如 America

    下划线通配符代表单个字符。例如,搜索字符串 _us_ 将匹配名为 Aus1Bus3 的对象。

按分类搜索

分类对象使用分类方案内定义有效值的唯一概念 (ClassificationNode) 对 Registry 中的对象进行分类。分类方案是包含多代子概念的树结构中的父概念。表 1–3 介绍了 Registry 规范所提供的分类方案。该表中的许多术语在注册表规范中都有定义。

表 1–3 分类方案用法

分类方案名称 

使用 

说明或目的 

AssociationType

经常 

定义 RegistryObject 之间的关联类型。用作 Association 实例的 associationType 属性值以说明关联的本质。

ContentManagementService

很少 

定义内容管理服务的类型。在配置诸如验证或编目服务之类的内容管理服务时使用。 

DataType

经常 

定义本文档所定义的类中属性的数据类型。用作 Slot 实例的 slotType 属性值以说明 Slot 值的数据类型。

DeletionScopeType

有时 

定义 RemoveObjectsRequest 协议信息的 deletionScope 属性值。

EmailType

很少 

定义电子邮件地址的类型。 

ErrorHandlingModel

很少 

定义内容管理服务的错误处理模式的类型。 

ErrorSeverityType

很少 

定义在处理协议信息时 Registry 遇到的各种错误严重性类型。 

EventType

有时 

定义注册表中可能发生的事件类型。 

InvocationModel

很少 

定义 Registry 调用内容管理服务可以采用的各种方法。 

NodeType

有时 

定义 ClassificationScheme 为其 ClassificationNode(概念)对象指定 code 属性值可以采用的各种方法。

NotificationOptionType

很少 

定义 Registry 就 Subscription 内的事件向客户机发送通知时可以采用的各种方法。

ObjectType

有时 

定义注册表可以支持的各种 RegistryObject 类型。 

PhoneType

很少 

定义电话号码的类型。 

QueryLanguage

很少 

定义注册表所支持的查询语言。 

ResponseStatusType

很少 

定义 RegistryResponse 的各种状态类型。

StatusType

有时 

定义 RegistryResponse 的各种状态类型。

SubjectGroup

很少 

定义要进行访问控制的用户可归属的组。 

SubjectRole

很少 

定义可以为要进行访问控制的用户指定的角色。 

在菜单区域中,ClassificationScheme 树的根节点位于“说明”字段的下方。

Procedure按分类搜索

步骤
  1. 展开根节点以查看分类方案的完整列表。

    每个条目后面括号中的数字表示父概念中包含的概念(ClassificationNode 对象)数。

  2. 展开要使用的分类方案节点。

  3. 展开分类方案下面的概念节点,直至您找到要按其进行搜索的叶节点。叶节点是下面没有任何概念的节点。

  4. 选择该叶节点。

  5. (可选的)通过选择对象类型或指定名称或说明字符串限制搜索范围。

  6. 单击“搜索”按钮。

查看搜索结果

“注册表对象”区域中将显示通过搜索找到的对象。

“注册表对象”区域包含以下部分:

对于 ExtrinsicObject 对象,还会有另外两列:“内容版本”和“内容版本注释”。这两列适用于 ExtrinsicObject 的系统信息库项目。

对于以下两类对象,“版本”和“版本注释”列将被替换为其他内容:

Procedure使用固定功能

使用用户界面的固定功能可以在搜索其他对象时在“Registry 对象”区域中保留一个或多个对象。然后您可以在两个对象之间创建关系。有关如何执行上述操作的详细信息,请参见创建对象之间的关系

步骤
  1. 单击“搜索”并执行查询。

  2. 在“Registry 对象”区域中,选择需要保留的对象的“固定”复选框。

  3. 再执行一次查询。

    固定的对象和第二次查询的搜索结果都显示在“Registry 对象”区域中。

接下来的操作

如果您不再使用固定的对象,请取消选中该对象的“固定”复选框。当您再执行查询时,该对象将不会显示在“Registry 对象”区域中。

查看对象详细信息

在搜索结果表中,单击对象的“详细信息”链接可以立即打开“Registry 对象”区域下方的“详细信息”区域。

该区域包含一系列按钮和选项卡:

表 1–4 “详细信息”区域中的属性选项卡

选项卡名称 

适用于 

Object_Type 详细信息

所有对象(Object_Type 是对象类型名称)

插槽 

所有对象 

分类 

所有对象 

外部标识符 

所有对象 

关联 

所有对象 

外部链接 

所有对象 

审计跟踪 

所有对象 

邮政地址 

工作单位,用户 

电话号码 

工作单位,用户 

电子邮箱地址 

工作单位,用户 

用户 

组织 

组织 

组织 

服务绑定 

服务 

规范链接 

ServiceBinding 

概念 

ClassificationScheme、ClassificationNode 

注册表对象 

RegistryPackage 

受影响的对象 

AuditableEvent 

单击选项卡可以查看该对象是否具有任何属性值。如果有,则单击属性值的“详细信息”链接可以打开 Web 浏览器窗口,该窗口中显示此属性值的详细信息。

“审计跟踪”选项卡生成的表中没有“详细信息”链接,而是生成包含以下信息的表单:

对于大多数对象,“详细信息”区域包含以下字段:

对于许多对象,这些字段大都无需加以说明(例如,工作单位的邮政地址)。对于某些对象,这些字段需要一些说明。以下各节中将介绍这些字段。

查看关联详细信息

关联对象的“详细信息”区域包含以下附加字段:

查看分类方案详细信息

ClassificationScheme 对象的“详细信息”区域包含以下附加字段:

查看外部对象详细信息

ExtrinsicObject 对象的“详细信息”区域包含以下附加字段:

查看外部链接详细信息

在 ExternalLink 对象的“详细信息”区域的“外部 URI”字段下方包含“显示内容”链接。单击该链接可以在浏览器窗口中查看 URI 的内容。

使用“资源管理器”菜单

“资源管理器”菜单就像文件夹的分层结构,可用于浏览 Registry 和系统信息库内容。名为 root 的根文件夹包含所有 Registry 内容。

Procedure使用“资源管理器”菜单

步骤
  1. 单击“资源管理器”链接。

  2. 展开 root 文件夹。该文件夹包含两个子文件夹:userData(其中保存了所有用户内容)和 ClassificationScheme

  3. 单击一个文件夹以查看相应类型的注册表对象。展开一个节点以查看下一级的对象类型。

接下来的操作

完成后,单击“隐藏资源管理器”以关闭“资源管理器”菜单并清除结果区域。

Procedure浏览分类方案

步骤
  1. 单击 ClassificationScheme 文件夹(不是节点符号)。

    所有 ClassificationScheme 对象都显示在“Registry 对象”区域中。要查看对象,请按照查看搜索结果中的说明进行操作。

  2. 展开 "ClassificationScheme" 节点以在菜单区域中打开 ClassificationScheme 树分层结构。

  3. 单击任一文件图标以在“Registry 对象”区域中查看该分类方案。

  4. 展开一个分类方案节点以查看该节点下面的概念文件夹。

    并非所有分类方案在“资源浏览器”菜单中都有可查看的概念。

  5. 单击一个概念文件夹以在“Registry 对象”区域中查看该概念。

Procedure浏览 UserData 文件夹

步骤
  1. 展开 userData 节点。

  2. 展开 "RegistryObject" 节点。请勿单击文件夹,除非您要查看所有 Registry 对象。

    folder1 节点中没有内容。

  3. 单击一个文件夹以查看相应类型的注册表对象。展开一个节点以查看下一级的对象类型。

发布和管理注册表对象

使用“创建新 Registry 对象”菜单项可以创建对象并将其发布到 Registry 中。

发布对象

将对象发布到 Registry 的过程包括三个步骤:

  1. 创建对象。

  2. 添加详细信息和其他对象,把对象保存到内存中但并不发布到 Registry 中。

  3. 将对象发布到注册表中。

如果您已创建用户帐户并已登录,则可以将对象发布到 Registry 中。要创建用户帐户,请按照创建用户帐户中的说明进行操作。

Procedure创建和发布新 Registry 对象

步骤
  1. 在菜单区域中,单击“创建新的注册表对象”。

  2. 在“Registry 对象”区域的下拉式列表中选择一个对象类型,然后单击“添加”。

    该对象的详细信息表单将显示在“详细信息”区域中。

  3. 在“详细信息”表单的字段中键入名称和(可选)说明。为“详细信息”表单中显示的其他字段键入值。


    注 –

    创建 AdhocQuery 对象并键入查询字符串时,将通常用单引号括起来的项目仍用一对单引号括起来。这些项目出现在子查询中时,它们通常为参数占位符和字面值。例如,在子查询中指定参数占位符如下所示:

    (SELECT id FROM ClassificationNode WHERE path LIKE ''$objectTypePath'')

    同时指定字面值和参数占位符如下所示:

    ... AND (ro.id = s.parent AND s.name_ = 
    ''urn:oasis:names:tc:ebxml-regrep:profile:ws:wsdl:nameSpacesUsed''
      AND s.value LIKE ''$nameSpacePattern'')

  4. (可选的)用您自己选择的标识符替换指定的唯一标识符和逻辑唯一标识符。

    每个标识符必须为有效的 URN,并且在安装的 Registry 内必须唯一。

  5. (可选的)单击“保存”将该对象保存到内存中。

  6. (可选的)使用“详细信息”表单中的选项卡添加和保存编辑后的对象。

  7. 单击“应用”将该对象发布到注册表中。

    将显示一条表示应用是否成功的状态消息。

接下来的操作

不管是在发布对象之前还是之后,您都可以通过向该对象添加编辑后的对象来对其进行编辑。表 1–4 列出了可以添加的对象。以下各节介绍了如何添加这些对象。

向对象中添加分类

要创建分类,请使用内部分类方案。内部分类方案包含一组概念,Registry 已经知道这些概念的值。

Procedure添加分类

要向对象中添加分类,请搜索适当的分类方案,然后在该分类方案中选择一个概念。

步骤
  1. 在对象的“详细信息”区域中,单击“分类”按钮。

    将显示“分类”表(可能为空白)。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 键入分类的名称和(可选)说明。

  4. 单击“选择 ClassificationScheme 或 Concept”按钮。

    将打开“ClassificationScheme/Concept 选择器”窗口。

  5. 展开 "ClassificationScheme" 节点。再展开概念节点,直至您选定需要使用的叶节点。

  6. 单击“确定”以关闭“ClassificationScheme/Concept 选择器”窗口。

    分类方案和概念将显示在“详细信息面板”窗口中。

  7. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  8. 在对象的“详细信息”区域中,单击“应用”。

向对象中添加外部标识符

要创建外部标识符,请使用外部分类方案。外部分类方案中有 Registry 未知的值,因为此分类方案没有概念。

Procedure添加外部标识符

要向对象中添加外部标识符,请搜索适当的分类方案,然后指定一个值。

步骤
  1. 在对象的“详细信息”区域中,单击“外部标识符”选项卡。

    将显示 "External Identifier" 表(可能为空白)。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 键入外部标识符的名称和(可选)说明。

  4. 单击“选择 ClassificationScheme”按钮。

    将打开“ClassificationScheme/Concept 选择器”窗口。

  5. 展开 "ClassificationScheme" 节点,然后选择没有概念的分类方案。

  6. 单击“确定”以关闭“ClassificationScheme/Concept 选择器”窗口。

    分类方案将显示在“详细信息面板”窗口中。

  7. 在“值”字段中键入值。

  8. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  9. 在对象的“详细信息”区域中,单击“应用”。

向对象中添加外部链接

使用外部链接可以将 URI 与注册表对象关联起来。

Procedure添加外部链接

步骤
  1. 在对象的“详细信息”区域中,单击“外部链接”选项卡。

    将显示 "External Link" 表(可能为空白)。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 键入外部链接的名称。

  4. 在“外部 URI”字段中键入外部链接的 URL。

  5. (可选的)如果需要指定该 URL 指向的内容的类型,请单击“选择对象类型的概念”按钮。

    展开 "ClassificationScheme" 节点。通过展开 "ObjectType" 节点、"RegistryObject" 节点和 "ExtrinsicObject" 节点以找到内容类型。选择所需的概念,然后单击“确定”。如果未找到合适的类型,请单击“取消”。您可以根据需要为 ExtrinsicObject 创建新概念。

  6. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  7. 在对象的“详细信息”区域中,单击“应用”。

使用插槽向对象中添加自定义信息

插槽包含不能存储到 Registry 中的附加信息。使用插槽可以向对象中添加任意属性。

Procedure添加插槽

步骤
  1. 在对象的“详细信息”区域中,单击“插槽”选项卡。

    将显示“插槽”表(可能为空白)。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 键入插槽的名称。

  4. (可选的)在“插槽类型”字段中键入一个值。您可以使用该字段为插槽指定数据类型或提供将插槽汇集在一起的方法。

  5. 在“值”字段中键入值。

  6. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  7. 在对象的“详细信息”区域中,单击“应用”。

向组织或用户中添加邮政地址

一个组织或用户可以有一个或多个邮政地址。

Procedure添加邮政地址

步骤
  1. 在组织或用户的“详细信息”区域中,单击“邮政地址”选项卡。

    将显示“邮政地址”表(可能为空白)。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 在字段中键入所需的值。所有字段均为可选字段。

    • 门牌号码

    • 街道

    • 省/自治区/直辖市

    • 国家/地区

    • 邮政编码

  4. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  5. 在对象的“详细信息”区域中,单击“应用”。

向组织或用户中添加电话号码

一个组织或用户可以有一个或多个电话号码。

Procedure添加电话号码

步骤
  1. 在组织或用户的“详细信息”区域中,单击“电话号码”选项卡。

    将显示“电话号码”表(可能为空白)。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 从“类型”组合框中选择一个值。

    可使用以下值:

    • 寻呼机

    • 传真

    • 家庭电话

    • 移动电话

    • 办公电话

  4. 在字段中键入所需的值。所有字段均为可选字段。

    • 国家/地区代码

    • 区域代码

    • 电话号码

    • 分机

  5. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  6. 在对象的“详细信息”区域中,单击“应用”。

向组织或用户中添加电子邮件地址

一个组织或用户可以有一个或多个电子邮件地址。

Procedure添加电子邮件地址

步骤
  1. 在组织或用户的“详细信息”区域中,单击“电子邮件地址”选项卡。

    将显示“电子邮件地址”表(可能为空白)。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 从“类型”组合框中选择一个值:家庭电子邮件或办公电子邮件。

  4. 在“电子邮件地址”字段中键入所需的值。

  5. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  6. 在对象的“详细信息”区域中,单击“应用”。

向组织中添加用户

一个组织可以有一个或多个用户。通常,创建组织的那一个用户是主要联系人。您还可以创建和添加其他用户。

Procedure添加用户

步骤
  1. 在组织的“详细信息”区域中,单击“用户”选项卡。

    将显示“用户”表。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 在“名称”字段中,在逗号的左侧键入用户的姓氏。(可选)在逗号的右侧键入用户的名字和中间名。

  4. (可选的)在“说明”字段中键入用户的说明。

  5. 在“名字”、“中间名”和“姓氏”字段中键入用户的名字、中间名和姓氏。所有字段均为可选字段。

  6. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  7. 在对象的“详细信息”区域中,单击“应用”。

向组织中添加下一级组织

一个组织可以有一个或多个下一级组织。要向组织中添加下一级组织,请执行以下步骤:

Procedure添加下一级组织

步骤
  1. 在组织的“详细信息”区域中,单击“下一级组织”选项卡。

    将显示 "ChildOrganizations" 表。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 在“名称”字段中,键入新组织的名称。

  4. (可选的)在“说明”字段中键入说明。

  5. (可选的)在地址字段中键入所需的值。

  6. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  7. 在对象的“详细信息”区域中,单击“应用”。

向服务中添加服务绑定

一个服务通常有一个或多个服务绑定。

Procedure添加服务绑定

步骤
  1. 在服务的“详细信息”区域中,单击“服务绑定”选项卡。

    将显示“服务绑定”表。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 在“名称”字段中,键入服务绑定的名称。

  4. (可选的)在“说明”字段中,键入服务绑定的说明。

  5. 在“访问 URL”字段中,键入服务绑定的 URL。

  6. (可选的)在“目标绑定”字段中,键入此 ServiceBinding 引用的另一个 ServiceBinding 的唯一标识符。

  7. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  8. 在对象的“详细信息”区域中,单击“应用”。

向服务绑定中添加规范链接

ServiceBinding 可以具有一个 SpecificationLink 对象。

Procedure添加规范链接

步骤
  1. 在 ServiceBinding 的“详细信息”区域中,单击“规范链接”选项卡。

    将显示“规范链接”表。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 在“名称”字段中,键入 SpecificationLink 的名称。

  4. (可选的)在“说明”字段中,键入 SpecificationLink 的说明。

  5. 在“用法说明”字段中,键入用法参数的使用说明(如果 SpecificationLink 有用法参数)。

  6. 在“用法参数”字段中,键入用法参数(如果 SpecificationLink 有用法参数)。

  7. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  8. 在对象的“详细信息”区域中,单击“应用”。

向分类方案或概念中添加子概念

ClassificationScheme 通常有许多子概念(这些子概念也可以有自己的子概念)。

Procedure添加子概念

步骤
  1. 在 ClassificationScheme 的“详细信息”区域中,单击“子概念”选项卡。

    将显示 "ChildConcept" 表。

  2. 单击“添加”。

    将打开“详细信息面板”窗口。

  3. 在“名称”字段中,键入概念的名称。

  4. (可选的)在“说明”字段中键入用户的说明。

  5. 在“值”字段中,键入概念的值。

  6. 单击“添加”以保存新对象并关闭“详细信息面板”窗口。

  7. 在对象的“详细信息”区域中,单击“应用”。

向注册表软件包中添加对象

RegistryPackage 是包含其他注册表对象的对象。通常,使用 RegistryPackage 可以对相关对象进行逻辑分组。这些对象可以是不同的类型,并且可以属于不同的拥有者。

通过指定对象的唯一标识符,可以将其添加到注册表信息包中。如果您尝试键入唯一的标识符,则很可能会出错。因此,以下步骤将介绍如何通过复制并粘贴标识符来添加对象。

Procedure向注册表软件包中添加对象

步骤
  1. 按照创建和发布新 Registry 对象中的说明创建 RegistryPackage 对象。指定名称和(可选)说明,但此时不向其添加任何 RegistryObject。

  2. 单击“应用”保存 RegistryPackage 后,请按照使用固定功能中的说明固定该 RegistryPackage。

  3. 使用 Web 控制台搜索需要添加到 RegistryPackage 中的对象。找到每个对象时就将其固定。

  4. 单击需要添加到 RegistryPackage 的对象的“详细信息”链接。

  5. 在该对象的“详细信息”面板中,使用键盘(Ctrl-C 或“复制”键)复制唯一标识符。

  6. 在“搜索结果”区域中,单击 RegistryPackage 的“详细信息”链接。

  7. 在该对象的“详细信息”区域中,单击“注册表对象”选项卡。

  8. 单击“添加到软件包”。

  9. 在“唯一标识符”字段中,使用键盘(Ctrl-V 或“粘贴”键)粘贴已复制的标识符。

  10. 单击“添加”。

    该对象将显示在“注册表对象”区域中。

  11. 单击“详细信息”区域中的“应用”以保存此 RegistryPackage。

  12. 重复执行步骤 4 至步骤 11 将每个附加对象添加到此 RegistryPackage 中。

更改对象的状态

如果您是拥有者或被另外授权,您不但可以发布、编辑和删除对象,而且还可以对对象执行以下操作:

如果需要建立 Registry 对象的版本控制策略,这些功能在生产环境中会很有用。例如,您可以批准某个版本的对象供一般使用,并可以在删除对象之前使已过时的版本过时。如果要在使对象过时后恢复使用此对象,您可以取消该对象的过时。

以下所有操作都在“搜索结果”区域执行。

删除对象

要从 Registry 中删除您拥有的对象,请在“搜索结果”区域中选择此对象,然后单击“删除”按钮。


注 –

请勿从您拥有的对象中删除 AuditableEvent 对象。即,不要删除使用 FindAllMyObjects 搜索后显示在“搜索结果”区域中的任何 AuditableEvent 对象。如果删除 AuditableEvent 对象,将会破坏属于此对象的审计跟踪。


如果此对象是外部对象,则可以采取两种方法:

“删除选项”菜单仅对外部对象有意义。

创建对象之间的关系

对象之间存在两种关系:引用和关联。这两种关系都是单向关系。即,每种关系都有一个源对象和一个目标对象。

Registry 支持某些类型的对象之间的引用,此类引用称为 ObjectRef。例如,如果您创建了一个服务和一个 ServiceBinding,则可以创建一个从该服务到该 ServiceBinding 的 ServiceBinding 引用。但是,您不能创建从 ServiceBinding 到该服务的引用。引用不是 Registry 对象。

关联是 Registry 对象。您可以创建从任一 Registry 对象到任一其他 Registry 对象的关联。Registry 支持 AssociationType 分类方案,其中包括大量预定义关联类型:OffersService、RelatedTo 和 HasMember 等。还可以创建新的关联类型。如果您同时拥有关联的两个对象,则此关联为内部关联。如果您不同时拥有关联的两个对象,则此关联为外部关联。如果您创建了一个组织并向其中添加了服务,则从该组织到该服务的 OffersService 类型的关联将自动创建。

如果源对象与目标对象之间不存在有效引用,则无法创建引用。

使用“注册表对象”区域中的“关联”按钮可以将两个对象关联起来。当您在搜索结果表中选定两个对象后,此按钮即被激活。

如果在搜索结果表中不能同时看到两个对象,请选择“固定”复选框将一个对象保留在搜索结果表中,再去查找要与其关联的对象。有关详细信息,请参见使用固定功能

Procedure创建引用

步骤
  1. 在“注册表对象”区域中,选择两个对象,然后单击“关联”。

  2. 在“创建关系”区域中,选择源对象(如果尚未选定)。

    另一个对象将成为目标对象。

    如果源对象和目标对象之间存在有效的引用,则“引用”选项在默认情况下处于选中状态,并将显示有效的引用属性。如果源对象和目标对象之间不存在有效的引用,则“引用”单选按钮将灰显。

  3. 单击“保存”以保存引用。

Procedure创建关联

步骤
  1. 在“注册表对象”区域中,选择两个对象,然后单击“关联”。

  2. 在“创建关系”区域中,选择源对象(如果尚未选定)。

    另一个对象将成为目标对象。

  3. 选择“关联”单选按钮(如果尚未选中)。

  4. 在“详细信息”区域中,键入关联的名称和(可选)说明。

    源对象 ID 值和目标对象 ID 值均已填写。

  5. 从“关联类型”菜单中选择一个类型值。

  6. 单击“应用”以保存关联。

错误诊断

本节介绍了在使用 Web 控制台时可能遇到的一些问题的解决方案。

无法访问 Service Registry

如果在尝试使用 Web 控制台时收到错误 404 或“连接被拒绝”的信息,则可能是 Registry 没有运行或您指定的 URL 不正确。

请确保指定的 URL 为http://hostname:6060/soar/。除了指定主机名以外,您可能还需要指定域:hostname.domain

要确保 Registry 运行,请对 Registry 的 Application Server 域使用命令行或 Web 接口。有关详细信息,请参见《Service Registry 3 2005Q4 管理指南》中的“管理用于 Service Registry 的 Application Server 域”

未使用首选语言环境

如果 Web 控制台没有使用您的首选语言环境,请检查 Web 浏览器的首选项设置。请确保首选语言环境位于语言环境列表的顶部。有关详细信息,请参见更改默认语言

搜索面板标签不以当前语言环境显示

如果在更改语言环境并单击“复位语言环境”后,搜索面板标签不以当前语言环境显示,请单击“结束会话”,然后单击“返回 Registry”。有关更改语言环境的信息,请参见更改默认语言

无法创建 ExternalLink 或 ServiceBinding

在以下几种情形中,可能会出现错误:

错误消息类似如下:


The URL: uri is not resolvable. 
Use Absolute Path Format [scheme:][//authority][path][?query][#fragment]

此错误表示尚未执行《Service Registry 3 2005Q4 管理指南》中的“允许访问外部 Web 站点”中所述的管理任务。站点的 Service Registry 管理员必须先执行此任务并重新启动 Registry,然后您才能创建这些对象。

Web 控制台错误消息不明确

要获得可能引发 Web 控制台错误消息的问题说明,请查看用于 Registry 的 Application Server 域的服务器日志。有关详细信息,请参见《Service Registry 3 2005Q4 管理指南》中的“管理用于 Service Registry 的 Application Server 域”

无法保存新的注册表对象

在尝试将新对象保存到注册表时收到错误消息的情况下:

Web 控制台没有响应

如果注册表控制台没有响应,请执行以下步骤:

  1. 记下显示的错误消息。

  2. 清除 Web 浏览器中的会话 Cookie。要清除 Cookie,请在正在运行 Registry 的站点上找到名为 JSESSIONID 的 Cookie 并将其删除。如果无法确定,请删除所有 Cookie。

  3. 请按照启动 Web 控制台中的说明重新启动 Web 控制台。

  4. 与 Registry 支持部门联系,并告知错误消息的内容以及导致出现错误的操作步骤。