Применимость: Cloud. Названия пунктов и доступность функций зависят от версии, плана и типа проекта. Проверяйте изменения на тестовом окружении. Описанные рабочие процедуры — предлагаемый подход, а не гарантии поставщика.
Задача и границы применения
Инструкции первой линии лежат на отдельных страницах, а общий список владельцев и состояний приходится обновлять вручную. Вместо второй копии этих сведений можно хранить небольшую карточку рядом с каждой инструкцией и собирать карточки в отчёт. Сама процедура остаётся на исходной странице; реестр помогает найти её и понять, кто отвечает за содержание.
В учебном примере подготовим две инструкции — «Сбой почты» и «Сбой доступа». В каждой будут поля «Сервис», «Владелец» и «Состояние». Отдельная страница «Реестр инструкций» покажет ссылки на них и эти три значения. Это предлагаемый пилот, а не описание выполненного проекта или проверка в вашей Confluence.
Сценарий рассчитан на Confluence Cloud, современный редактор и обычные опубликованные страницы. В документации макросы называются Content Properties и Content Properties Report; прежние названия — Page Properties и Page Properties Report. Здесь речь о таблицах внутри макросов, а не о свойствах REST API. Для Data Center проверяйте документацию установленной версии отдельно. Live docs и расширения Marketplace в этот пилот не входят.
Подготовка: пространство, участники и контрольная выборка
Выберите тестовое пространство, например KBDEMO, и отдельную страницу для реестра. Нужны возможность создавать и редактировать страницы и доступ к исходным инструкциям. Начните без шаблона пространства: две вручную настроенные страницы проще сравнить. Если позднее будете переносить карточку в шаблон, заранее привлеките администратора пространства для действий, требующих его прав.
Используйте только нейтральные данные: названия учебных сервисов и согласованные обозначения владельцев. Создайте третью страницу «Контроль: не инструкция», которую отчёт включать не должен. До настройки запишите ожидаемую выборку: две инструкции для участника с доступом к обеим; контрольная страница исключена. Так появление лишней строки станет заметным сразу.
Для проверки ограничений понадобится отдельный участник с заранее известным доступом. На Free нельзя настраивать ограничения содержимого как на платных планах. Если ваша среда не позволяет воспроизвести отрицательный сценарий доступа, отметьте его как непроверенный и не используйте конфиденциальные данные. Менять план или расширять доступ ради этой инструкции не требуется.
Шаг 1. Создайте карточку в Content Properties
Откройте «Сбой почты» в редакторе. Через меню вставки или поиск после символа / добавьте Content Properties. Внутри макроса создайте таблицу из двух столбцов: слева имена полей, справа значения. В параметрах таблицы выключите строку заголовков и включите столбец заголовков слева. Ниже показан состав ячеек; это образец для обычной таблицы редактора, а не текст, который нужно вставлять вместо макроса.
В параметрах Content Properties задайте ID runbook-card. Добавьте к самой странице метку kb-runbook-pilot и опубликуйте её. ID относится к набору свойств внутри макроса, а не к числовому идентификатору страницы. Для второй инструкции используйте тот же ID: отчёт должен собрать карточки одинакового назначения. Метка находится на странице, а не в строке таблицы.
На странице «Сбой доступа» повторите структуру с сервисом «Учебный вход» и другим согласованным владельцем. Названия левых ячеек сохраните точно такими же. Не пишите в одной карточке «Владелец», а в другой «Ответственный»: для читателя это близкие понятия, но для отчёта это разные ключи. Не помещайте в карточку секреты, токены и подробности закрытого инцидента.
Сервис | Учебная почта
Владелец | Группа поддержки
Состояние | Требует проверкиШаг 2. Соберите реестр с явными фильтрами
На странице «Реестр инструкций» добавьте Content Properties Report. В поле Labels выберите kb-runbook-pilot. Через дополнительные фильтры ограничьте поиск пространством KBDEMO с помощью In space. В Options укажите Content properties ID = runbook-card. Затем задайте Columns to show: Сервис,Владелец,Состояние. Заголовок первого столбца можно заменить на «Инструкция»; этот столбец содержит ссылки на исходные страницы.
Сохраните макрос и опубликуйте страницу реестра. У каждой инструкции теперь две разные части отбора: метка помогает найти страницу, а ID выбирает нужный блок свойств. В отчёте можно указать только один ID. Не оставляйте его пустым в этом пилоте: на исходной странице позднее может появиться другая карточка, которую не нужно смешивать с карточкой инструкции.
Начните с одной метки и пространства, без дополнительных условий по родителю или тексту. Это уменьшает число причин пустой выборки. Перед добавлением нового фильтра сначала запишите, какие страницы он должен исключить. Значение «Требует проверки» остаётся обычным содержимым карточки: само его наличие не настраивает фильтрацию строк по состоянию и не запускает согласование документа.
Labels: kb-runbook-pilot
In space: KBDEMO
Content properties ID: runbook-card
Columns to show: Сервис,Владелец,Состояние
Title column heading: ИнструкцияПроверка: состав строк, изменения и отрицательные сценарии
Проверьте опубликованный реестр обычным участником, который видит обе исходные страницы. Сверьте ссылки и каждое значение с карточками. Затем измените состояние только в «Сбой почты», опубликуйте страницу и повторно откройте отчёт. Ожидается изменение именно соответствующей строки без ручного редактирования реестра. По одной административной сессии принимать результат нельзя.
Выполните предложенные ниже проверки и сохраните наблюдаемый итог отдельно от ожидаемого. Если отчёт ещё не отразил изменение, не начинайте сразу переименовывать метки и ID: сначала убедитесь, что исходная страница опубликована и открыта нужная версия реестра. Эти проверки не заявляются выполненными на реальной Confluence.
- Две инструкции имеют нужную метку и ID: участник с доступом к обеим видит обе карточки с правильными значениями.
- Контрольная страница без метки не появляется в выборке.
- На учебной копии метка есть, но ID отличается: её карточка не попадает в отчёт runbook-card.
- После изменения одного значения в исходной карточке обновляется соответствующая строка, а соседняя остаётся прежней.
- Если план позволяет ограничения, участник без доступа к одной инструкции не получает её содержимое ни через отчёт, ни по прямой ссылке.
- Обычный читатель может открыть доступную инструкцию; для просмотра реестра ему не выдают право редактирования или администратора.
Доступ и ограничения: отчёт не заменяет политику знаний
Confluence не показывает через макросы содержимое, которое пользователь не вправе просматривать. Видимый одному сотруднику реестр поэтому может отличаться от реестра другого. Метка, ID макроса и фильтр пространства не выдают доступ. Проверяйте исходную страницу и права участника отдельно; не снимайте ограничения только ради одинакового количества строк у всех.
Особенно внимательно выбирайте аудиторию страницы реестра. Самостоятельно написанный над макросом текст, заголовок страницы или вручную добавленная ссылка не наследуют смысл конфиденциальности отдельной карточки. Не переносите в общее описание сведения, которые должны оставаться только в закрытой инструкции. Отрицательный тест проводите на учебных данных и в среде с поддерживаемыми ограничениями.
Параметр Max results per page ограничивает число строк на странице отчёта; в документации указан максимум 30 перед переходом по страницам. Это не основание объявлять остальные инструкции потерянными. При расширении каталога проверяйте доступные переходы между страницами результатов. Реестр также не является журналом утверждений: заполненное поле состояния не доказывает, что владелец прочитал и одобрил процедуру.
Диагностика: пустой отчёт, пустые ячейки и лишние карточки
При пустом отчёте выберите одну исходную страницу, которую точно ожидаете увидеть. Проверьте доступ текущего участника, метку на странице, публикацию, ID макроса и выбранное пространство. Снимайте дополнительные фильтры по одному на тестовой странице реестра. Если убрать всё сразу, причина останется неизвестной и вернётся после восстановления настроек.
Если строка есть, но один столбец пуст, сравните название ключа в левой ячейке и Columns to show. Проверьте лишние пробелы, другой вариант слова и расположение таблицы: она должна находиться внутри Content Properties. Не исправляйте пустую ячейку вручную в реестре — исправление нужно делать в карточке, иначе появится ещё одна расходящаяся копия данных.
Если появились посторонние данные, проверьте использование метки и незаполненный ID отчёта. Разные наборы свойств на одной странице должны иметь осмысленные ID. Для регулярного пополнения подготовьте шаблон только после успешного пилота. В шаблоне закрепите названия ключей, ID и назначение метки; при изменении структуры сначала проверьте одну новую страницу рядом со старыми.
Откат и передача реестра владельцу
Перед изменением работающего реестра сохраните его параметры и перечень полей. Экспериментируйте на отдельной странице с отдельной меткой. Для остановки пилота достаточно убрать тестовый отчёт из навигации или удалить его макрос. Это не удаляет исходные инструкции и не отменяет изменения их карточек, меток или ограничений доступа.
Если нужно вернуть прежний набор столбцов, восстановите сохранённые параметры отчёта. Если менялись названия ключей, верните их в исходных карточках согласованно. Не удаляйте метку массово: сначала проверьте, не используют ли её другие отчёты. Права доступа возвращайте по отдельному согласованному перечню; удаление макроса не является откатом разрешений.
Перед передачей назначьте владельца структуры карточки и владельцев инструкций. Сохраните название пространства, метку kb-runbook-pilot, ID runbook-card, список полей и результаты собственной приёмки. Отдельно отметьте непроверенные сценарии. Материал подготовлен по официальной документации; изменения в клиентской Confluence и выполненные пользовательские испытания не заявляются.
Официальная документация
Применить это к вашей системе
Обсудим контекст, ограничения и безопасный порядок изменений.
Обсудить задачу