| 作者 | 日期 |
|---|---|
| 雨中星辰 | 2018-12-20 |
文件歷史
您可以使用文檔編輯器查看文檔歷史記錄。
歷史記錄目前僅適用于文本文檔文件袍患。
文檔歷史記錄與文檔存儲服務(wù)一起存儲俊戳。該文檔編輯器顯示文檔歷史，在左側(cè)面板中的版本列表雪位。從列表中選擇文檔版本時竭钝，將顯示該文檔以供預(yù)覽。
- 用戶在文檔編輯器中編輯文檔時單擊“ 版本歷史記錄”按鈕茧泪。
- 該文檔編輯器請求來自文檔版本列表文件存儲服務(wù)蜓氨。
- 該文件存儲服務(wù)將要顯示的文件版本的版本號列表。
- 該文檔編輯器請求關(guān)于從選定的文件版本信息文件存儲服務(wù)队伟。
- 該文件存儲服務(wù)發(fā)送的鏈接文件的選定版本穴吹。
- 該文檔編輯器顯示選定的文件版本。
- 當(dāng)用戶單擊文檔版本列表中的另一個版本時嗜侮，文檔編輯器請求重新顯示有關(guān)版本的信息港令。
如何在實踐中做到這一點
- 創(chuàng)建一個html文件以打開文檔。
- 指定用于在文檔編輯器初始化的配置腳本中打開版本歷史記錄列表的事件處理程序锈颗。當(dāng)onRequestHistory事件被調(diào)用時顷霹，refreshHistory必須執(zhí)行的方法。如果每個版本都存在history參數(shù)击吱，則此方法包含每個文檔版本的文檔歷史記錄淋淀。
var onRequestHistory = function() {
docEditor.refreshHistory({
"currentVersion": 2,
"history": [
{
"created": "2010-07-06 10:13 AM",
"key": "af86C7e71Ca8",
"user": {
"id": "F89d8069ba2b",
"name": "Kate Cage"
},
"version": 1
},
{
"created": "2010-07-07 3:46 PM",
"key": "Khirz6zTPdfd7",
"user": {
"id": "78e1e841",
"name": "John Smith"
},
"version": 2
},
...
]
});
};
var docEditor = new DocsAPI.DocEditor("placeholder", {
"events": {
"onRequestHistory": onRequestHistory,
...
},
...
});
[圖片上傳失敗...(image-ba7614-1545210290122)]
- 在文檔編輯器初始化的配置腳本中，指定將從歷史記錄中選擇版本的事件處理程序覆醇。當(dāng)onRequestHistoryData事件被調(diào)用時朵纷，setHistoryData必須執(zhí)行的方法。此方法包含相應(yīng)版本文件的絕對URL永脓。
var onRequestHistoryData = function(event) {
var version = event.data;
docEditor.setHistoryData({
"key": "Khirz6zTPdfd7",
"url": "https://example.com/url-to-example-document.docx",
"version": version
})
};
var docEditor = new DocsAPI.DocEditor("placeholder", {
"events": {
"onRequestHistoryData": onRequestHistoryData,
...
},
...
});
image.png
- 在瀏覽器中打開您的html文件袍辞。
- 在“文檔編輯器”菜單中打開“ 版本歷史”選項。
使用highliting更改打開文檔歷史記錄
如果文檔版本是使用文檔編輯器創(chuàng)建的常摧，則在查看文檔歷史記錄時可以顯示文檔更改搅吁。額外的數(shù)據(jù)必須保存到文件存儲服務(wù)時保存的文檔版本除自己以外的編輯會話來實現(xiàn)這一目標(biāo)威创。在文檔編輯器中編輯后，編輯會話期間的更改信息將與更改的文檔一起發(fā)送：
- 歷史記錄 - 當(dāng)您在側(cè)面板中查看文檔歷史記錄時谎懦，此信息允許顯示每個文檔版本的時間和作者肚豺。必須作為參數(shù)發(fā)送的屬性發(fā)送，作為參數(shù)發(fā)送到refreshHistory方法界拦。
docEditor.refreshHistory({
"currentVersion": 2,
"history": [
{
"changes": changes, //the changes from the history object returned after saving the document
"created": "2010-07-06 10:13 AM",
"key": "af86C7e71Ca8",
"serverVersion": serverVersion, //the serverVersion from the history object returned after saving the document
"user": {
"id": "F89d8069ba2b",
"name": "Kate Cage"
},
"version": 1
},
{
"changes": changes,
"created": "2010-07-07 3:46 PM",
"key": "Khirz6zTPdfd7",
"serverVersion": serverVersion,
"user": {
"id": "78e1e841",
"name": "John Smith"
},
"version": 2
},
...
],
});
- changesurl - 文件的絕對URL详炬，文檔編輯數(shù)據(jù)用于顯示與特定文檔版本對應(yīng)的更改。必須保存該文件寞奸，并且必須使用setHistoryData方法將其地址作為changesUrl參數(shù)發(fā)送。必須將指向先前文檔版本（previous.url）的鏈接添加到對象中在跳。
docEditor.setHistoryData({
"changesUrl": "https://example.com/url-to-changes.zip",
"key": "Khirz6zTPdfd7",
"previous": {
"key": "af86C7e71Ca8",
"url": "https://example.com/url-to-the-previous-version-of-the-document.docx"
},
"url": "https://example.com/url-to-example-document.docx",
"version": 2
});
該*changesurl*請求在從與添加iframe的瀏覽器發(fā)出**documentserver**域枪萄，其中**documentserver**是安裝了ONLYOFFICE文件服務(wù)器的服務(wù)器的名稱。為了正確工作猫妙，必須允許跨源HTTP請求（CORS）瓷翻。這可以使用*Access-Control-Allow-Origin*標(biāo)頭來實現(xiàn)。
onlyoffice中文指南 目錄
【onlyoffice中文指南】0-基本概念
【onlyoffice中文指南】1-onlyoffice的工作原理
【onlyoffice中文指南】2-打開文件
【onlyoffice中文指南】3-保存文件
【onlyoffice中文指南】4-協(xié)同編輯
【onlyoffice中文指南】5-轉(zhuǎn)換和下載文件
【onlyoffice中文指南】6-文檔歷史
【onlyoffice中文指南】7-安全
【onlyoffice中文指南】8-高級參數(shù)
【onlyoffice中文指南】9-回調(diào)處理程序
【onlyoffice中文指南】10-Document配置
【onlyoffice中文指南】11-編輯器(Editor)參數(shù)配置
【onlyoffice中文指南】12-問題及排除
本文翻譯自官方文檔
