content_redir.properties 檔會配置重新導向至 Workplace XT Java™ Server Pages (JSP) 或 Servlet,或是重新導向到自訂或供應商應用程式(當使用者試圖從 Workplace XT 內開啟檔案時)。重新導向是根據內容 MIME 類型。本主題顯示如何自訂重新導向。下一節說明應用程式如何使用 content_redir.properties。如果要自訂重新導向,請參閱修改重新導向內容檔。
content_redir.properties 包含鍵值組,其中的鍵是 MIME 類型,值指定用來開啟關聯 MIME 類型檔案的元件。下列清單是針對 Image Viewer,這裡使用它來作為範例。此範例可套用至其他應用程式。在檢查清單時,請注意下列幾點:
/WcmJavaViewer.jsp?{QUERY_STRING}
值的那些類型。如需 Image Viewer 的相關資訊,請參閱使用 Image Viewer。{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
...
如果 MIME 類型未指定在 content_redir.properties 中,應用程式會呼叫 getContent Servlet。Servlet 的行為由選取的物件類型決定,如下所列。
除了 content_redir.properties 檔的設定之外,文件類型物件(包括影像在內)還有一項隱藏內容會影響重新導向行為。此隱藏內容稱為 "IgnoreRedirect",依預設不會設定它。您只能以程式設計方式或透過 Enterprise Manager 設定它。
開啟文件類型物件時,應用程式會查看 IgnoreRedirect 內容並執行下列動作:
對於儲存在外部程式庫中的文件,例如 Image Services,有一項稱為「併入重新導向」的外部服務網站喜好設定。依預設,這項喜好設定是設定為「是」。如果它設定為「是」,則 URL 後面將附加影像的 IgnoreRedirect 內容設定。如需這項喜好設定的相關資訊,請參閱外部網站喜好設定。
開啟儲存在 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、參數、安全記號和外部應用程式所需要的任何其他值。