История версий
Просматривайте прошлые версии, изучайте изменения и восстанавливайте общий документ.
История версий организует подтвержденные совместные изменения в просматриваемые версии. Для каждого подтвержденного изменения разработчики и пользователи могут видеть автора, временную метку и действие, открывать документ в том виде, в котором он стоял в тот момент, просматривать разницу и восстанавливать версию, когда у них есть разрешение. История остается доступной после окончания сеанса редактирования и перезагрузки страниц.
Как работает история версий
мутация - это одно повторно воспроизводимое изменение контента, такое как установка ячейки или вставка абзаца. менять является одним представлением о сотрудничестве, которое несет упорядоченную группу мутаций.
1. Запись изменений
Каждое редактирование от пользователя или агента производит мутации. Univer упаковывает эти мутации в набор изменений и отправляет его для совместной работы, чтобы подтвердить и сохранить.
После подтверждения в подачу поступает пересмотр, который идентифицирует свою позицию в истории документа.История индексирует подтверждённые вносимые в него изменения, группирует их по времени и операции и строит временную шкалу версии.
2. Воссоздание прошлого содержимого
снимок - это полное состояние контента при одной ревизии. Когда выбирается историческая версия, Univer загружает базовый снимок и наборы изменений, которые следуют за ним до целевой ревизии, а затем переигрывает их мутации в порядке. Результатом является только просмотр содержимого, как оно стояло при этой ревизии.
Пример: snapshot на revision 10 + changesets для ревизий 11–15 = содержимое на revision 15.
3. Восстановление текущего документа
Выбор Восстановите эту версию начинается следующим образом:
Выбрать версию → Отправить mutation восстановления → Подтверждение → Обновить текущий документ с новой revision
Операция восстановления создает новый исторический рекорд.Предыдущие версии остаются доступными.
Просмотр версий и изменений
- Откройте историю в редакторе и выберите версию.
- Расширить группу версий, чтобы проверить индивидуальные изменения. Выберите один пересмотр, чтобы прочитать его содержание и изменения в просмотрщике только для чтения.
- Выберите Восстановите эту версию, когда требуется откат. Восстановление обновляет общий документ посредством совместной работы, поэтому каждый другой участник получает изменение.
Группа версий может комбинировать изменения, сделанные в пределах временного окна. Расширить группу для проверки отдельных изменений. Одна запись истории не обязательно соответствует одному нажатию клавиши или одному сгенерированному снимку.
Цвета изменений
| Метка | Значение |
|---|---|
| 🟦 Синий: обновлено | Существующий контент изменился. |
| 🟩 Зелёный: добавление | Новая строка, абзац, запись или объект доски. |
| 🟥 Красный: удалено | Содержимое удалено в этой версии. |
Цвета указывают на Тип изменения. Замена текста может производить как вставку, так и удаление. Каждый зритель продукта определяет, сколько контента выделено.
История в пяти продуктах
Приведенные ниже примеры взяты из одного проекта Northstar.Содержание на английском языке и сроки расширены, так что каждый документ показан вместе с действиями, стоящими за его изменениями.
Sheets
Бюджет запуска показывает корректировки бюджета и прогноза наряду со вставленными и удаленными строками. Рабочий лист и график действий помогают определить местоположение области, затронутой каждым изменением.
Sheets — Руководство по интеграции
Docs
Краткое описание запуска продукта охватывает дату запуска, форматирование абзаца и добавления, сделанные для готовности клиента. Удаленный текст остается видимым с красным прочерком, поэтому каждая редакция сохраняет свой контекст.
Docs — Руководство по интеграции
Slides
Следите за целевыми показателями и объектами страницы в Launch Review. Выберите запись истории, чтобы увидеть обновленные, вставленные и удаленные объекты, отмеченные непосредственно на слайде.
Slides — Руководство по интеграции
Relational Table
Launch Tracker показывает изменения в задачах, владельцах и статусах.Записи и изменения поля появляются в контексте таблицы, которая уточняет, когда и как изменились бизнес-данные.
Relational Table — Руководство по интеграции
Canvases
Release Workspace показывает карты планирования и свойства объектов.Вставленные, удаленные и обновленные объекты остаются помеченными на холсте, что облегчает отслеживание пересмотра планирования.
Canvases — Руководство по интеграции
Coming soon: История версий PDF пока недоступна.
Интеграция с приложением
История версий объединяет расширение History в Server SDK с плагинами истории продуктов в Web SDK.
- На сервере добавьте History Service, Endpoint и постоянный адаптер базы данных для Core Collaboration. Сервис подписывается на создание Unit и совершенные изменения, строит индекс истории и обнажает запросы на версии и изменения.
- В браузере регистрируют общую возможность истории и плагины пользовательского интерфейса History/ History продукта, затем подключают конечную точку истории. Зритель загружает выбранный пересмотр и отображает его изменения. Для пользовательского контента регистрируют соответствующие плагины просмотра.
- Ваше приложение предоставляет идентификатор и авторизацию, а сервер проверяет прочитанные истории и восстанавливает разрешения. Историческая версия может содержать данные, которые текущий документ уже удалил.
См. Расширения сотрудничества и соберите сервис с помощью Пример истории, а затем соедините пользовательский интерфейс с руководствами по продукту выше.
Индексы истории - это восстановленные производные данные. Подтвержденные изменения остаются авторитетным источником контента. Ваше приложение контролирует постоянство и удержание. Панель истории не заменяет резервные копии.
Связь с другими функциями
| Способность | Цель |
|---|---|
| Ундо / Redo | Восстановить или повторно применить операцию редактирования без службы истории. |
| История версий | Следите за подтвержденными версиями во время сеансов, проверяйте изменения и восстанавливайте общий контент. |
| Сравнение контента | Сравните два состояния контента для пользовательского интерфейса или агента. Сравнение только для чтения не восстанавливает контент. |
| Worktree | Изолируйте проекты изменений для обзора, прежде чем объединять их в общий контент. |
Изменения агентов, внесенные через API Facade, входят в один и тот же конвейер истории, как только их подтверждает сотрудничество.Приложения могут комбинировать историю с сравнением контента для автоматического обзора и проверок.
Насколько полезно это руководство?