当用户尝试从 Workplace XT 内部打开文件时,content_redir.properties 文件会配置到 Workplace XT Java™ Server Pages (JSP) 或 servlet 的重定向,或者配置到定制或供应商应用程序的重定向。重定向基于内容 MIME 类型。本主题显示如何定制重定向。下节说明了应用程序如何使用 content_redir.properties。要定制重定向,请参阅修改重定向属性文件。
content_redir.properties 由键/值对组成,其中键是 MIME 类型,值指定要用于打开相关联 MIME 类型的文件的组件。以下列表适用于图像查看器,在此处用作示例。可以将该示例应用于其他应用程序。在检查该列表时,请注意以下几点:
/WcmJavaViewer.jsp?{QUERY_STRING}
的 MIME 类型。请参阅使用图像查看器以了解关于图像查看器的更多信息。{QUERY_STRING}
。content_redir.properties
中记录了可用的宏。
# 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
...
如果未在 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 属性和“包括重定向”站点首选项。
修改重定向属性文件
#
符号注释掉适用的键/值对;例如,#image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
。通过使用宏,可以将所选对象的 URL 查询字符串传递到键/值对中指定的组件。例如,可以包含 {QUERY_STRING}
宏以传递整个查询字符串。或者,可以使用 {OBJECT_TYPE}
、{OBJECT_ID}
和其他宏来传递查询字符串中的各个参数。请参阅 content_redir.properties 文件以获取完整的宏列表。
text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
要重定向到外部应用程序,JSP 重定向代码可以像以下行一样简单。
<%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>
但是一般来说,到外部应用程序的重定向逻辑应用更为广泛,以便与 Workplace XT 相同的基本 API 返回外部应用程序所需要的 URL、参数、安全性令牌和任何其他值。