透過 WOPI 在 Collabora CODE 中匯出區塊文件

若要封鎖使用者匯出 Collabora Online CODE 中開啟的文檔，請讓您的 WOPI 主機"DisableExport": true在該文檔的CheckFileInfo回應中傳回對應資訊。 Collabora 的整合文件將其描述為停用匯出功能；啟用此功能後，「下載為」功能表選項也會被隱藏。HideExportOption單獨使用此方法只會變更介面，因此並非禁止匯出的正確控制方式。請參閱 Collabora 的擴充 CheckFileInfo 回應屬性。

請使用 WOPI 權限，而不是僅限選單的設定。

CODE 是 WOPI 整合中的編輯元件。您的儲存或應用程式服務可作為 WOPI 主機，並在 Collabora 開啟文件時提供每個文件的資訊。因此，主機是決定特定使用者是否可以匯出特定檔案的合適位置。

在主機CheckFileInfo端點傳回的 JSON 物件中，包含布林屬性：

{
  "BaseFileName": "quarterly-plan.docx",
  "Size": 24576,
  "UserCanWrite": true,
  "DisableExport": true
}

這是一個範例片段，並非完整的 CheckFileInfo 回應。請保留其他必填欄位以及主機已傳回的任何現有整合屬性。鍵值必須是 JSON 布林值，而不是文字字串"true"。請使用應用程式對文件和當前使用者使用的相同授權決策來設定它。

例如，某個組織可能允許員工編輯機密預算工作簿，但禁止他們使用 Collabora 的匯出功能。當 WOPI 主機為員工開啟該工作簿時，它會傳回 false DisableExport: true。對於公共模板或普通文檔，主機可以false根據其策略返回 false。只有當每個使用者和文件都應受到相同的限制時，才適合為每個文件套用靜態值。

更新提供該文件的 WOPI 主機

1. 確定整合端點。找到回應 Collabora WOPICheckFileInfo檔案請求的主機路由。在 Nextcloud、ownCloud 或其他儲存產品中，這通常意味著更改產生回應的整合或策略層；編輯 Collabora 容器的全域設定並不能取代主機對每個檔案的權限設定。
2. 在正確的範圍內套用規則。可以從已認證使用者、檔案分類、共用權限或應用程式中的其他規則中取得值。對於簡單的全用戶策略，對每個相關文件都傳回 true。避免依賴瀏覽器端選單首選項或用戶端提供的值。
3. 在 CheckFileInfo 中傳回布林值。確保回應為有效的 JSON，並且包含 Collabora 收到的回應中的屬性。代碼級策略變更可能需要部署或重新啟動 WOPI 主機應用程序，具體取決於其框架；如果主機動態提供該字段，則代碼本身可能不需要配置變更。
4. 重新開啟文件。關閉目前編輯器會話，然後使用受影響的帳戶再次開啟檔案。 CheckFileInfo 會在文件開啟流程中查詢，因此已開啟的會話可能無法反映權限變更。

具體的文件、類別、設定或管理介面會因 WOPI 主機和產品版本而異。 Collabora 的文檔定義了該字段，但並未提供通用的 Nextcloud 或第三方應用程式設定。如果您的主機未公開下載限制，請查閱該產品的最新管理文檔，或在其支援的 WOPI 回應路徑中實施該策略。

何時應該設定 HideExportOption？

設定HideExportOption此選項true可在您希望隱藏「下載」控制項但又不強制執行匯出禁令時生效。如需實際限制，建議使用其他設定DisableExport: true；Collabora 的整合指南指出，此設定也意味著選單隱藏行為。在整合中，將兩個欄位都設為 true 可以明確表達意圖，但對於文件中描述的行為而言，這並非必要。

請勿將此與.extra_export_formats中的條目混淆coolwsd.xml。 Collabora 目前的設定範本明確指出，停用這些可選格式只會隱藏它們的視覺效果，並不會停用伺服器端匯出。這些選項控制的是提供哪些額外的格式，而不是使用者是否有權匯出文件。在變更全域設定之前，請先查看目前的Collabora Online 設定範本。

這項限制保護的是什麼，以及它不保護的是什麼。

DisableExport此設定適用於 Collabora 會話的匯出功能。當使用者需要在瀏覽器中編輯文件，但不希望使用編輯器的匯出或下載功能時，此設定非常有用。它本身並不會移除使用者對儲存服務中原始檔案的存取權限。如果主機仍允許使用者從其他位置下載來源文件，則 Collabora 的此設定不會關閉該下載路徑。

同樣，能夠查看內容的用戶可能可以手動複製資訊、截圖或使用您的策略允許的其他應用程式功能。請勿將此設定描述為阻止所有資料外洩或保證內容無法複製。要限制對原始內容的訪問，還應在 WOPI 主機和儲存應用程式中強制執行下載和共用規則。如果您要求使用者完全無法查看內容，請拒絕文件存取權限，而不是依賴匯出標誌。

隱藏介面項目和停用操作之間也存在差異。 Collabora 的配置範本在其可選的匯出格式設定中區分了這兩者，而 WOPI 回應欄位則是整合層級的限制。前者有助於簡化選單；後者旨在阻止透過 Collabora 匯出文件。如果現有整合的行為有所不同，請驗證其 Collabora 版本並檢查實際的 CheckFileInfo 回應，而不是假設某個特定的主機產品會將其自身的「停用下載」複選框對應到這兩個欄位。

使用測試帳戶驗證限制。

1. 使用符合限制策略的非管理員帳戶，並在新會話中開啟測試文件。
2. 確認編輯器中的「下載為」選項已不再可用。如果仍然可用，請檢查針對該使用者和檔案產生的 CheckFileInfo 回應；確認該欄位為布林值，true並且正在提供新的回應。
3. 透過 Collabora 的常規介面測試導出操作。主機策略應反映在編輯器行為上。不要因為選單項目被隱藏就斷定該控制已生效。
4. 單獨檢查儲存應用程式：僅當測試計劃允許時才嘗試其自身的下載路徑。如果下載成功，則表示即使 Collabora 阻止匯出，來源檔案存取策略仍然允許下載。
5. 以具有匯出權限的使用者身分開啟文檔，並確認您的主機返回了該情況下的預期權限。這可以發現因錯誤而全域應用的規則。

如需實作細節，請參考 Collabora 的WOPI 整合參考文件和專案配置範本。 CODE 支援的行為可能會因版本和主機整合而異，因此請在您部署的版本上驗證回應和結果。本文並未聲明已測試特定主機版本或範例部署。