URL 可寻址性功能使用户能够直接访问对象,而不必浏览整个 IBM FileNet P8 客户机用户界面。在登录 FileNet P8 客户机(例如,Workplace XT)后,用户只需在浏览器的地址栏中输入对象的 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 需要一个对象库标识和一个包含路径名。mode=download 参数是可选参数。示例:
http://server/web_application/getContent/objectStoreID/pathName?mode=download
其中:
注意:文档、已存储搜索、搜索模板和发布模板对象的基于路径的 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 采用三个必需的查询字符串参数来表示文件夹对象: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
其中:
对于: | objectType= |
---|---|
文档 | document |
文件夹 | folder |
已存储的搜索 | storedsearch |
搜索模板 | searchtemplate |
工作流程定义 | document |
发布模板 | publishtemplate |
注意:当 ID 和 vsld 都存在于 URL 中时,FileNet P8 客户机应用程序会使用 ID 来检索指定的版本。如果找不到指定的版本,那么 FileNet P8 客户机应用程序将报告错误并允许用户选择检索 vsld 参数指定的最新版本。
注意:可以配置 FileNet P8 客户机应用程序,以将基于路径的 URL 用于文档请求。因此,如果您输入基于标识的 URL,那么 FileNet P8 客户机应用程序会尽可能将基于标识的 URL 转换为基于路径的 URL,以维护文档内容中嵌入的任何相对 URL 引用的完整性。