IBM FileNet P8, 5.2 版            

透過 URL 存取物件

URL 定址能力特性可讓使用者直接存取物件,而不需導覽整個 IBM® FileNet® P8 用戶端使用者介面。登入 FileNet P8 用戶端之後(如 Workplace XT),使用者只要在瀏覽器的位址列中輸入物件的 URL 即可。(管理者可以建立書籤或我的最愛,來擷取資料夾或可版本化的物件。)

利用 URL 定址能力,您可以:
  • 擷取文件、資料夾、已儲存搜尋、搜尋範本、工作流程定義和發佈範本。
  • 下載下列物件類型,並將它們儲存在本端個人電腦上:文件、已儲存搜尋、搜尋範本、發佈範本和工作流程定義。
  • 輸入路徑型或 ID 型 URL,如下所示。
路徑型 URL 會使用包含路徑來指定物件儲存庫中物件的位置。 例如,如果要擷取名稱為 Current® Works 的文件(其位於 Transportation 物件儲存庫的 Projects 資料夾中),使用者輸入的 URL 會類似下例:

http://P8_client_server_name/application_name:port/getContent/Transportation/Projects/Current+Works

如果要利用路徑型 URL 來擷取物件,您必須設定使用路徑型 URL 網站喜好設定。

ID 型 URL 會使用 GUID 來指定物件儲存庫中物件的位置。 文件的位置是由文件所在之物件儲存庫的 GUID 以及文件的 GUID 來指定。例如,如果要擷取文件,使用者輸入的 URL 會類似下例:

http://P8_client_server_name/application_name:port/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}

ID 型位址通常會比路徑型位址快;不過,只有路徑型 URL 會解析文件內的相對參照。例如,如果您以路徑型 URL 來要求 "example.html" 檔,就會擷取該檔案,且瀏覽器會解析 example.html 中所需的任何其他 URL(如:<script>、<img> 和 <link> 標籤)。當使用者按一下任何鏈結 (<a href=...>) 時,瀏覽器也會解析這些鏈結。

下表列出您可以在 URL 中指定之不同物件類型的預設回應。
物件類型 回應
資料夾 傳回顯示資料夾名稱的頁面。
文件 如果文件有內容,則會傳回內容。如果文件有外部參照,FileNet P8 用戶端會依需求將用戶端重新導向。 如果文件沒有內容,FileNet P8 用戶端會報告錯誤。
工作流程定義 開啟「處理程序設計者」Applet。
已儲存的搜尋 傳回顯示已儲存搜尋的名稱的頁面。
搜尋範本 傳回顯示搜尋範本的頁面。
發佈範本 以 XML 形式傳回發佈範本的內容。

路徑型 URL 語法規則

路徑型 URL 需要有物件儲存庫 ID 和包含路徑名稱。 mode=download 參數是選用的。範例:

http://server/web_application/getContent/objectStoreID/pathName?mode=download

其中:
  • server 是 FileNet P8 用戶端應用程式所在之「應用程式引擎」或 Workplace XT 伺服器的名稱。
  • web_application 是 FileNet P8 用戶端應用程式的名稱;例如,Workplace XT。
  • objectStoreID 是物件儲存庫 ID,其可以是物件儲存庫的 GUID 或名稱。物件儲存庫名稱在單一網域內是唯一的,但不一定在 Active Directory 內。當使用此名稱來參照物件儲存庫時,會傳回 Active Directory 內第一個相符的物件儲存庫。如果 Active Directory 中可能有同名的物件儲存庫,您應該使用 "@" 字元,以網域名稱來限定物件儲存庫名稱;例如:objectStoreName@domainName。
  • pathName 是包含路徑名稱。
  • mode=download 參數(選用)可讓您在本端環境下儲存內容。
    註: 文件、已儲存搜尋、搜尋範本和發佈範本物件的路徑型 URL,一律會參照最新的版本。

範例路徑型 URL

利用這個 URL,會顯示具有指定搜尋範本的 Workplace XT 頁面。物件儲存庫是由名稱 (Forms) 來識別:

http://server1/WorkplaceXT/getContent/Forms/Claims/Home?mode=download

利用這個 URL,物件儲存庫 Forms 是由其網域名稱 Midwest 來限定:

http://server1/WorkplaceXT/getContent/Forms@midwest/Claims/Home?mode=download

ID 型 URL 語法規則

ID 型 URL 採用三個必要的資料夾物件查詢字串參數:objectStoreName、objectType 和 id。例如:

http://server/web application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}

如果是文件、已儲存搜尋、搜尋範本、發佈範本和工作流程定義物件,URL 會使用 objectStoreName、objectType、id 和 fsld 參數。mode=download 參數是選用的。範例如下:

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&mode=download

或者,

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&vsId={versionSeriesGUID}

或者,

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&vsId={versionSeriesGUID}&mode=download

其中:
  • server 是執行 FileNet P8 用戶端應用程式之「應用程式引擎」或 Workplace XT 伺服器的名稱。
  • web_application 是 FileNet P8 用戶端應用程式的名稱。
  • objectStoreName=objectStoreGUID 是物件所在之物件儲存庫的 GUID。請併入大括弧。
  • objectType=type 是要擷取的物件類型。請輸入適用的 objectType 值:
    如果是: objectType=
    文件 文件
    資料夾 資料夾
    已儲存的搜尋 storedsearch
    搜尋範本 searchtemplate
    工作流程定義 文件
    發佈範本 publishtemplate
  • id=objectGUID 是識別物件儲存庫中物件的 GUID。 這是資料夾物件的必要參數。如果是文件、已儲存搜尋、搜尋範本、工作流程定義和發佈範本物件,id 是選用的,且是用來擷取特定的版本。請併入大括弧。
  • vsId=versionSeriesGUID 是 GUID,用來擷取下列物件之版本系列內的最新版本:文件、已儲存搜尋、搜尋範本、工作流程定義和發佈範本。
    註: 如果 ID 和 vsld 都存在於 URL 中,FileNet P8 用戶端應用程式會使用 ID 來擷取指定的版本。如果找不到指定的版本,FileNet P8 用戶端應用程式會報告錯誤,並可讓使用者選擇擷取 vsld 參數所指定的最新版本。
  • mode=download 參數是選用的,可讓您在本端環境下儲存內容。
    註: 您可以配置 FileNet P8 用戶端應用程式,針對文件要求使用路徑型 URL。因此,如果您輸入 ID 型 URL,可能的話,FileNet P8 用戶端應用程式會將 ID 型 URL 轉換成路徑型 URL,以便維持內嵌在文件內容的任何相對 URL 參照的完整性。


意見

前次更新: 2013 年 3 月
aeadm_access_objects_via_url.htm

© Copyright IBM Corp. 2013.
這個資訊中心採用 Eclipse 技術。(http://www.eclipse.org)