Совместное редактирование - Центр поддержки Р7

Запись опубликована:18.10.2022
Post category:Как это работает
Запись изменена:10.12.2023

Распечатать/сохранить в PDF

Рисунок и приведенные ниже шаги объясняют процесс совместного редактирования документа в Р7 Document Server

Совместное редактирование

Пользователь 1 и пользователь 2 открывают один и тот же документ в редакторе документов, т.е. при открытии файла использовался один и тот же document.key.
Пользователь 1 вносит изменения в открытый документ.
Редактор документов отправляет изменения, внесенные пользователем 1, в службу редактирования документов.
Служба редактирования документов отправляет изменения, сделанные пользователем 1, редактору документов пользователя 2.
Теперь эти изменения становятся видны пользователю 2.

Совместное редактирование

Как это может быть выполнено на практике

Создайте пустой html-файл.
Добавьте элемент div, как показано ниже.
```
<div id="placeholder"></div>
```
Укажите ссылку на Сервер документов с помощью JavaScript API, который будет использоваться для вашего веб-сайта.
```
<script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js"></script>
```
Где documentserver — это имя сервера, на котором установлен Сервер документов Р7.
Добавьте скрипт, инициализирующий редактор документов для элемента div с конфигурацией документа, который вы хотите открыть.

new DocsAPI.DocEditor("placeholder", {
    "document": {
        "fileType": "docx",
        "key": "Khirz6zTPdfd7",
        "title": "Example Document Title.docx",
        "url": "https://example.com/url-to-example-document.docx"
    },
    "documentType": "word",
    "editorConfig": {
        "user": {
            "id": "78e1e841",
            "name": "John Smith"
        }
    }
});

Где example.com — это имя сервера, на котором установлены менеджер документов и служба хранения документов.

Откройте ваш html-файл в браузере.
Теперь сделайте копию вашего HTML-файла, созданного выше.

Измените скрипт инициализации редактора документов в скопированном html-файле.

new DocsAPI.DocEditor("placeholder", {
    "document": {
        "fileType": "docx",
        "key": "Khirz6zTPdfd7",
        "title": "Example Document Title.docx",
        "url": "https://example.com/url-to-example-document.docx"
    },
    "documentType": "word",
    "editorConfig": {
        "user": {
            "id": "F89d8069ba2b",
            "name": "Kate Cage"
        }
    }
});

8. Где example.com — это имя сервера, на котором установлены менеджер документов и служба хранения документов.
Откройте скопированный и отредактированный html-файл в браузере.

Использование ключа в совместном редактировании

Чтобы открыть документ для редактирования, при инициализации конфигурации требуется ключевой параметр, который позволяет пользователю повторно открыть документ из кеша редактора. Ключ представляет собой текстовое поле ограниченной длины и количества символов. Он генерируется интеграторами программного обеспечения и определяет уникальный идентификатор документа, используемый службой для распознавания документа.

Можно использовать ключевые символы: 0–9, a–z, A–Z, -._=. Максимальная длина ключа – 128 символов.
Поэтому важно, чтобы у пользователей был один и тот же ключ для открытия документа для совместного редактирования. Служба редактирования документов идентифицирует ключ другого пользователя (или другую вкладку/сеанс редактирования для встроенных редакторов), который пытается открыть документ, и, если этот ключ совпадает с ключом файла, пользователю разрешается открыть его. Если ключ другой, то открывается новый файл, не связанный с другими файлами и версиями файлов.

После отправки запроса на сохранение файла (значение статуса равно 2) и успешного завершения операции (значение ответа равно {«error»:0}) этот ключ не может быть использован для открытия документа для редактирования. Редактор загружается с сообщением об ошибке. Однако его можно использовать для просмотра документа из кэша, если он существует.

Если пользователь сохраняет документ до завершения редактирования (значение статуса равно 6), ключ изменить нельзя. В противном случае совместное редактирование прекращается. Обратите внимание, что после процедуры принудительного сохранения ключ также не может быть изменен для новых пользователей, которые только входят в текущую сессию редактирования.

Пример

Добавьте скрипт, инициализирующий Редактор документов с ключом 1. Ключ неизвестен и указан URL для открытия файла.

Закройте Редактор документов.

new DocsAPI.DocEditor("placeholder", {
    "document": {
        "fileType": "docx",
        "key": "Khirz6zTPdfd7",
        "title": "Example Document.docx",
        "url": "https://example.com/url-to-example-document.docx"
    },
    "documentType": "word",
    ...
});

2. Где example.com – это имя сервера, на котором установлены менеджер документов и служба хранения документов.

Добавьте скрипт, инициализирующий Редактор документов с тем же ключом 1. Новый URL-адрес не используется, поскольку ключ известен и документ повторно открывается из кеша редактора.

new DocsAPI.DocEditor("placeholder", {
    "document": {
        "fileType": "docx",
        "key": "Khirz6zTPdfd7",
        "title": "Example Document 2.docx",
        "url": "https://example.com/url-to-example-document2.docx"
    },
    "documentType": "word",
    ...
});