Применимость: Cloud. Названия пунктов и доступность функций зависят от версии, плана и типа проекта. Проверяйте изменения на тестовом окружении. Описанные рабочие процедуры — предлагаемый подход, а не гарантии поставщика.
Задача: заменить файл без потери истории
Команда хранит инструкцию на странице Confluence, а подробный список проверок прикладывает отдельным файлом. После обновления читатели продолжают скачивать старый вариант или видят два похожих документа. Чтобы разобраться, нужно отдельно проверить саму страницу, прикреплённый объект, его версии и ссылки на него. Восстановление текста страницы не следует считать откатом вложения.
Ниже приведён учебный пилот для Confluence Cloud с обычной опубликованной страницей. Используются два небольших текстовых файла с одинаковым именем и различимым содержимым. Никаких испытаний в реальном пространстве или клиентских результатов здесь не заявляется. Порядок действий нужно проверить на своей тестовой странице до изменения рабочей инструкции.
Облачный интерфейс обновляется без фиксированного номера версии. Ориентируйтесь на раздел Attachments в Show details или меню страницы. Для Data Center сверяйте документацию установленного выпуска; приведённые названия меню и ограничения Cloud нельзя автоматически переносить на серверную установку. Пилот не требует REST API, установки приложений или изменения глобальных настроек.
Подготовьте исходный файл и контрольные признаки
Создайте отдельную тестовую страницу «Проверка вложения инструкции» в пространстве с ограниченной учебной аудиторией. Подготовьте локальную папку baseline и положите туда checklist.txt с текстом «BASELINE: проверить доступ к тестовому сервису». Во второй папке candidate создайте checklist.txt с текстом «CANDIDATE: проверить доступ и назначение ответственного». Имена одинаковы, содержимое отличается. Эти маркеры не являются рабочими командами.
До загрузки откройте оба файла локально и убедитесь, что редактор действительно сохранил изменения. Затем загрузите baseline/checklist.txt на тестовую страницу и опубликуйте её. Запишите название страницы, её URL, имя вложения и номер версии из Attachments. Сохраните исходный файл отдельно от рабочего кандидата: не перезаписывайте единственную копию, необходимую для возврата.
При необходимости используйте контрольную сумму как дополнительное доказательство совпадения байтов. Она полезнее одинаковой картинки предпросмотра, но не заменяет проверки содержания и доступа. Не помещайте в учебный файл секреты или реальные сведения о клиентах: история вложения может сохранить прежние данные после последующих обновлений.
Проверьте права и страницу-владельца
Для загрузки нужен Add Attachments в пространстве. Возможность редактировать текст не означает возможность добавлять новые файлы. Проверьте действие под обычной ролью редактора, затем отдельно откройте страницу читательским аккаунтом. Не выдавайте права администратора только потому, что команда загрузки отсутствует в панели.
Перед обновлением откройте Attachments именно у страницы-владельца и найдите checklist.txt. Одинаковое имя на другой странице не означает общий файл. Зафиксируйте, откуда читатели получают документ: из блока на текущей странице, списка вложений или ссылки в другом руководстве. Для пилота достаточно одной дополнительной страницы со ссылкой на файл.
Убедитесь, что тестовый читатель может просматривать страницу и скачивать вложение. Ограничения просмотра родительского материала влияют и на дочернюю структуру. Само наличие ссылки не предоставляет доступ. Если есть Premium и доступна Inspect permissions, используйте отчёт для поиска уровня отказа; отсутствие этой функции на другом тарифе не является ошибкой загрузки.
Загрузите новую версию с тем же именем
На той же странице загрузите candidate/checklist.txt, сохранив точное имя checklist.txt. Confluence поддерживает историю вложений; загрузка одноимённого файла на ту же страницу обновляет существующее вложение. Изменение файла только в локальной папке, напротив, не меняет уже загруженный документ. Не путайте сохранение в редакторе на компьютере с публикацией новой версии.
Откройте список вложений, раскройте строку checklist.txt и проверьте появление следующей версии. Для учебного файла ожидается переход от первой версии ко второй. Если появилась отдельная строка checklist-new.txt или checklist (1).txt, остановитесь: вы проверяете другой объект. Не удаляйте ничего сразу; сначала сравните фактические имена и убедитесь, какую строку используют ссылки.
Размер загрузки ограничивается настройкой администратора; документация указывает исходное значение 100 MB. Пилот с коротким текстовым файлом специально исключает эту переменную. Если реальный документ значительно больше, проверьте действующий предел отдельно. Не все допустимые вложения поддерживают встроенный предпросмотр, поэтому отсутствие картинки само по себе ещё не означает неуспешную загрузку.
Проверьте скачивание и отрицательный сценарий
Войдите тестовым читателем и скачайте checklist.txt через список вложений в новую пустую локальную папку. Откройте именно полученный файл, а не вкладку старой копии в редакторе. Ожидаемый положительный результат: текст содержит CANDIDATE и дополнительную проверку ответственного. Отдельно зафиксируйте номер текущей версии в Confluence.
Для отрицательного сценария поменяйте локальный candidate/checklist.txt, дописав «LOCAL-ONLY», но не загружайте его. Снова скачайте файл с Confluence. Он не должен содержать LOCAL-ONLY. Эта проверка отделяет локальное редактирование от факта публикации и помогает объяснить, почему автор видит изменения, а коллеги продолжают получать прежний документ.
Если результат не совпал, проверьте страницу-владельца, имя, завершение загрузки и место сохранения скачанного файла. Просмотрите историю и скачайте конкретную предыдущую версию для сравнения. Не принимайте автоматически переименованный браузером файл за новую версию на сервере. В протоколе разделяйте ожидаемые результаты этих шагов и реально увиденные значения.
Сверьте ссылки и отображение на странице
На дополнительной странице создайте ссылку через адрес файла из Attachments. Официальная инструкция различает обычную ссылку на вложение и ссылку на его последнюю версию: для последней предлагает убрать часть адреса после расширения файла. Делайте это только с адресом собственного вложения, скопированным по инструкции; не обрезайте произвольные подписанные URL внешних сервисов.
Откройте ссылку читателем после обновления и сравните содержимое с вариантом CANDIDATE. Если нужен фиксированный исторический документ, явно обозначьте это в тексте ссылки и проверьте выбранную версию. Название «актуальная инструкция» без такой проверки создаёт неверное ожидание. Список версий и скачанные байты должны подтверждать назначение ссылки.
Для обычной страницы можно дополнительно использовать Attachments macro, чтобы показывать список прикреплённых файлов. По документации этот макрос пока недоступен в live docs, поэтому не обещайте одинаковую вставку для обоих форматов. Встроенная карточка, предпросмотр и список вложений — разные способы отображения; проверяйте тот путь, которым пользуется читатель.
Верните исходное содержимое без удаления версий
Confluence Cloud позволяет скачивать прежние версии вложения, но не предоставляет прямого возврата к предыдущей версии. Практический способ вернуть исходные данные — загрузить сохранённый baseline/checklist.txt ещё раз как очередную версию того же файла. Это предложенный рабочий приём на основе механизма загрузки, который необходимо подтвердить в пилоте, а не обещание отдельной кнопки Restore.
После повторной загрузки раскройте историю: в учебном сценарии ожидается третья версия. Скачайте текущий файл и сравните его с baseline по тексту, а при необходимости по контрольной сумме. Снова пройдите ссылку с дополнительной страницы. В журнале напишите «исходное содержимое опубликовано новой версией», чтобы не создавать впечатления, будто вторая версия исчезла.
Не удаляйте конкретную версию ради обычного отката: документация предупреждает, что удалённую отдельную версию восстановить нельзя. Если обновление раскрыло чувствительные сведения, простой возврат исходного файла не решает вопрос сохранённой истории и скачанных копий. Передайте такой случай владельцу данных по принятому процессу вместо самостоятельной очистки следов.
Ошибки и завершение пилота
Удаление карточки файла из текста страницы не удаляет само вложение. Поэтому исчезнувший блок не доказывает, что документ больше недоступен через Attachments или старую ссылку. И обратная ситуация: удаление прикреплённого объекта может оставить на странице неработающий элемент. Эти действия не нужны для проверки замены версии.
Завершите пилот, когда подтверждены текущий файл, история, обе ссылки и доступ читателя, а отрицательный тест показал отсутствие локальных неопубликованных изменений. Запишите владельца вложения и правило обновления: сохранять имя и страницу, перед заменой иметь исходную копию, после загрузки скачивать результат. Это короткая процедура приёмки для последующих изменений.
Тестовые страницы и файлы убирайте по внутреннему порядку после фиксации результата; не переносите учебную процедуру удаления на рабочие инструкции. Для реального обновления начните с одного согласованного вложения и повторите те же проверки. Если неожиданно поменялась аудитория или ссылки ведут на другой объект, остановитесь до следующей загрузки и сначала восстановите понятную схему доступа.
Официальная документация
Применить это к вашей системе
Обсудим контекст, ограничения и безопасный порядок изменений.
Обсудить задачу