ONLYOFFICE Docs 如何与 Alfresco 连接集成
ONLYOFFICE Docs 如何與 Alfresco 連接集成
- 關于 ONLYOFFICE 和 Alfresco 的集成
- 主要功能特征
- 支持的格式
- 6.0.0 版新特性
- ONLYOFFICE Docs 與 Alfresco 連接集成
- 需求依賴項
- 安裝 ONLYOFFICE 和 Alfresco Module 包
- 配置 ONLYOFFICE 和 Alfresco Module 包
- 為 ONLYOFFICE 和 Alfresco 的連接開啟 JWT 功能
- 連接示例 ONLYOFFICE Docs
- 開始使用 ONLYOFFICE Docs 與 Alfresco 的集成功能
關于 ONLYOFFICE 和 Alfresco 的集成
ONLYOFFICE 提供一個官方的連接器,可以把 ONLYOFFICE Docs 和 Alfresco 連接集成起來,在文檔庫中創建、編輯以及轉換辦公文檔。你可以從官方Alfresco 插件庫[1]或ONLYOFFICE 的 GitHub 頁面[2]下載。
注解:關于 ONLYOFICE 和 Alfresco 連接集成的底層工作原理細節請參考API 文檔[3]
主要功能特征
-
創建、編輯、查看文檔、表格和幻燈片
-
轉換文件格式
-
實時協作處理文檔:兩種協作模式,快速模式和嚴格模式,跟蹤文檔變化、批注、內建聊天功能
-
JWT 支持,加密通信,賦予訪問權限的用戶之外,禁止任何其他人訪問文檔。
支持的格式
-
創建、編輯和閱覽功能支持的格式:DOCX、PPTX、XLSX
-
處理表單的格式:OFORM、DOCXF
-
格式轉換支持的格式:ODT、ODP、ODS、DOC、XLS、PPT、RTF
-
通過轉換為 OOXML 格式來編輯的格式:ODP、ODS、ODT、RTF、CSV、TXT
-
閱讀支持的格式:PDF
6.0.0 版新特性
功能增加:
-
文檔編輯器里創建新文件
-
文檔編輯器從文檔模板創建新文件
-
文檔管理器里增加了“下載”功能
-
與存儲的文檔比較
-
從存儲合并郵件
-
從存儲區插入圖像
-
增加了文件改變歷史功能,高亮顯示不同版本的修改細節
-
自定義文檔編輯器視圖畫面
-
從文檔編輯器中標記為收藏
-
文檔編輯器增加了 goBack 返回 url 連接的功能
-
編輯器根據文檔類型改變顯示圖標
-
檢測手機瀏覽器
-
加利西亞文的文件模板
功能修訂:
-
在文檔屬性詳細頁面加載預覽
-
CONTRIBUTOR 貢獻者權限的用戶無法加入編輯的 bug 已被修復
-
Document Server 文檔服務器的 v6.0 以前版本不再支持
完整的升級說明文檔見這里[4]
ONLYOFFICE Docs 與 Alfresco 連接集成
需求依賴項
-
ONLYOFFICE Document Server 文檔服務器 v7.1 以上版本 需要一個已經安裝部署好的文檔服務器,可以被 Alfresco 以及其它任意客戶端解析訪問, 且文檔服務器可以向 Alfresco 服務器發起 POST
注解:關于如何安裝 ONLYOFFICE Docs 可以參考官方文檔[5]
-
Alfresco v5.2 - 7.2
-
ONLYOFFICE Connector 連接器 v6.0.0
安裝 ONLYOFFICE 和 Alfresco Module 包
可以在GitHub 上下載最新的已編譯的安裝包[6],你需要 onlyoffice-integration-repo.jar和 onlyoffice-integration-share.jar文件。如果想要自行從源碼編譯安裝該模塊,例如修改源代碼,請參考開發指南[7]
在 repo和 share路徑下載已編譯的安裝包
-
從 onlyoffice-alfresco/repo/target/到 /webapps/alfresco/WEB-INF/lib/
-
從 onlyoffice-alfresco/share/target/到 /webapps/share/WEB-INF/lib/
可選操作,因為 Alfresco 和共享功能被部署為兩個不同的網絡服務,修改編輯配置文件alfresco-global.properties,設定主機地址、端口、協議
重啟 Alfresco 服務器
檢查該模塊是否出現在列表 /share/page/console/admin-console/module-package中
配置 ONLYOFFICE 和 Alfresco Module 包
找到Alfresco Administration Console管理面板,打開 http://<alfrescohost>/alfresco/s/onlyoffice/onlyoffice-config設定下列參數。
Document Server 文檔服務器設置:
-
Document Editing Service address文檔服務器地址:輸入文檔服務器的 URL 地址
-
Secret Key密鑰:設定加密數據傳輸的密鑰,更多細節請參考本文的啟用 ONLYOFFICE 和 Alfresco 集成的 JWT 功能[8]
高級服務器設置:
-
Document Editing Service address for internal requests from the Alfresco server:Alfresco 服務器內部訪問文檔服務器的地址。
-
Alfresco server address for internal requests from the Document Editing Service:文檔服務器內部訪問 Alfresco 服務器的地址。
一般設置:
-
Ignore SSL Certificate:關閉 SSL 安全連接功能
-
Enable Force Save:開啟強制保存,這樣當點擊保存按鈕后,就會保存進入 Alfresco 的存儲,而關閉該選項則只是保存在編輯器的緩存中,直到關閉編輯器再保存進 Alfresco 的存儲中。
-
Save docx, xlsx, pptx as a new version of the original file after conversion:文件格式轉換后,docx、xlsx、pptx 保存為舊格式文件的新版本,而關閉該選項則會在文件所在的文件夾內創建一個新的獨立文件。
-
Open the file for editing:允許系統管理員選擇哪些文件格式可以通過轉換為 OOXML 格式來支持編輯功能。
配置界面
為 ONLYOFFICE 和 Alfresco 的連接開啟 JWT 功能
為了保護文檔不受未授權的訪問,ONLYOFFICE 編輯器使用 JSON Web Token 網絡令牌 JWT 技術,在文檔編輯器初始化時這個token令牌加入到配置中,貫穿于 ONLYOFFICE 文檔服務進程的數據傳輸全過程,secret key密鑰用來簽署 JSON 網絡令牌,驗證請求文檔服務的合法性。
為保護文檔,需要在 ONLYOFFICE Docs 配置文件中開啟令牌驗證并且設定自己的密鑰,在連接器設置中輸入該密鑰。
第一步:配置 ONLYOFFICE Docs
使用任意編輯器打開編輯 local.json文件
-
Linux 系統下:/etc/onlyoffice/documentserver/local.json
-
Wndows 系統下:%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
-
Docker 方式:進入 ONLYOFFICE Docs 容器:
docker?exec?-it?<containerID>?bash打開文件 /etc/onlyoffice/documentserver/local.json
開啟令牌驗證功能,把下面三個條目從 false改為 true
-
services.CoAuthoring.token.enable.browser
-
services.CoAuthoring.token.enable.request.inbox
-
services.CoAuthoring.token.enable.request.outbox
設定自己的密鑰,替換下面三個條目中密鑰值,這三者必須保持一致
-
services.CoAuthoring.token.enable.request.outbox
-
services.CoAuthoring.secret.outbox.string
-
services.CoAuthoring.secret.session.string
保存修改
重啟服務使修改生效:
第二步:在連接器的設置中設定同樣的密鑰 在連接器的設置里,在Secret key中設定同樣的密鑰,保存。
連接示例 ONLYOFFICE Docs
從 ONLYOFFICE 連接器 v5.0.0 版本開始,可以在安裝自己的 ONLYOFFICE Docs 之前免費試用連接在線版本的 ONLYOFFICE 編輯器。
選中Connect to demo ONLYOFFICE Document Server連接示例 ONLYOFFICE Document 服務器選擇框,點擊save保存按鈕。
注解:這是一個公開的測試服務器,僅有 30 天試用期,不要分享敏感保密信息。
開始使用 ONLYOFFICE Docs 與 Alfresco 的集成功能
新建文檔:
打開一個文件夾
點擊Create...新建按鈕
選擇文件類型:文檔、表格或幻燈片
新建文檔
編輯或閱覽一個文檔:
找到需要打開的文檔
點擊Edit in ONLYOFFICE在 ONLYOFFICE 中編輯按鈕。
編輯文檔
把一個非 XML 文檔轉換為 XML 格式(docx、xlsx、pptx)
找到需要轉換格式的文檔
點擊Convert using ONLYOFFICE使用 ONLYOFFICE 轉換按鈕 文檔會被自動轉換為 XML 格式,保存在原文件夾中,可以配置針對一個文件夾的自動轉換規則,更多細節請參考官方 Alfresco 文檔[9]
格式轉換
下載文件為指定格式
找到需要下載的文件
點擊Download as...下載為按鈕,選擇所需要的格式
下載為
查看文件修改歷史:
點擊文件名或圖標,打開文件屬性信息
在右側面板中找到Version History版本歷史
可用的區域是:最新版本和以往版本,文件的改變高亮顯示
上傳新版本請點擊右上角對應的圖標
快速查看當前版本,將光標移動到文件上,對應的版本號將自動顯示在文件名右側,例如 1.0
文件歷史版本
或
在文檔編輯器中打開File文件子菜單
在子菜單中選擇Version History文件歷史選項
在文檔編輯器中新建文件:
打開File文件子菜單
點擊Create New新建選項
一個新的 .docx文件創建在新的標簽頁。
創建自定義模板:
用創建 Alfresco 的管理員賬號登陸
依次打開My files -> Data Dictionary -> Node Templates
添加自定義模板,格式為:.docx、.xlsx、.pptx
自定義模板
從模板新建文件:
進入一個需要新建文檔的文件夾
點擊Create...新建按鈕
選擇Create document from template從模板新建文件,選擇所需的模板
從模板新建文件
或
在編輯器中打開File文件子菜單
點擊Create New新建選項
選擇所需的模板
從模板新建文件
學習如何與存儲中的文件做對比,請參考這篇文檔[10]
文件對比
學習如何與存儲中的文件進行郵件合并,請參考這篇文檔[11]
郵件合并
學習如何從存儲插入圖片,請參考這篇文檔[12]
從存儲插入圖片
學習如何在編輯器中將文件加入收藏,請參考這篇文檔[13]
加入收藏
ONLYOFFICE如何與Alfresco Share連接集成
參考資料
[1]
Alfresco 插件庫: https://hub.alfresco.com/t5/alfresco-content-services-add/onlyoffice-connector-for-alfresco/m-p/291397
[2]
ONLYOFFICE 的 GitHub 頁面: https://github.com/ONLYOFFICE/onlyoffice-alfresco
[3]
API 文檔: https://api.onlyoffice.com/editors/alfresco
[4]
升級說明文檔見這里: https://github.com/ONLYOFFICE/onlyoffice-alfresco/blob/master/CHANGELOG.md
[5]
官方文檔: https://helpcenter.onlyoffice.com/installation/docs-index.aspx
[6]
GitHub 上下載最新的已編譯的安裝包: https://github.com/onlyoffice/onlyoffice-alfresco/releases
[7]
開發指南: https://api.onlyoffice.com/editors/alfresco
[8]
啟用 ONLYOFFICE 和 Alfresco 集成的 JWT 功能: #啟用ONLYOFFICE和Alfresco集成的JWT功能
[9]
官方 Alfresco 文檔: https://docs.alfresco.com/5.1/tasks/library-folder-rules-define-create.html
[10]
請參考這篇文檔: https://helpcenter.onlyoffice.com/ONLYOFFICE-Editors/ONLYOFFICE-Document-Editor/HelpfulHints/Comparison.aspx
[11]
請參考這篇文檔: https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-document-editor/usageinstructions/usemailmerge.aspx
[12]
請參考這篇文檔: https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-document-editor/usageinstructions/insertimages.aspx
[13]
請參考這篇文檔: https://helpcenter.onlyoffice.com/userguides/groups-gettingstarted-documents.aspx
總結
以上是生活随笔為你收集整理的ONLYOFFICE Docs 如何与 Alfresco 连接集成的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 4600u黑苹果 r5_联想G50-70
- 下一篇: 等保-机房来访人员进出登记表