本章介绍 Service Registry ("Registry") 的 Web 控制台。本章包含以下各节:
Web 控制台是一种基于 Web 的用户界面,它可用于搜索 Registry 以及将内容发布到 Registry 和系统信息库中。本节介绍了在执行上述操作之前必须先执行的步骤。
要启动 Web 控制台,请在 Web 浏览器中键入以下 URL:
http://hostname:port/soar/
例如:
http://localhost:6060/soar/
如果系统中安装了 Registry,则 hostname 为 localhost。如果系统中尚未安装 Registry,请使用安装了 Registry 的系统的名称。port 的值通常为 6060,除非发生端口冲突。
Web 控制台包括以下主要部分:
顶部标题,您可以在此登录、注销、重置语言环境、结束当前会话、设置 Registry 内容的版本化及设置内容语言
位于屏幕左侧的菜单区域
位于菜单区域右侧的 Registry 对象区域,该区域显示找到的对象
位于“Registry 对象”区域下方的“详细信息”区域,该区域显示所有找到的对象的详细信息
您可以更改两类信息的默认显示语言:
Web 控制台标签和消息
注册表内容
Web 控制台的标签和信息可以用表 1–1 中列出的语言显示。
表 1–1 Web 控制台支持的语言
语言 |
代码 |
---|---|
简体中文(中国) |
zh_CN |
繁体中文(台湾) |
zh_TW |
英语(美国) |
en |
德语 |
de |
日语 |
ja |
朝鲜语 |
ko |
西班牙语 |
es |
按照 Web 浏览器的说明将语言添加为 Web 浏览器语言首选项。
对于大多数浏览器,您可以在“Internet 选项”、“选项”或“首选项”对话框的“常规”区域中找到语言设置。
通过将语言置于语言列表的首位可以使该语言成为首选语言。
单击“重置语言环境”按钮。
系统将用相应的语言显示标签。
您可以用顶部标题区域的“内容语言”下拉式列表中显示的任意一种语言将内容发布到 Registry 中。默认设置为 Web 浏览器中的语言设置。
要更改默认语言,请从“内容语言”下拉式列表中选择语言。
默认情况下,注册表对象的版本化被关闭。所有对象的版本号均为 1.1。如果在修改对象时需要该对象获取一个新的版本号,请选中“启用版本化”复选框。
您可以在不登录 Registry 的情况下浏览 Registry 的公开内容。但是,要获得对专用对象的读取权限和对公共对象的写入权限,您必须具有 Registry 的用户帐户。创建用户帐户后,您可以执行诸如发布、修改和删除对象之类的安全操作。
创建用户帐户一般包括以下几个步骤:
填写新用户的详细信息表单。
将一套凭证与用户帐户关联起来。您可以通过以下两种方法之一获得这些凭证:
注册表可以为您生成凭证。这是比较简单的获得凭证的方法。
如果您具有第三方证书授权机构颁发的证书,则可以使用该证书获取这些凭证。在使用该证书前,管理员必须将第三方根证书安装到 Registry 的 Application Server 域中。有关详细信息,请参见《Service Registry 3 2005Q4 管理指南》中的“将根证书添加到 Registry 域的信任证书中”。
要创建用户帐户,请执行以下任务:
单击左侧菜单区域中的“创建用户帐户”。
单击“启动注册向导”按钮。
阅读“步骤 1:要求”中的说明,然后单击“下一步”。
填写新用户的详细信息表单。
您必须提供用户的名字和姓氏。所有其他字段均为可选字段。
登录后,Web 控制台顶部标题区域中的“ 当前用户”标签后将显示名字和姓氏。
单击“下一步”。
将显示“用户验证详细信息”页面。
在“用户验证详细信息”页面中,选择以下单选按钮之一:
如果需要 Registry 为您创建证书,请选择“生成密钥对并下载 PKCS12 密钥库”(默认值)。有关此任务的详细信息,请参见获取注册表生成的证书。
如果需要使用现有的第三方证书,请选择“上载 X509 证书 (DER)”。有关此任务的详细信息,请参见使用第三方证书。
如果您在“用户验证详细信息”页面中选择了“生成密钥对并下载 PKCS12 密钥库”单选按钮,请执行以下步骤。
在“用户验证详细信息”页面的“别名”文本字段中输入用户名。
在“密码”文本字段中输入密码,然后在“密码(重复)”文本字段中再次输入该密码。
请在文本字段中输入值(如果尚未填写这些字段)。
这些文本字段如下所示:
组织单位
组织
市
省/自治区/直辖市
国家/地区
“名称”字段中包含的名称是您在“新用户详细信息”表单中指定的姓氏。如果您在“新用户详细信息”表单中指定了“市”、“省/自治区/直辖市”或“国家/地区”,则这些文本字段中将包含相应的值。
所有字段均为必填项。
单击“下一步”。
将显示标有“步骤 4:将密钥装入 Web 浏览器”的页面,并显示一条消息“已成功注册新用户”。
单击“下载”。
在对话框中,选择允许您将生成的证书保存到磁盘的选项。在文本选择器对话框中,选择文件的目录和名称。
该文件必须具有后缀 .p12。
默认操作将把证书保存到主目录下名为 generated-key.p12 的文件中。
然后,您必须将生成的证书导入到 Web 浏览器中。有关详细信息,请参见将证书装入 Mozilla 或 Firefox Web 浏览器或将证书装入 Internet Explorer Web 浏览器。
如果您在“用户验证详细信息”页面中选择了“上载 X509 证书 (DER)”单选按钮,请执行以下步骤。通过执行这些步骤,将证书置于 Registry 的服务器密钥库中,并将该证书装入 Web 浏览器中。
第三方证书必须为 X.509 格式。通常,此证书位于后缀为 .cer 的文件中。
在“用户验证详细信息”页面中,单击“选择证书文件”按钮。
在“文件上载”对话框中,单击“浏览”按钮以找到要上载的文件,然后单击“上载文件”。
单击“确定”。
文件的名称将显示在“用户验证详细信息”页面中的“选择证书文件”按钮旁边。
单击“下一步”。
在“步骤 4:将密钥装入 Web 浏览器”页面中,按照说明将该证书导入 Web 浏览器中(如果它不在 Web 浏览器中)。
有关详细信息,请参见将证书装入 Mozilla 或 Firefox Web 浏览器或将证书装入 Internet Explorer Web 浏览器。
从“编辑”菜单中选择“首选项”。
单击边栏中的“保密性和安全性”类别以展开选项。
单击“证书”。
单击右侧主面板中的“管理证书”按钮。
将显示“您的证书”选项卡。
单击“导入”按钮。
在“要恢复的文件名”文件选择器对话框中,选择 .p12 证书文件,然后单击“打开”。
在“提示”对话框中,键入软件安全设备主密码的帐户密码。
此密码是特定于浏览器帐户的,并由浏览器配置文件拥有者指定。通常的作法是在客户机上使用同名的密码和登录帐户。
在“密码条目”对话框中,键入证书密码。
此密码用于保护客户机证书。如果使用的是 Registry 生成的证书,请键入您在“用户验证详细信息”页面中指定的密码。
系统将显示“警报”对话框,该对话框显示消息:“已成功恢复您的安全性证书和专用密钥”。
单击“确定”。
关闭“证书管理器”和“首选项”对话框。
导入证书后,您即可登录到注册表。有关详细信息,请参见登录到注册表。
从“工具”菜单中选择“Internet 选项”。
单击“内容”选项卡。
单击“证书”。
单击“导入”以打开“证书导入向导”。
在“证书导入向导”中,单击“下一步”。
在“要导入的文件”页面中,单击“浏览”并找到 .p12 文件,然后单击“下一步”。
在“密码”页面中,执行以下操作:
在“证书库”页面中,选择默认值“将所有证书置于以下库(个人)中”,然后单击“下一步”。
单击“完成”。
在显示的信息对话框中单击“确定”。
新证书连同您指定的名字和姓氏将显示在“证书”窗口中。
在“证书”窗口中单击“关闭”。
在“Internet 选项”窗口中单击“确定”。
导入证书后,您即可登录到注册表。有关详细信息,请参见登录到注册表。
将证书导入 Web 浏览器后,您即可登录。
在“步骤 4:将密钥装入 Web 浏览器”页面中,单击“完成”按钮。
在 Web 控制台的顶部标题区域中,单击“登录”按钮。
在对话框中单击“确定”以验证证书。
登录后,将在顶部标题区域中显示一条消息“验证成功”。
当您登录到 Registry 之后,只要您尝试添加、删除或修改 Registry 对象,就会自动触发验证,因为任何写入请求都会触发基于装入 Web 浏览器的客户机证书的验证。
验证完成后,对注册表的访问就基于 https。
如果会话过期,注册表对您的验证不再有效。后续的写入请求将提示 Web 控制台对您进行重新验证。
如果验证失败,请停止并重新启动 Web 浏览器,然后重试。
使用菜单区域中的“搜索”和“浏览”链接可以搜索注册表。
单击菜单区域中的“搜索”。将打开“搜索”表单。该表单中包含以下组件:
“选择预定义的查询”下拉式列表
“名称”文本字段
“说明”文本字段
"ClassificationScheme" 树
单击“隐藏搜索表单”以关闭“搜索”表单并清除结果区域。
以下几节介绍如何使用这些组件。
“选择预定义的查询”下拉式列表中包含表 1–2 中列出的项。
表 1–2 预定义的查询
查询名称 |
搜索目标 |
---|---|
基本查询 |
默认的通用查询,可用于按对象类型、按名称、按说明和按分类进行搜索 |
基本查询 — 区分大小写 |
区分大小写的基本查询版本 |
FindAllMyObjects |
查找请求查询的用户所拥有(发布)的所有对象。如果该用户拥有许多对象,则可能需要花费较长时间 |
GetCallersUser |
为请求查询的用户查找 User 对象 |
默认选项为“基本查询”。以下各节介绍如何执行基本查询:
使用 FindAllMyObjects 查询可以搜索已发布的所有对象。使用 GetCallersUser 查询可以查看或修改注册时创建的用户数据。
仅按对象类型搜索是最简单的搜索方式。
“对象类型”下拉式列表中的默认选项为 "RegistryObject",该选项用于搜索 Registry 中的所有对象。要缩小搜索范围,请更改对象类型。
"ClassificationNode" 菜单项中列出了 ClassificationScheme 中的概念。ClassificationNode 与 Concept 同义。
从“选择预定义的查询”下拉式列表中选择“基本查询”或“基本查询 -- 区分大小写”。
在“名称”或“说明”字段中键入一个字符串。
单击“搜索”。
默认情况下,该搜索将查找与您键入的整个字符串相匹配的名称或说明。您可以使用通配符来查找一系列对象。
通配符包括百分号 (%) 和下划线 (_)。
% 通配符可以代表多个字符:
键入 %off% 将返回包含字符串 off 的名称或说明,例如 Coffee。
键入 nor% 将返回以字符串 Nor 或 nor 为开头的名称或说明,例如 North 和 northern。
键入 %ica 将返回以字符串 ica 为结尾的名称或说明,例如 America。
下划线通配符代表单个字符。例如,搜索字符串 _us_ 将匹配名为 Aus1 和 Bus3 的对象。
分类对象使用分类方案内定义有效值的唯一概念 (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 树的根节点位于“说明”字段的下方。
展开根节点以查看分类方案的完整列表。
每个条目后面括号中的数字表示父概念中包含的概念(ClassificationNode 对象)数。
展开要使用的分类方案节点。
展开分类方案下面的概念节点,直至您找到要按其进行搜索的叶节点。叶节点是下面没有任何概念的节点。
选择该叶节点。
(可选的)通过选择对象类型或指定名称或说明字符串限制搜索范围。
单击“搜索”按钮。
“注册表对象”区域中将显示通过搜索找到的对象。
“注册表对象”区域包含以下部分:
标有“应用”、“批准”、“过时”、“取消过时”、“关联”和“删除”的按钮,使用这些按钮可以对对象执行操作。您必须是对象的创建者或者是 Registry 管理员才能执行上述操作。
找到的对象将以搜索结果表的形式显示。对于大多数对象,表中将包含以下几列:
对于 ExtrinsicObject 对象,还会有另外两列:“内容版本”和“内容版本注释”。这两列适用于 ExtrinsicObject 的系统信息库项目。
对于以下两类对象,“版本”和“版本注释”列将被替换为其他内容:
ExternalLink 对象:外部 URI
ServiceBinding 对象:端点
使用用户界面的固定功能可以在搜索其他对象时在“Registry 对象”区域中保留一个或多个对象。然后您可以在两个对象之间创建关系。有关如何执行上述操作的详细信息,请参见创建对象之间的关系。
如果您不再使用固定的对象,请取消选中该对象的“固定”复选框。当您再执行查询时,该对象将不会显示在“Registry 对象”区域中。
在搜索结果表中,单击对象的“详细信息”链接可以立即打开“Registry 对象”区域下方的“详细信息”区域。
该区域包含一系列按钮和选项卡:
按钮包括“应用”、“保存”、“取消”、“批准”、“过时”、“取消过时”和“删除”。按钮表示可以对对象执行的操作。
选项卡表示对象的属性。根据对象类型的不同,您看到的选项卡也会有所不同。表 1–4 介绍了选项卡及其适用的对象。
选项卡名称 |
适用于 |
---|---|
Object_Type 详细信息 |
所有对象(Object_Type 是对象类型名称) |
插槽 |
所有对象 |
分类 |
所有对象 |
外部标识符 |
所有对象 |
关联 |
所有对象 |
外部链接 |
所有对象 |
审计跟踪 |
所有对象 |
邮政地址 |
工作单位,用户 |
电话号码 |
工作单位,用户 |
电子邮箱地址 |
工作单位,用户 |
用户 |
组织 |
组织 |
组织 |
服务绑定 |
服务 |
规范链接 |
ServiceBinding |
概念 |
ClassificationScheme、ClassificationNode |
注册表对象 |
RegistryPackage |
受影响的对象 |
AuditableEvent |
单击选项卡可以查看该对象是否具有任何属性值。如果有,则单击属性值的“详细信息”链接可以打开 Web 浏览器窗口,该窗口中显示此属性值的详细信息。
“审计跟踪”选项卡生成的表中没有“详细信息”链接,而是生成包含以下信息的表单:
事件类型
事件的日期和时间
导致该事件发生的用户的名称
对于大多数对象,“详细信息”区域包含以下字段:
“唯一标识符”。对于每个对象,“唯一标识符”均为活动链接。单击此链接可以在 Web 浏览器窗口中查看对象的 XML。所有 Registry 对象都以 XML 格式存储。
“逻辑唯一标识符”。逻辑唯一标识符通常与唯一标识符相同。如果启用版本化,则该对象所有版本的逻辑唯一标识符都保持相同,而新版本的唯一标识符将添加表示版本号的后缀。
“名称”
“说明”
“状态”(通常为“已提交”,表示对象已发布到 Registry 中)
“版本”
“版本注释”
对于许多对象,这些字段大都无需加以说明(例如,工作单位的邮政地址)。对于某些对象,这些字段需要一些说明。以下各节中将介绍这些字段。
关联对象的“详细信息”区域包含以下附加字段:
“源对象 ID”和“目标对象 ID”。对于关联的源对象和目标对象,面板中将同时显示唯一标识符和逻辑标识符。“由源拥有者确认”复选框表示该关联是否已由源对象拥有者确认或批准。“由目标拥有者确认”复选框表示该关联是否已由目标对象拥有者确认或批准。对于内部关联,该复选框将始终被选中。
“关联类型”。该菜单显示关联的选定类型。
“外部”。如果两个关联的对象中至少有一个对象归创建此关联以外的用户拥有,则选中此复选框。否则,此关联定义为内部关联。
ClassificationScheme 对象的“详细信息”区域包含以下附加字段:
“外部分类方案”复选框。如果分类方案不是在 Registry 中定义的(即如果分类方案中没有任何概念),则选中此复选框。内部分类方案是在 Registry 内定义其概念分层结构的分类方案。
“值类型”菜单,该菜单中包含以下选项之一:
"Unique":该值表示分类的每个节点均被指定一个唯一代码。当您在 Service Registry 中创建分类方案时,这是默认值。
"EmbeddedPath":该值表示指定给该分类的每个节点的唯一代码还将对其路径进行编码。
"NonUnique":在某些情况下节点不唯一,并必须使用完整路径(从 ClassificationScheme 至需要的节点)标识节点。例如,在地理分类中,Moscow 既可能在俄罗斯的子分类下,也可能在美国的子分类下,其中在美国有五个州均有城市名为 Moscow。
ExtrinsicObject 对象的“详细信息”区域包含以下附加字段:
“内容版本”和“内容版本注释”。“详细信息”区域将显示与外部对象相关联的系统信息库项目的版本和可选注释。
“MIME 类型”。该字段包含外部对象的 MIME 类型。
“不透明”复选框。如果 Registry 不能读取系统信息库项目(例如,如果系统信息项目被加密),则选中此复选框。
“对象类型”。该字段包含 "ObjectType/ExtrinsicObject" 树中的子概念。
“查看系统信息库项目内容”链接。单击此链接可在 Web 浏览器窗口中查看系统信息库项目。
在 ExternalLink 对象的“详细信息”区域的“外部 URI”字段下方包含“显示内容”链接。单击该链接可以在浏览器窗口中查看 URI 的内容。
“资源管理器”菜单就像文件夹的分层结构,可用于浏览 Registry 和系统信息库内容。名为 root 的根文件夹包含所有 Registry 内容。
单击“资源管理器”链接。
展开 root 文件夹。该文件夹包含两个子文件夹:userData(其中保存了所有用户内容)和 ClassificationScheme。
单击一个文件夹以查看相应类型的注册表对象。展开一个节点以查看下一级的对象类型。
完成后,单击“隐藏资源管理器”以关闭“资源管理器”菜单并清除结果区域。
单击 ClassificationScheme 文件夹(不是节点符号)。
所有 ClassificationScheme 对象都显示在“Registry 对象”区域中。要查看对象,请按照查看搜索结果中的说明进行操作。
展开 "ClassificationScheme" 节点以在菜单区域中打开 ClassificationScheme 树分层结构。
单击任一文件图标以在“Registry 对象”区域中查看该分类方案。
展开一个分类方案节点以查看该节点下面的概念文件夹。
并非所有分类方案在“资源浏览器”菜单中都有可查看的概念。
单击一个概念文件夹以在“Registry 对象”区域中查看该概念。
展开 userData 节点。
展开 "RegistryObject" 节点。请勿单击文件夹,除非您要查看所有 Registry 对象。
folder1 节点中没有内容。
单击一个文件夹以查看相应类型的注册表对象。展开一个节点以查看下一级的对象类型。
使用“创建新 Registry 对象”菜单项可以创建对象并将其发布到 Registry 中。
将对象发布到 Registry 的过程包括三个步骤:
创建对象。
添加详细信息和其他对象,把对象保存到内存中但并不发布到 Registry 中。
将对象发布到注册表中。
如果您已创建用户帐户并已登录,则可以将对象发布到 Registry 中。要创建用户帐户,请按照创建用户帐户中的说明进行操作。
在菜单区域中,单击“创建新的注册表对象”。
在“Registry 对象”区域的下拉式列表中选择一个对象类型,然后单击“添加”。
该对象的详细信息表单将显示在“详细信息”区域中。
在“详细信息”表单的字段中键入名称和(可选)说明。为“详细信息”表单中显示的其他字段键入值。
创建 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'')
(可选的)用您自己选择的标识符替换指定的唯一标识符和逻辑唯一标识符。
每个标识符必须为有效的 URN,并且在安装的 Registry 内必须唯一。
(可选的)单击“保存”将该对象保存到内存中。
(可选的)使用“详细信息”表单中的选项卡添加和保存编辑后的对象。
单击“应用”将该对象发布到注册表中。
将显示一条表示应用是否成功的状态消息。
不管是在发布对象之前还是之后,您都可以通过向该对象添加编辑后的对象来对其进行编辑。表 1–4 列出了可以添加的对象。以下各节介绍了如何添加这些对象。
要创建分类,请使用内部分类方案。内部分类方案包含一组概念,Registry 已经知道这些概念的值。
要向对象中添加分类,请搜索适当的分类方案,然后在该分类方案中选择一个概念。
在对象的“详细信息”区域中,单击“分类”按钮。
将显示“分类”表(可能为空白)。
单击“添加”。
将打开“详细信息面板”窗口。
键入分类的名称和(可选)说明。
单击“选择 ClassificationScheme 或 Concept”按钮。
将打开“ClassificationScheme/Concept 选择器”窗口。
展开 "ClassificationScheme" 节点。再展开概念节点,直至您选定需要使用的叶节点。
单击“确定”以关闭“ClassificationScheme/Concept 选择器”窗口。
分类方案和概念将显示在“详细信息面板”窗口中。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
要创建外部标识符,请使用外部分类方案。外部分类方案中有 Registry 未知的值,因为此分类方案没有概念。
要向对象中添加外部标识符,请搜索适当的分类方案,然后指定一个值。
在对象的“详细信息”区域中,单击“外部标识符”选项卡。
将显示 "External Identifier" 表(可能为空白)。
单击“添加”。
将打开“详细信息面板”窗口。
键入外部标识符的名称和(可选)说明。
单击“选择 ClassificationScheme”按钮。
将打开“ClassificationScheme/Concept 选择器”窗口。
展开 "ClassificationScheme" 节点,然后选择没有概念的分类方案。
单击“确定”以关闭“ClassificationScheme/Concept 选择器”窗口。
分类方案将显示在“详细信息面板”窗口中。
在“值”字段中键入值。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
使用外部链接可以将 URI 与注册表对象关联起来。
在对象的“详细信息”区域中,单击“外部链接”选项卡。
将显示 "External Link" 表(可能为空白)。
单击“添加”。
将打开“详细信息面板”窗口。
键入外部链接的名称。
在“外部 URI”字段中键入外部链接的 URL。
(可选的)如果需要指定该 URL 指向的内容的类型,请单击“选择对象类型的概念”按钮。
展开 "ClassificationScheme" 节点。通过展开 "ObjectType" 节点、"RegistryObject" 节点和 "ExtrinsicObject" 节点以找到内容类型。选择所需的概念,然后单击“确定”。如果未找到合适的类型,请单击“取消”。您可以根据需要为 ExtrinsicObject 创建新概念。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
插槽包含不能存储到 Registry 中的附加信息。使用插槽可以向对象中添加任意属性。
在对象的“详细信息”区域中,单击“插槽”选项卡。
将显示“插槽”表(可能为空白)。
单击“添加”。
将打开“详细信息面板”窗口。
键入插槽的名称。
(可选的)在“插槽类型”字段中键入一个值。您可以使用该字段为插槽指定数据类型或提供将插槽汇集在一起的方法。
在“值”字段中键入值。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
一个组织或用户可以有一个或多个邮政地址。
在组织或用户的“详细信息”区域中,单击“邮政地址”选项卡。
将显示“邮政地址”表(可能为空白)。
单击“添加”。
将打开“详细信息面板”窗口。
在字段中键入所需的值。所有字段均为可选字段。
门牌号码
街道
市
省/自治区/直辖市
国家/地区
邮政编码
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
一个组织或用户可以有一个或多个电话号码。
在组织或用户的“详细信息”区域中,单击“电话号码”选项卡。
将显示“电话号码”表(可能为空白)。
单击“添加”。
将打开“详细信息面板”窗口。
从“类型”组合框中选择一个值。
可使用以下值:
寻呼机
传真
家庭电话
移动电话
办公电话
在字段中键入所需的值。所有字段均为可选字段。
国家/地区代码
区域代码
电话号码
分机
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
一个组织或用户可以有一个或多个电子邮件地址。
在组织或用户的“详细信息”区域中,单击“电子邮件地址”选项卡。
将显示“电子邮件地址”表(可能为空白)。
单击“添加”。
将打开“详细信息面板”窗口。
从“类型”组合框中选择一个值:家庭电子邮件或办公电子邮件。
在“电子邮件地址”字段中键入所需的值。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
一个组织可以有一个或多个用户。通常,创建组织的那一个用户是主要联系人。您还可以创建和添加其他用户。
在组织的“详细信息”区域中,单击“用户”选项卡。
将显示“用户”表。
单击“添加”。
将打开“详细信息面板”窗口。
在“名称”字段中,在逗号的左侧键入用户的姓氏。(可选)在逗号的右侧键入用户的名字和中间名。
(可选的)在“说明”字段中键入用户的说明。
在“名字”、“中间名”和“姓氏”字段中键入用户的名字、中间名和姓氏。所有字段均为可选字段。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
一个组织可以有一个或多个下一级组织。要向组织中添加下一级组织,请执行以下步骤:
在组织的“详细信息”区域中,单击“下一级组织”选项卡。
将显示 "ChildOrganizations" 表。
单击“添加”。
将打开“详细信息面板”窗口。
在“名称”字段中,键入新组织的名称。
(可选的)在“说明”字段中键入说明。
(可选的)在地址字段中键入所需的值。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
一个服务通常有一个或多个服务绑定。
在服务的“详细信息”区域中,单击“服务绑定”选项卡。
将显示“服务绑定”表。
单击“添加”。
将打开“详细信息面板”窗口。
在“名称”字段中,键入服务绑定的名称。
(可选的)在“说明”字段中,键入服务绑定的说明。
在“访问 URL”字段中,键入服务绑定的 URL。
(可选的)在“目标绑定”字段中,键入此 ServiceBinding 引用的另一个 ServiceBinding 的唯一标识符。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
ServiceBinding 可以具有一个 SpecificationLink 对象。
在 ServiceBinding 的“详细信息”区域中,单击“规范链接”选项卡。
将显示“规范链接”表。
单击“添加”。
将打开“详细信息面板”窗口。
在“名称”字段中,键入 SpecificationLink 的名称。
(可选的)在“说明”字段中,键入 SpecificationLink 的说明。
在“用法说明”字段中,键入用法参数的使用说明(如果 SpecificationLink 有用法参数)。
在“用法参数”字段中,键入用法参数(如果 SpecificationLink 有用法参数)。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
ClassificationScheme 通常有许多子概念(这些子概念也可以有自己的子概念)。
在 ClassificationScheme 的“详细信息”区域中,单击“子概念”选项卡。
将显示 "ChildConcept" 表。
单击“添加”。
将打开“详细信息面板”窗口。
在“名称”字段中,键入概念的名称。
(可选的)在“说明”字段中键入用户的说明。
在“值”字段中,键入概念的值。
单击“添加”以保存新对象并关闭“详细信息面板”窗口。
在对象的“详细信息”区域中,单击“应用”。
RegistryPackage 是包含其他注册表对象的对象。通常,使用 RegistryPackage 可以对相关对象进行逻辑分组。这些对象可以是不同的类型,并且可以属于不同的拥有者。
通过指定对象的唯一标识符,可以将其添加到注册表信息包中。如果您尝试键入唯一的标识符,则很可能会出错。因此,以下步骤将介绍如何通过复制并粘贴标识符来添加对象。
按照创建和发布新 Registry 对象中的说明创建 RegistryPackage 对象。指定名称和(可选)说明,但此时不向其添加任何 RegistryObject。
单击“应用”保存 RegistryPackage 后,请按照使用固定功能中的说明固定该 RegistryPackage。
使用 Web 控制台搜索需要添加到 RegistryPackage 中的对象。找到每个对象时就将其固定。
单击需要添加到 RegistryPackage 的对象的“详细信息”链接。
在该对象的“详细信息”面板中,使用键盘(Ctrl-C 或“复制”键)复制唯一标识符。
在“搜索结果”区域中,单击 RegistryPackage 的“详细信息”链接。
在该对象的“详细信息”区域中,单击“注册表对象”选项卡。
单击“添加到软件包”。
在“唯一标识符”字段中,使用键盘(Ctrl-V 或“粘贴”键)粘贴已复制的标识符。
单击“添加”。
该对象将显示在“注册表对象”区域中。
单击“详细信息”区域中的“应用”以保存此 RegistryPackage。
重复执行步骤 4 至步骤 11 将每个附加对象添加到此 RegistryPackage 中。
如果您是拥有者或被另外授权,您不但可以发布、编辑和删除对象,而且还可以对对象执行以下操作:
批准
过时
取消过时
如果需要建立 Registry 对象的版本控制策略,这些功能在生产环境中会很有用。例如,您可以批准某个版本的对象供一般使用,并可以在删除对象之前使已过时的版本过时。如果要在使对象过时后恢复使用此对象,您可以取消该对象的过时。
以下所有操作都在“搜索结果”区域执行。
要批准一个对象,请选择该对象,然后单击“批准”按钮。将显示一条确认批准的消息。此事件将被添加到“审计跟踪”中。
要使一个对象过时,请选择该对象,然后单击“过时”按钮。将显示一条确认过时的消息。此事件将被添加到“审计跟踪”中。
要取消一个对象的过时,请选择该对象,然后单击“取消过时”按钮。将显示一条确认取消过时的消息。此事件将被添加到“审计跟踪”中。
要从 Registry 中删除您拥有的对象,请在“搜索结果”区域中选择此对象,然后单击“删除”按钮。
请勿从您拥有的对象中删除 AuditableEvent 对象。即,不要删除使用 FindAllMyObjects 搜索后显示在“搜索结果”区域中的任何 AuditableEvent 对象。如果删除 AuditableEvent 对象,将会破坏属于此对象的审计跟踪。
如果此对象是外部对象,则可以采取两种方法:
从“删除选项”菜单中选择“删除对象和系统信息库项目”(默认值)以删除 ExtrinsicObject Registry 对象及其引用的系统信息库项目。
选择“仅删除系统信息库项目”以删除 Registry 中的系统信息库项目而保留 ExtrinsicObject。然后,您可以添加其他系统信息库项目。
“删除选项”菜单仅对外部对象有意义。
对象之间存在两种关系:引用和关联。这两种关系都是单向关系。即,每种关系都有一个源对象和一个目标对象。
Registry 支持某些类型的对象之间的引用,此类引用称为 ObjectRef。例如,如果您创建了一个服务和一个 ServiceBinding,则可以创建一个从该服务到该 ServiceBinding 的 ServiceBinding 引用。但是,您不能创建从 ServiceBinding 到该服务的引用。引用不是 Registry 对象。
关联是 Registry 对象。您可以创建从任一 Registry 对象到任一其他 Registry 对象的关联。Registry 支持 AssociationType 分类方案,其中包括大量预定义关联类型:OffersService、RelatedTo 和 HasMember 等。还可以创建新的关联类型。如果您同时拥有关联的两个对象,则此关联为内部关联。如果您不同时拥有关联的两个对象,则此关联为外部关联。如果您创建了一个组织并向其中添加了服务,则从该组织到该服务的 OffersService 类型的关联将自动创建。
如果源对象与目标对象之间不存在有效引用,则无法创建引用。
使用“注册表对象”区域中的“关联”按钮可以将两个对象关联起来。当您在搜索结果表中选定两个对象后,此按钮即被激活。
如果在搜索结果表中不能同时看到两个对象,请选择“固定”复选框将一个对象保留在搜索结果表中,再去查找要与其关联的对象。有关详细信息,请参见使用固定功能。
在“注册表对象”区域中,选择两个对象,然后单击“关联”。
在“创建关系”区域中,选择源对象(如果尚未选定)。
另一个对象将成为目标对象。
如果源对象和目标对象之间存在有效的引用,则“引用”选项在默认情况下处于选中状态,并将显示有效的引用属性。如果源对象和目标对象之间不存在有效的引用,则“引用”单选按钮将灰显。
单击“保存”以保存引用。
在“注册表对象”区域中,选择两个对象,然后单击“关联”。
在“创建关系”区域中,选择源对象(如果尚未选定)。
另一个对象将成为目标对象。
选择“关联”单选按钮(如果尚未选中)。
在“详细信息”区域中,键入关联的名称和(可选)说明。
源对象 ID 值和目标对象 ID 值均已填写。
从“关联类型”菜单中选择一个类型值。
单击“应用”以保存关联。
本节介绍了在使用 Web 控制台时可能遇到的一些问题的解决方案。
如果在尝试使用 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 对象指定一个 ExternalURI 时
为 ServiceBinding 对象指定一个 AccessURI 时
错误消息类似如下:
The URL: uri is not resolvable. Use Absolute Path Format [scheme:][//authority][path][?query][#fragment] |
此错误表示尚未执行《Service Registry 3 2005Q4 管理指南》中的“允许访问外部 Web 站点”中所述的管理任务。站点的 Service Registry 管理员必须先执行此任务并重新启动 Registry,然后您才能创建这些对象。
要获得可能引发 Web 控制台错误消息的问题说明,请查看用于 Registry 的 Application Server 域的服务器日志。有关详细信息,请参见《Service Registry 3 2005Q4 管理指南》中的“管理用于 Service Registry 的 Application Server 域”。
在尝试将新对象保存到注册表时收到错误消息的情况下:
如果使用的是 Registry 生成的证书,请确保已将此证书导入 Web 浏览器中。
如果使用的是第三方证书,请确保管理员已将证书授权机构的根证书置于用于 Registry 的 Application Server 域的信任存储中。有关详细信息,请参见《Service Registry 3 2005Q4 管理指南》中的“将根证书添加到 Registry 域的信任证书中”。
如果注册表控制台没有响应,请执行以下步骤:
记下显示的错误消息。
清除 Web 浏览器中的会话 Cookie。要清除 Cookie,请在正在运行 Registry 的站点上找到名为 JSESSIONID 的 Cookie 并将其删除。如果无法确定,请删除所有 Cookie。
请按照启动 Web 控制台中的说明重新启动 Web 控制台。
与 Registry 支持部门联系,并告知错误消息的内容以及导致出现错误的操作步骤。