IBM FileNet P8, V5.1.+            

内容重定向属性

当用户尝试从 Workplace XT 内部打开文件时,content_redir.properties 文件会配置到 Workplace XT Java Server Pages (JSP) 或 Servlet 的重定向,或者配置到定制或供应商应用程序的重定向。重定向基于内容 MIME 类型。本主题显示如何定制重定向。下节说明了应用程序如何使用 content_redir.properties。要定制重定向,请参阅修改重定向属性文件

内容重定向概述

content_redir.properties 由键/值对组成,其中键是 MIME 类型,值指定要用于打开相关联 MIME 类型的文件的组件。以下列表适用于 Image Viewer,在此处用作示例。可以将该示例应用于其他应用程序。在检查该列表时,请注意以下几点:
  • 第一组键/值对将 MIME 类型映射到 Image Viewer。要利用 Image Viewer 中的注释功能,可以编辑此文件以指定在 Image Viewer 中打开哪些图像类型。该列表显示由 Image Viewer 打开并且值是 /WcmJavaViewer.jsp?{QUERY_STRING} 的 MIME 类型。请参阅使用 Image Viewer以获取有关 Image Viewer 的更多信息。
  • content_redir.properties 中的键基于某些 Content Engine 类中定义的 mimeType 属性。请参阅关于 MIME 类型以了解更多信息。
  • 值可以包含宏,例如,{QUERY_STRING}content_redir.properties 中记录了可用的宏。
  • 如果 content_redir.properties 中未定义某个 MIME 类型,那么将调用 getContent servlet,并且该 servlet 将根据所选对象类型进行响应。请参阅下面的 getContent servlet 的缺省行为
  • 对于文档对象类型,重定向行为还将由某些设置另外进行定义,如果您修改 content_redir.properties,那么必须考虑这一因素。请参阅下面的使用其他设置的交互
# Comment the lines with MIME types to not be opened by the Image Viewer appletimage/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}image/jpg=/WcmJavaViewer.jsp?{QUERY_STRING}image/jpeg=/WcmJavaViewer.jsp?{QUERY_STRING}image/bmp=/WcmJavaViewer.jsp?{QUERY_STRING}image/tiff=/WcmJavaViewer.jsp?{QUERY_STRING}image/gif=/WcmJavaViewer.jsp?{QUERY_STRING}application/x-cold=/WcmJavaViewer.jsp?{QUERY_STRING}application/x-visio=/redirect/customAppRedirect.jsp?vsId={VERSION_SERIES_ID}&objectStoreName={OBJECT_STORE_NAME}&id={OBJECT_ID}&objectType=document

application/vnd.filenet.im-image=/WcmJavaViewer.jsp?{QUERY_STRING}application/vnd.filenet.im-cold=/WcmJavaViewer.jsp?{QUERY_STRING}application/vnd.filenet.im-form=/WcmJavaViewer.jsp?{QUERY_STRING}application/vnd.filenet.im-other=/WcmJavaViewer.jsp?{QUERY_STRING}folder=/WcmObjectBookmark.jspcustomobject=/integrationWebBasedCommand?_commandId=3010showPropertiesCommand=/integrationWebBasedCommand?_commandId=3010application/x-filenet-search=/WcmObjectBookmark.jspapplication/x-filenet-searchtemplate=/WcmObjectBookmark.jspapplication/x-filenet-workflowdefinition=/eprocess/WcmDesigner.jspapplication/x-filenet-scenariodefinition=/eprocess/WcmSimDesigner.jsp...

getContent servlet 的缺省行为

如果未在 content_redir.properties 中指定某个 MIME 类型,那么应用程序将调用 getContent servlet。该 servlet 的行为由所选对象类型确定,如以下内容所示。
文件夹
将客户机重定向到一个显示该文件夹的页面。
文档
如果文档具有内容,那么该内容将返回到浏览器。
如果文档具有外部引用,那么 servlet 将适当地重定向该客户机。
如果文档不具有内容,那么将报告错误。
工作流程定义文档
将客户机重定向到工作流程设计器。
已存储的搜索
将客户机重定向到一个显示该已存储搜索的页面。
搜索模板
将客户机重定向到一个显示该搜索模板的页面。
发布模板
将以 XML 格式返回发布模板的内容。

使用其他设置的交互

除了 content_redir.properties 文件设置以外,文档类型对象的一个隐藏的属性(它包括图像)也会影响重定向行为。缺省情况下,不会设置此隐藏的属性(称为“IgnoreRedirect”)。只能以编程方式或通过企业管理器来设置此属性。

打开文档类型对象时,应用程序将检查 IgnoreRedirect 属性并执行下列操作:
  • 如果 IgnoreRedirect 设置为 True,那么应用程序会将文档发送到浏览器。
  • 如果 IgnoreRedirect 设置为 False,那么应用程序会将文档发送到在 content_redir.properties 中指定的组件。
  • 如果未设置 IgnoreRedirect (NULL),那么应用程序会将文档发送到在 content_redir.properties 中指定的组件。

对于存储在外部库(例如,Image Services)中的文档,存在一个称为“包括重定向”的外部服务站点首选项。缺省情况下,会将此首选项设置为“是”。如果它设置为“是”,那么会将图像的 IgnoreRedirect 属性设置追加到 URL 中。请参阅外部服务首选项以获取有关此首选项的更多信息。

打开 Image Services 中存储的图像时,应用程序将执行下列操作:
  • 如果“包括重定向”设置为“是”,并且文档属性 IgnoreRedirect 设置为 true,那么应用程序会将图像发送到浏览器。
  • 如果“包括重定向”设置为“是”,并且文档属性 IgnoreRedirect 设置为 false,那么应用程序会将图像发送到 content_redir.properties 中指定的目标。
  • 如果“包括重定向”设置为“否”,那么 URL 中不包括 IgnoreRedirect 属性设置,并且应用程序会将图像发送到 content_redir.properties 中指定的目标。

修改重定向属性文件

可以通过修改 content_redir.properties 来定制重定向。例如,您可以添加到供应商应用程序的重定向,也可以注释掉现有重定向以允许 getContent servlet 处理已注释掉的 MIME 类型的对象。

注: 在修改 content_redir.properties 之前,请检查您要为其定义重定向的 MIME 类型的 IgnoreRedirect 属性和“包括重定向”站点首选项。

修改重定向属性文件

  1. 使用文本编辑器打开 content_redir.properties 缺省情况下,该文件安装在以下位置:
    Workplace XT:<install_location>/FileNet/Config/WebClient
  2. 根据需要修改属性。
    • 要除去现有 MIME 类型映射,请使用前导 # 符号注释掉适用的键/值对;例如,#image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
    • 要添加 MIME 类型映射,请输入键/值对,并使用与 Content Engine 类中定义的 mimeType 属性值对应的键。值必须指定应用程序中 JSP 页面或 servlet 的相对于应用程序目录的路径。

      通过使用宏,可以将所选对象的 URL 查询字符串传递到键/值对中指定的组件。例如,可以包含 {QUERY_STRING} 宏以传递整个查询字符串。或者,可以使用 {OBJECT_TYPE}{OBJECT_ID} 和其他宏来传递查询字符串中的各个参数。请参阅 content_redir.properties 文件以获取完整的宏列表。

    • 要将 MIME 类型映射到供应商或定制应用程序,必须指定该应用程序中重定向到外部应用程序的组件。例如,在以下 Workplace 键/值对中,如果用户选择了 MIME 类型为“text/x-speech”的文件,那么 Workplace 将重定向到 Workplace/redirect/customAppRedirect.jsp
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      要重定向到外部应用程序,JSP 重定向代码可以像以下行一样简单。
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      但是一般来说,到外部应用程序的重定向逻辑应用更为广泛,以便与 Workplace XT 相同的基本 API 返回外部应用程序所需要的 URL、参数、安全性令牌和任何其他值。

  3. 保存 content_redir.properties
  4. 重新启动 Web 服务器以便新设置生效。


反馈

最近一次更新时间: 2011 年 7 月


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