内容重定向属性

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

内容重定向概述

content_redir.properties 由键/值对组成,其中键是 MIME 类型,值指定要用于打开相关联 MIME 类型的文件的组件。以下列表适用于图像查看器,在此处用作示例。可以将该示例应用于其他应用程序。在检查该列表时,请注意以下几点:

# Comment the lines with MIME types to not be opened by the Image Viewer applet
image/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.jsp
customobject=/integrationWebBasedCommand?_commandId=3010
showPropertiesCommand=/integrationWebBasedCommand?_commandId=3010
application/x-filenet-search=/WcmObjectBookmark.jsp
application/x-filenet-searchtemplate=/WcmObjectBookmark.jsp
application/x-filenet-workflowdefinition=/eprocess/WcmDesigner.jsp
application/x-filenet-scenariodefinition=/eprocess/WcmSimDesigner.jsp
...

getContent servlet 的缺省行为

如果未在 content_redir.properties 中指定某个 MIME 类型,那么应用程序将调用 getContent servlet。该 servlet 的行为由所选对象类型确定,如以下内容所示。

使用其他设置的交互

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

打开文档类型对象时,应用程序将检查 IgnoreRedirect 属性并执行下列操作:

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

打开 Image Services 中存储的图像时,应用程序将执行下列操作:

修改重定向属性文件

可以通过修改 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 服务器以便新设置生效。