IBM FileNet P8, V5.2            

通过 URL 访问对象

URL 可寻址性功能使用户能够直接访问对象,而不必浏览整个 IBM® FileNet® P8 客户机用户界面。登录 FileNet P8 客户机(例如,Workplace XT)之后,用户只需在浏览器的地址栏中输入对象的 URL。(管理员可以创建书签或收藏夹来检索文件夹或可版本化的对象。)

利用 URL 可寻址性,您可以执行下列操作:
  • 检索文档、文件夹、已存储的搜索、搜索模板、工作流程定义和发布模板。
  • 下载下列对象类型并将它们保存在本地计算机上:文档、已存储的搜索、搜索模板、发布模板和工作流程定义。
  • 输入基于路径或基于标识的 URL,如下所示。
基于路径的 URL 使用包含路径来指定对象在对象库中的位置。例如,要检索位于 Transportation 对象库的 Projects 文件夹中名为 Current® Works 的文档,用户应该输入类似以下示例的 URL:

http://P8_client_server_name/application_name:port/getContent/Transportation/Projects/Current+Works

要使用基于路径的 URL 来检索对象,必须设置使用基于路径的 URL 站点首选项。

基于标识的 URL 使用 GUID 来指定对象在对象库中的位置。文档的位置由文档所在对象库的 GUID 以及文档的 GUID 来指定。例如,要检索文档,用户应输入类似以下示例的 URL:

http://P8_client_server_name/application_name:port/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}

基于标识的地址通常比基于路径的地址更快;但是,只有基于路径的 URL 才能解析文档中的相对引用。例如,如果使用基于路径的 URL 来请求文件“example.html”,那么会检索该文件,并且浏览器会解析 example.html 中需要的任何其他 URL(例如,<script>、<img> 和 <link> 标记)。当用户单击任何链接 (<a href=...>) 时,这些链接由浏览器进行解析。

下表列出了对您可以在 URL 中指定的不同对象类型的缺省响应。
对象类型 响应
文件夹 返回一个显示文件夹名的页面。
文档 如果文档具有内容,那么将返回该内容。如果文档具有外部引用,那么 FileNet P8 客户机会根据需要重定向客户机。如果文档不具有内容,那么 FileNet P8 客户机将报告错误。
工作流程定义 打开流程设计器 applet。
已存储的搜索 返回一个显示已存储搜索的名称的页面。
搜索模板 返回一个显示搜索模板的页面。
发布模板 以 XML 格式返回发布模板的内容。

基于路径的 URL 语法规则

基于路径的 URL 需要一个对象库标识和一个包含路径名。mode=download 参数是可选参数。示例:

http://server/web_application/getContent/objectStoreID/pathName?mode=download

其中:
  • server 是 FileNet P8 客户机应用程序所在的应用程序引擎或 Workplace XT 服务器的名称。
  • web_application 是 FileNet P8 客户机应用程序的名称;例如 Workplace XT。
  • objectStoreID 是对象库标识,它可以是对象库的 GUID 或名称。对象库名称在单个域中是唯一的,但在 Active Directory 中不必唯一。使用名称来引用对象库时,将返回 Active Directory 中第一个匹配的对象库。如果 Active Directory 中可能存在同名的对象库,那么应该使用“@”字符来限定带有域名的对象库名称;例如,objectStoreName@domainName。
  • pathName 是包含路径名。
  • mode=download 参数(可选)允许您将内容保存在本地。
    注: 文档、已存储搜索、搜索模板和发布模板对象的基于路径的 URL 始终引用最新版本。

基于路径的 URL 示例

使用以下 URL 时,将显示具有指定搜索模板的 Workplace XT 页面。对象库由名称 (Forms) 进行标识:

http://server1/WorkplaceXT/getContent/Forms/Claims/Home?mode=download

使用以下 URL 时,对象库 Forms 由其域名 Midwest 进行限定:

http://server1/WorkplaceXT/getContent/Forms@midwest/Claims/Home?mode=download

基于标识的 URL 语法规则

基于标识的 URL 采用三个必需的查询字符串参数来表示文件夹对象:objectStoreName、objectType 和 id。例如:

http://server/web application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}

对于文档、已存储的搜索、搜索模板、发布模板和工作流程定义对象,该 URL 采用 objectStoreName、objectType、id 和 fsld 参数。mode=download 参数是可选参数。以下是一个示例:

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&mode=download

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&vsId={versionSeriesGUID}

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&vsId={versionSeriesGUID}&mode=download

其中:
  • server 是正在运行 FileNet P8 客户机应用程序的应用程序引擎或 Workplace XT 服务器的名称。
  • web_application 是 FileNet P8 客户机应用程序的名称。
  • objectStoreName=objectStoreGUID 是对象所在的对象库的 GUID。请用花括号将该 GUID 括起来。
  • objectType=type 是要检索的对象类型。请输入适用的 objectType 值:
    对于: objectType=
    文档 document
    文件夹 folder
    已存储的搜索 storedsearch
    搜索模板 searchtemplate
    工作流程定义 document
    发布模板 publishtemplate
  • id=objectGUID 是标识对象库中的对象的 GUID。它是表示文件夹对象的必需参数。对于文档、已存储的搜索、搜索模板、工作流程定义和发布模板对象,id 是可选参数,用于检索特定版本。请用花括号将该 GUID 括起来。
  • vsId=versionSeriesGUID 是用于检索下列对象的版本系列中最新版本的 GUID:文档、已存储的搜索、搜索模板、工作流程定义和发布模板。
    注: 当 id 和 vsld 都出现在 URL 中时,FileNet P8 客户机应用程序会使用 id 来检索指定的版本。如果找不到所指定的版本,那么 FileNet P8 客户机应用程序将报告错误并允许用户选择检索 vsld 参数指定的最新版本。
  • mode=download 参数是可选参数,允许您将内容保存在本地。
    注: 可以配置 FileNet P8 客户机应用程序,以将基于路径的 URL 用于文档请求。因此,如果您输入基于标识的 URL,那么 FileNet P8 客户机应用程序会尽可能将基于标识的 URL 转换为基于路径的 URL,以维护文档内容中嵌入的任何相对 URL 引用的完整性。


反馈

最近一次更新时间: 2013 年 3 月
aeadm_access_objects_via_url.htm

© Copyright IBM Corporation 2013.
本信息中心基于 Eclipse 技术。(http://www.eclipse.org)