IBM FileNet P8, 5.1.+ 版            

內容重新導向內容

content_redir.properties 檔配置為當使用者試圖從 Workplace XT 內開啟檔案時,會重新導向至 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 開啟的 MIME 類型,即含有 /WcmJavaViewer.jsp?{QUERY_STRING} 值的那些類型。如需 Image Viewer 的相關資訊,請參閱使用 Image Viewer
  • content_redir.properties 中的鍵是根據特定 Content Engine 類別中定義的 mimeType 內容。如需相關資訊,請參閱關於 MIME 類型
  • 值可包含巨集,例如 {QUERY_STRING}。可用的巨集記載於 content_redir.properties 中。
  • 如果 MIME 類型未定義在 content_redir.properties 中,會呼叫 getContent 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 的預設行為

如果 MIME 類型未指定在 content_redir.properties 中,應用程式會呼叫 getContent Servlet。Servlet 的行為由選取的物件類型決定,如下所列。
資料夾
將用戶端重新導向至顯示該資料夾的頁面。
文件
如果文件含有內容,則會將內容傳回瀏覽器。
如果文件含有外部參照,Servlet 會將用戶端適當地重新導向。
如果文件不含內容,則會報告錯誤。
工作流程定義文件
將用戶端重新導向至工作流程設計程式。
已儲存的搜尋
將用戶端重新導向至顯示已儲存搜尋的頁面。
搜尋範本
將用戶端重新導向至顯示搜尋範本的頁面。
發佈範本
發佈範本的內容會以 XML 傳回。

與其他設定的互動

除了 content_redir.properties 檔的設定之外,文件類型物件(包括影像在內)還有一項隱藏內容會影響重新導向行為。依預設,不會設定這個名為 "IgnoreRedirect" 的隱藏內容。您只能以程式設計方式或透過 Enterprise Manager 設定它。

開啟文件類型物件時,應用程式會查看 IgnoreRedirect 內容並執行下列動作:
  • 如果 IgnoreRedirect 設為 True,它會將文件傳送至瀏覽器。
  • 如果 IgnoreRedirect 設為 False,它會將文件傳送至 content_redir.properties 指定的元件。
  • 如果未設定 IgnoreRedirect(空值),它會將文件傳送至 content_redir.properties 指定的元件。

對於儲存在外部程式庫中的文件,例如 Image Services,有一項稱為「併入重新導向」的外部服務網站喜好設定。依預設,這項喜好設定設為「是」。如果設為「是」,則 URL 後面將附加影像上的 IgnoreRedirect 內容設定。如需這項喜好設定的相關資訊,請參閱外部服務喜好設定

開啟儲存在 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 Corp. 2011.
這個資訊中心採用 Eclipse 技術。(http://www.eclipse.org)