文件瀏覽器

「文件瀏覽器」視圖會顯示所參照 ECM 資料夾中的文件，以及程序實例之資料夾結構中的文件。如果使用者已獲授權，則他們可以搜尋、建立、刪除及重新命名資料夾。他們也可以上傳、檢視、移出及移除文件。

您可以配置「文件瀏覽器」Coach 視圖來新增、檢視或刪除個別資料夾，以及新增、檢視、移出、下載及移除文件。「文件瀏覽器」使用服務來執行這些功能。

當使用者開啟包含「文件瀏覽器」實例的 Coach 時，該實例會顯示其根資料夾的內容，如配置選項所指定。此根資料夾命名為 Documents。不過，當您瀏覽它的其中一個子資料夾時，「文件瀏覽器」會在瀏覽途徑軌跡中顯示此名稱。「文件瀏覽器」實例的根資料夾是該實例特有的。不同的實例可以有不同的根資料夾，而且它們可以在內容管理系統中的任何位置。「文件瀏覽器」的根資料夾以下列其中一種方式來決定:

透過使用資料夾 ID 配置選項識別特定資料夾直接指定。如果資料夾不在預設內容管理伺服器上，則伺服器名稱配置選項會識別包含該資料夾的伺服器。
衍生自識別實例 ID ，其在內容管理系統中具有相關聯的資料夾及伺服器。
衍生自人工服務環境定義，其在內容管理系統中具有相關聯的資料夾。

例如，配置「文件瀏覽器」:

若要配置 ECM 伺服器，請參閱新增 Enterprise Content Management (ECM) 伺服器。
將「文件瀏覽器」元件拖曳至 Coach。
選取元件。
按一下配置，選取內容管理進階。若要配置內容，請參閱配置內容及說明:
- 伺服器名稱: 輸入您剛才新增的 ECM 伺服器名稱。
- 資料夾 ID: 取得您要從 ACCE 管理的 ECM 資料夾 ID。
儲存之後，您可以從頁面存取及管理目錄中的文件。

決定根資料夾有優先順序。資料夾 ID 中的值會置換實例 ID 中的任何值。實例 ID 中的任何值都會置換人工服務環境定義的使用，以衍生根資料夾。

根資料夾包含資料夾和文件 (檔案及其相關聯的內容)。任何個別使用者在「文件瀏覽器」中看到的實際內容，以及該使用者可以對內容執行的動作，取決於使用者在內容管理系統中具有的許可權。假設他們具有適當的許可權，使用者可以新增資料夾和文件。從資料夾或文件的動作功能表中，使用者可以選取要對該資料夾或文件執行的動作。

表 1. 資料夾動作
動作	說明
開放式	顯示資料夾的內容。「文件瀏覽器」會新增瀏覽途徑軌跡，讓使用者可以回到上層資料夾。
重新命名	重新命名資料夾。
刪除或移除	從 ECM 伺服器中刪除資料夾或參照。「移除」選項只會從「文件瀏覽器」中刪除參照。參照會保留在 ECM 伺服器上。

表 2. 文件操作
動作	說明
檢視	在瀏覽器中顯示文件的內容，如果瀏覽器不支援檔案格式，則會下載文件。
下載	下載文件。
屬性	顯示與文件相關聯的內容。文件類型會作為範本來決定指定文件的內容。
移出	鎖定檔案。移出檔案之後，您可以移入其不同版本或變更其內容。
移入或取消移入	解除鎖定檔案。使用移入動作來取代檔案內容並更新其內容。這些動作僅適用於已鎖定的檔案。
刪除	從資料夾移除文件。文件仍存在於內容管理系統中。

與 Enterprise Content Management 伺服器整合

若要將「文件瀏覽器」視圖與 Enterprise Content Management (ECM) 伺服器整合，程序應用程式必須具有與該伺服器的連線。請參閱新增 Enterprise Content Management (ECM) 伺服器。如需建置 ECM 服務的相關資訊，請參閱建置與 ECM 系統或 BPM 儲存庫整合的服務。如需相關資訊，請參閱啟用文件支援下的主題。

限制

此視圖僅支援 Required、 Hidden及 None 可見性內容。

資料連結

在一般內容標籤中設定視圖的資料連結。

表 3. 文件瀏覽器資料連結
說明	資料類型
每一個 `ECMDocumentInfo` 連結都包含文件的 URL。	`ECMDocumentInfo (List)`

配置內容

在配置內容標籤中設定或修改視圖的配置內容，例如行為和外觀內容。

螢幕大小: 在內容名稱旁具有「畫面大小」圖示的配置內容，每一個畫面大小可以有不同的值。如果您未設定值，則畫面大小會繼承下一個較大畫面大小的值作為其預設值。

下表顯示「文件瀏覽器」視圖的內容管理配置內容:

表 4. 文件瀏覽器的內容管理內容
內容管理內容	說明	資料類型
前次更新的文件 ID	已建立或更新之文件的文件 ID。	`ECMID`
預設 ECM 文件內容	要使用此文件上傳的相符內容。	`ECMDefaultProperty[]`
新增 BPM 內容	依預設，不會將這些內容新增至新的 BPM 文件。啟用此配置選項會新增在上傳 BPM 內容配置選項中定義的內容。如果要控制何時將這些內容新增至文件，請將此配置選項連結至變數。	`Boolean`
上傳 BPM 內容	如果您選取新增 BPM 內容，則這些是您要與文件相關聯的內容。	`NameValuePair[]`
在入口網站中隱藏	防止在 Process Portal中顯示文件。	`Boolean`

下表顯示「文件瀏覽器」視圖的內容管理進階配置內容:

表 5. 文件瀏覽器的內容管理進階內容
內容管理進階內容	說明	資料類型
實例 ID	顯示實例 ID 的文件及資料夾清單。如果已配置資料夾 ID 內容，則會忽略實例 ID 配置。如果既未配置資料夾 ID ，也未配置實例 ID 內容，則資料夾 ID 衍生自人工服務環境定義。對於用戶端人工服務， tw.system.processInstance.id 和 tw.system.processInstance.processInstanceFolderId 內容用於環境定義。對於繼承人工服務， tw.system.currentProcessInstance.id 和 tw.system.currentProcessInstance.processInstanceFolderId 內容用於環境定義。	`String`
伺服器名稱	如果已配置資料夾 ID ，請使用外部 ECM 伺服器的名稱。在此欄位中可以鍵入伺服器名稱。您亦可使用代表伺服器名稱的變數，並將該變數新增至此欄位。如需外部 ECM 伺服器名稱，請檢查可用的外部 ECM 系統的「Process App 設定」頁面。如果您使用內部 ECM 內容儲存庫- BPM 受管理儲存庫、 BPM 內容儲存庫或 BPM 文件儲存庫 -它們可以使用常數。例如， ECMServerNames。IBM_BPM_MANAGED_STORE。	`String`
資料夾 ID	顯示資料夾 ID 的文件及資料夾清單。如果已配置此內容，則會忽略實例 ID。如果未配置資料夾 ID 內容，則資料夾 ID 衍生自相關聯的實例 ID 配置。如果未指定實例 ID，則會從人工服務環境定義衍生資料夾 ID。對於用戶端人工服務， tw.system.processInstance.id 和 tw.system.processInstance.processInstanceFolderId 內容用於環境定義。對於繼承人工服務， tw.system.currentProcessInstance.id 和 tw.system.currentProcessInstance.processInstanceFolderId 內容用於環境定義。	`String`
顯示母項案例資料夾	顯示母項案例實例的內容。這個選項僅適用於案例解決方案中透過 Case Builder 建立的程序實例。當選取這個選項時，會忽略伺服器名稱、實例 ID 和資料夾 ID 欄位。	`Boolean`

下表顯示「文件瀏覽器」視圖的行為配置內容:

表 6. 文件瀏覽器的行為配置內容
行為配置內容	說明	資料類型
顯示標底	顯示標底。	`Boolean`
顯示表格統計資料	顯示表格統計資料，例如「顯示 59 個項目中的 1 至 5 個」。	`Boolean`
顯示分頁器	顯示分頁器。	`Boolean`
起始頁面大小	每頁要顯示的起始項目數上限。	`Integer`
刪除時確認	在刪除檔案之前顯示確認對話框。	`Boolean`
使用文件檢視器	當選取檢視功能表項目時，在行內文件檢視器中開啟文件。如果未啟用此選項，將在新視窗中開啟文件。	`Boolean`
可收合	「文件瀏覽器」視圖是可收合的。	`Boolean`
最初已收合	當視圖開啟時，會收合「文件瀏覽器」視圖。	`Boolean`
重新整理觸發程式	指出是否可以重新整理視圖的內容。將此內容連結至專用布林變數。當連結變數的值變更為 true 時，會重新整理視圖。重新整理視圖之後，變數值會回到 false。	`Boolean`
ECM 取得相關的資料夾服務	取得「程序應用程式設定」頁面中所列出 ECM 伺服器的資料夾資訊。	`Default Get Related ECM Folders Service`
實例狀態	決定「文件瀏覽器」是可編輯還是唯讀。 ACTIVE 實例可編輯。含有不同狀態值（COMPLETED、FAILED、TERMINATED 及 SUSPENDED）的實例為唯讀。	`String`
隱藏文件瀏覽器	隱藏「文件瀏覽器」視圖。例如，針對商業程序定義 (BPD)。	`Boolean`
檢視已按一下的文件	選取此選項，以在您按一下文件名稱時啟用文件的預設檢視器。	`Boolean`
在自訂視圖上啟用	當選取「檢視」功能表動作時，啟用「在自訂視圖上」事件中執行自訂 Script。	`Boolean`
使用文件檢視器	選取此選項，以在選取檢視功能表動作時，在行內文件檢視器中開啟文件。當清除此選項時，文件會在新視窗中開啟。	`Boolean`

下表顯示「文件瀏覽器」視圖的外觀配置內容:

表 7. 「文件瀏覽器」的外觀配置內容
外觀配置內容	說明	資料類型
表格樣式	此視圖的表格樣式。	`String`
顏色樣式	此視圖的顏色樣式。	`String`
寬度	視圖的寬度。您可以指定以 px (像素)、% (百分比) 或 em 為單位的寬度。例如， 50px、20% 或 0.4em。如果未指定單元類型，則會採用 px。	`String`
高度	視圖的高度 (以 px (像素) 或 em 為單位)。如果未指定任何單元類型，則會採用 px。	`String`
直欄	要在清單中顯示的直欄。	`FileListColumn[]`
視圖樣式	視圖的樣式（預設、現代）。
顯示直欄標頭	選取此選項以啟用檢視「預設」視圖樣式的直欄標頭。在「現代」視圖樣式中，這個選項會在執行時期自動啟用。	`Boolean`

事件

在事件內容中設定或修改視圖的事件處理程式。您可以將事件設為以程式化方式觸發，或在使用者與視圖互動時觸發。如需如何定義及編碼事件的相關資訊，請參閱使用者定義事件。「文件瀏覽器」視圖具有下列類型的事件處理程式:

On load: 在載入視圖時啟動。例如，
```
me.getRecordCount();
```
On document clicked: 按一下檔案時啟動。例如，
```
console.log(doc.fileName)
```
On folder clicked: 按一下資料夾時啟動。例如，
```
console.log("Folder clicked: "+folder.name)
```
On delete: 在刪除文件或資料夾時啟動。例如，
```
console.log("Object is deleted: "+record.name)
```
On refreshed: 在重新整理視圖時啟動。例如，
```
console.log("List refreshed")
```

On error: 在視圖中執行作業時發生錯誤時啟動。例如，

console.log("There has been an error with the operation : "+error.action)

On folder rename: 重新命名資料夾時啟動。例如，
```
console.log("Folder Renamed: "+folder.name);
```
On remove from folder: 從 BPM 資料夾移除 ECM 資料夾或文件參照時啟動。例如，
```
console.log("Object removed from BPM : "+record.name)
```
On document upload complete: 在上傳文件時啟動。例如，
```
console.log("Uploaded document ID : "+documentId)
```
On reference created: 建立外部資料夾或文件的參照時啟動。例如，
```
console.log("Reference created : "+reference.referenceName)
```
On custom view: 按一下文件或按一下文件上的「檢視」功能表選項時啟動。啟用自訂作業，以使用自訂 Script 在自訂文件檢視器中檢視文件。當選取「在自訂視圖事件上啟用」及「檢視按一下的文件」配置選項時，會啟用此事件。其他參數 :doc。例如，
```
// This would open the document in Navigator viewer only for Case Client.
var docObject = {};
if(doc.id.includes("idd_")){
  docObject.id = doc.id.split("_")[1];
}
docObject.caseAction = "documentClicked";
this.context.broadcastMessage(docObject);
```

視事件而定，您可以使用 JavaScript 邏輯來修改視圖的效果。如需將事件與視圖搭配使用的相關資訊，請參閱使用者定義事件。

方法

如需「文件瀏覽器」可用方法的詳細資訊，請參閱文件瀏覽器 JavaScript API。

其他資源

如需如何建立 Coach 或頁面的相關資訊，請參閱建置 Coach。
如需標準內容 (一般、配置、定位、可見性及 HTML 屬性) 的相關資訊，請參閱檢視內容。
如需其他使用者介面及內容管理視圖的相關資訊，請參閱使用者介面工具箱及內容管理工具箱。