Service Registry 3.1 用户指南

发布对象

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

  1. 创建对象。

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

  3. 将对象发布到 Registry 中。

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

下面的第一个任务介绍创建任意新对象时要执行的步骤。随后几节将介绍发布特定类型的对象时需要执行的其他步骤。

您可以创建和发布表 2–2 中列出的任意对象,但存在以下例外:

本节介绍了以下任务:

Procedure创建和发布新注册表 (Registry) 对象

  1. 在左侧菜单区域的“任务”选项卡中,单击“创建新注册表 (Registry) 对象”。

  2. 在“注册表 (Registry) 对象”区域的组合框中选择一个对象类型,然后单击“添加”。

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

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

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

  5. (可选的)在“版本注释”字段中键入注释。

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

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

  7. 在特定于对象类型的字段中输入数据。

  8. 单击“保存”将该对象保存到内存中。


    注 –

    在移至另一选项卡前,请确保已保存您在该对象的任意选项卡区域中所做的更改。如果不保存,所做更改将会丢失。


  9. (可选的)使用“详细信息”表单中的选项卡添加和保存组合对象。

  10. 单击“应用”将该对象发布到 Registry 中。

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

接下来的操作

不管是在发布对象之前还是之后,您都可以编辑该对象以添加其组合对象。 表 2–4 列出了可以添加的对象。后面各节介绍了如何添加这些对象。

Procedure创建和发布特殊查询 (AdhocQuery) 对象

特殊查询 (AdhocQuery) 对象表示以查询语法表达的特殊查询。特殊查询 (AdhocQuery) 对象用于搜索注册表 (Registry) 对象。就用途而言,特殊查询 (AdhocQuery) 对象与关系数据库中的存储过程的概念类似。例如,“搜索”面板中预定义的查询全部为特殊查询 (AdhocQuery) 对象。

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“特殊查询 (AdhocQuery)”。

  2. (可选的)从“查询类型”组合框中选择一个查询类型。

    默认值为“SQL 查询”。其他受支持的查询类型为 "XQuery" 和“ebXML 过滤器查询”。

  3. 在“查询字符串”字段中键入查询文本。

    对于 SQL 查询,使用两对单引号括起通常用一对单引号括起的项目。这些项目出现在子查询中时,通常为参数占位符和字面值。例如,在子查询中指定参数占位符,如下所示:

    (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. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

Procedure创建和发布分类节点 (ClassificationNode) 对象

分类节点 (ClassificationNode) 对象表示与内部分类方案中的其他元素具有结构关系的分类元素。您可以创建分类节点 (ClassificationNode) 对象,然后将其添加到分类方案中,但使用“分类方案 (ClassificationScheme) 详细信息”面板的“概念”选项卡创建概念可能会更简单。

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“分类节点 (ClassificationNode)”。

  2. 在“值”字段中,键入分类节点 (ClassificationNode) 对象的值。

    “分类方案”、“父 ID”以及“路径”字段将显示为灰色。

  3. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

Procedure创建和发布分类方案 (ClassificationScheme) 对象

分类方案 (ClassificationScheme) 对象表示用于分类对象的分类。在内部分类方案 (ClassificationScheme) 中,所有分类元素在 Registry 中均定义为 Concept 实例。在外部分类方案 (ClassificationScheme) 中,这些值不会在 Registry 中定义为 Concept 实例,而是以其 String 表示方式进行引用。

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“分类方案 (ClassificationScheme)。

    将选中“外部分类方案”复选框,以表示该方案没有概念。如果您向分类方案中添加概念,则该复选框将不再处于选中状态。

  2. 从“值类型”组合框中选择一个值:

    • 唯一。表示分类的每个节点均被指定一个唯一代码。

    • 嵌入路径。表示指定给该分类的每个节点的唯一代码还将对其路径进行编码。

    • 不唯一。表示节点不唯一,且必须使用完整路径(从分类方案 [ClassificationScheme] 至需要的节点)标识节点。

    默认值为“唯一”。

  3. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

Procedure创建和发布外部链接 (ExternalLink) 对象

外部链接 (ExternalLink) 对象为驻留在 Registry 外部的内容提供 URI。

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“外部链接 (ExternalLink)”。

    “对象类型”字段包含外部链接 (ExternalLink) 值。

  2. (可选的)单击“选择对象类型的概念”按钮以选择由 URI 引用的数据的对象类型。

    在“外部对象分类节点选择器”窗口中展开节点,直到找到属于外部对象 (ExtrinsicObject) 类型的相应概念。单击“确定”后,“对象类型”窗口将包含您所选择的类型。

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

  4. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。


    注 –

    如果在尝试保存外部链接 (ExternalLink) 对象时收到错误消息,表示必须执行一项管理任务。有关详细信息,请参见无法创建外部链接 (ExternalLink)服务绑定 (ServiceBinding)


Procedure创建和发布外部对象 (ExtrinsicObject) 对象

外部对象 (ExtrinsicObject) 提供用于描述类型不为 Registry 所知的内容的元数据。由于类型未知,因此必须通过其他属性进行描述,例如 MIME 类型。

使用外部对象 (ExtrinsicObject) 发布不同类型的文件。通常是 Web 服务辅件,例如 WSDL 文件。

Web 服务的 ebXML 注册表配置文件是一种 OASIS 标准,用于定义 ebXML 注册表配置文件以发布、管理、控制、搜索和重复使用 Web 服务辅件。默认情况下,Service Registry 实现此配置文件。实际上,这表示当您将 WSDL 文件作为外部对象 (ExtrinsicObject) 对象发布到 Registry 时,Registry 将创建该文档的某些标准元数据,实质上也就创建了文档定义的 Web 服务。此功能称为 WSDL 目录服务

要发布一个或多个彼此之间或与其他文件(例如 XSD 文件)之间有依赖关系的 WSDL 文件,请创建一个包含所有文件的 zip 文件。

管理员可以禁用 WSDL 目录服务功能。有关详细信息,请参见《Service Registry 3.1 管理指南》中的“禁用 WSDL 编目程序”

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“外部对象 (ExtrinsicObject)”或其子类型之一。

    例如,要发布一个或多个 WSDL 文件,请选择 "WSDL"。

  2. (可选的)在“Mime 类型”字段中键入对象的 MIME 类型。该类型应为 http://www.iana.org/assignments/media-types 中列出的一种类型。

    如果您要上载独立的 WSDL 文件(包含 XML 的文本文件),请将 MIME 类型设置为 text/xml

    如果您要上载包含多个 WSDL(或者还有 XSD)文件的 zip 文件,请将 MIME 类型设置为 application/zip

  3. (可选的)如果 Registry 无法读取对象的内容(例如,内容已加密),请选中“不透明”复选框。

  4. 如果需要选择比外部对象 (ExtrinsicObject) 更具体的对象类型,请单击“选择对象类型的内容”按钮。

    在“外部对象分类节点选择器”窗口中展开节点,直到找到属于外部对象 (ExtrinsicObject) 类型的相应概念。单击“确定”后,“对象类型”窗口将包含您所选择的类型。

  5. 单击“选择系统信息库项目文件”按钮以找到外部对象 (ExtrinsicObject) 的系统信息库项目。

    1. 在“文件上载”窗口中,在文本字段中键入文件路径或单击“浏览”。

    2. 如果您单击“浏览”,请使用文件选择器窗口浏览到文件,然后单击“打开”。

    3. 在“文件上载”窗口中,单击“上载文件”。

    4. 单击“确定”。

    “详细信息”面板中将显示以下项目:

    • “内容版本”字段(显示为灰色)

    • 可由您填写的“内容版本注释”字段

    • “删除系统信息库项目”按钮

    • “查看系统信息库项目内容”链接

  6. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

接下来的操作

创建了引用 WSDL 文件的外部对象 (ExtrinsicObject) 对象后,您可以使用“WSDL 搜索查询”来查找它。同样,如果您使用“基本查询”搜索 WSDL 类型的外部对象 (ExtrinsicObject) 对象、服务 (Service) 对象和服务绑定 (ServiceBinding) 对象,您会发现 Registry 已创建由 WSDL 文件的元素指定的所有对象:

Procedure创建和发布联合 (Federation) 对象

联合 (Federation) 表示注册表的附属组。它的唯一属性为基本 RegistryObject 属性。要创建联合 (Federation) 对象,您必须是管理员。

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“联合 (Federation)”。

  2. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

  3. 通过执行创建对象之间的关系中的步骤将附属注册表添加到联合 (Federation)。这些具体步骤如下:

    1. 搜索联合 (Federation),选中它的“选取”复选框,然后单击“书签”。

    2. 搜索注册表 (Registry),选中它的“选取”复选框,然后单击“关联”。

    3. 在“创建关系”区域中,选择联合 (Federation) 作为源对象。注册表 (Registry) 将成为目标对象。

    4. 将 AssociationType 设置为 HasFederationMember。

Procedure创建和发布组织 (Organization) 对象

组织 (Organization) 对象提供有关组织的信息。它可以具有一个父组织,也可以具有一个或多个子组织。该对象始终具有一个用户 (User) 对象作为主要联系人,并可以通过在组织与一个或多个服务 (Service) 对象之间创建关联来提供服务。

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“组织 (Organization)”。

  2. (可选的)在“邮政地址”字段中键入值。

  3. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

    有关将组合对象添加到组织 (Organization) 对象的详细信息,请参见以下各节:

  4. 要将服务 (Service) 添加到组织 (Organization),请执行创建对象之间的关系中的步骤。这些具体步骤如下:

    1. 搜索组织 (Organization),选中它的“选取”复选框,然后单击“书签”。

    2. 搜索服务 (Service),选中它的“选取”复选框,然后单击“关联”。

    3. 在“创建关系”区域中,选择组织 (Organization) 作为源对象。服务 (Service) 将成为目标对象。

    4. 将 AssociationType 设置为 OffersService。

Procedure创建和发布个人 (Person)用户 (User) 对象

个人 (Person)用户 (User) 对象提供有关 Registry 中的人员和已注册用户的信息。这两种对象具有相同的属性。用户 (User) 对象作为主要联系人附属于组织 (Organization) 对象。用户 (User) 对象还用于在可审计事件 (AuditableEvent) 对象中标识发送生成可审计事件 (AuditableEvent) 的请求的请求者。

建议您通过用户注册向导创建用户 (User) 对象。当您要为不会亲自访问 Registry 的人员创建元数据时,请使用 Web 控制台来创建个人 (Person) 对象。

如果要为人员创建多个邮政地址、电子邮件地址或电话号码,请创建用户 (User) 对象。Web 控制台允许您将邮政地址、电子邮件地址和电话号码添加为用户 (User) 对象的组合对象,而不是为个人 (Person) 对象。

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“个人 (Person)”或“用户 (User)”。

  2. 在“姓名”字段中键入值。

    请至少为其中一个字段指定值。

    请勿使用“名称”字段。Web 控制台会忽略您在“名称”字段中为个人 (Person)用户 (User) 对象键入的任何值。

  3. 按照以下各节所述添加组合对象:

  4. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

Procedure创建和发布注册表 (Registry) 对象

注册表 (Registry) 对象表示注册表。它的唯一属性为基本 RegistryObject 属性。要创建注册表 (Registry) 对象,您必须是管理员。

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“注册表 (Registry)”。

  2. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

接下来的操作

有关如何将注册表 (Registry) 添加到联合 (Federation) 的信息,请参见创建和发布联合 (Federation) 对象

Procedure创建和发布注册表包 (RegistryPackage) 对象

注册表包 (RegistryPackage) 对象表示任意数量的注册表 (Registry) 对象的逻辑分组。

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“注册表包 (RegistryPackage)”。

  2. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

  3. 要将对象添加到软件包中,请按照向注册表包 (Registry Package) 中添加对象中的说明进行操作。

Procedure创建和发布服务 (Service) 对象

服务 (Service) 对象提供有关服务的信息。它可能包含一个或多个服务绑定 (ServiceBinding) 对象,这些对象表示有关如何访问服务的技术信息。

发布服务 (Service) 对象的最常用方法是发布由一个或多个 WSDL 文件构成的外部对象 (ExtrinsicObject) 对象。有关更多信息,请参见创建和发布外部对象 (ExtrinsicObject) 对象

  1. 执行创建和发布新注册表 (Registry) 对象中的步骤 1–6。在步骤 2 中,选择“服务 (Service)”。

  2. 执行创建和发布新注册表 (Registry) 对象中的步骤 8–10。

  3. 要将服务绑定 (ServiceBinding) 对象添加到服务,请按照向服务中添加服务绑定 (Service Binding)中的说明进行操作。

  4. 要将规范链接 (SpecificationLink) 对象添加到服务绑定 (ServiceBinding),请按照向服务绑定 (Service Binding) 中添加规范链接 (Specification Link)中的说明进行操作。