Child items в Confluence Cloud: навигация по инструкциям без ручного списка

Задача и область применения

На входной странице поддержки вручную перечислены инструкции. Автор добавляет новую страницу, но забывает дописать ссылку; после переименования заголовок списка тоже требует исправления. Если инструкции действительно лежат под одним родителем, навигацию можно строить из этой структуры с помощью Child items, вместо ведения второй копии перечня.

Проверим учебный раздел с двумя инструкциями и одной вложенной страницей диагностики. Нужно получить понятный список первого уровня, затем отдельно проверить раскрытие второго уровня и видимость под обычным читателем. Это предлагаемый пилот: работа в реальной Confluence и успешные клиентские испытания здесь не заявляются.

Сценарий рассчитан на Confluence Cloud, современный редактор и обычные опубликованные страницы. В текущей документации макрос называется Child items, в прежнем интерфейсе встречается Child pages или Children Display. Cloud обновляется без устанавливаемого номера версии; ориентируйтесь на доступные параметры. Для Data Center, старого редактора и расширений Marketplace нужна документация соответствующей версии. Live docs и папки в этот опыт не включаем.

Подготовьте отдельную ветку и ожидаемый результат

Выберите тестовое пространство либо согласованный участок пространства поддержки. Нужны права создавать и редактировать учебные страницы. Для проверки доступа привлеките владельца настроек пространства и отдельного обычного читателя. Не начинайте с перемещения существующей базы знаний: новая небольшая ветка позволяет проверить навигацию без изменения рабочих адресов и наследования доступа.

Создайте родительскую страницу «Поддержка — пилот». Под ней разместите «Почта — пилот» и «VPN — пилот», а под второй — «VPN: сбор диагностики — пилот». Рядом с родительской страницей создайте «Соседний материал — пилот». Используйте контекстное создание в дереве и после публикации сверяйте фактическое положение, а не только похожие заголовки.

Запишите исходные URL и заполните страницы нейтральными короткими инструкциями. Для читателя с доступом ко всей ветке ожидаются две ссылки на первом уровне и дополнительная диагностическая страница на втором. Соседний материал не должен попадать ни в один вариант списка. Он нужен как отрицательный контроль границ выборки.

На родительской странице добавьте ручной перечень ожидаемых ссылок и подпишите его «Контрольный список». Сохраните его текст отдельно. Сравнивайте оба варианта до замены: похожий внешний вид ещё не показывает, что макрос охватывает нужные страницы.

Поддержка — пилот
  Почта — пилот
  VPN — пилот
    VPN: сбор диагностики — пилот

Соседний материал — пилот (вне ветки)

Добавьте и настройте список

Откройте родительскую страницу на редактирование, вызовите меню вставки через / и выберите Child items. Через Edit откройте параметры. Для первого опыта используйте настройки ниже. Проверьте выбранный Parent item по самой странице: одинаковые слова в названиях не определяют родителя.

Сохраните и опубликуйте страницу. Проверьте результат в режиме просмотра, затем откройте обе ссылки и убедитесь, что они ведут на учебные инструкции. Не ограничивайтесь изображением макроса в редакторе. Если список пуст, сначала проверьте опубликованные дочерние страницы и выбранного родителя.

Сортировку зафиксируйте заранее, чтобы другой порядок не принять за пропажу страницы. В учебном списке достаточно алфавитного порядка. Для длинной базы знаний сначала выберите принцип группировки: один огромный перечень редко помогает найти конкретную процедуру.

• Parent item: «Поддержка — пилот».
• Show all child items: включено.
• Show all levels: выключено; Max number of levels: 1.
• Sort order: Title; List style: Bulleted.
• Display preview: None.

Проверьте глубину и обновление навигации

В первом варианте диагностика VPN не должна выглядеть как третья инструкция первого уровня. Затем измените только Max number of levels на 2, опубликуйте и сравните результат с подготовленной схемой. Это отделяет глубину дерева от ошибки выбора родителя. После опыта верните один уровень, если входная страница должна оставаться короткой.

Создайте ещё одну непосредственную дочернюю страницу, например «Рабочее место — пилот». После публикации и повторного открытия родителя проверьте её появление без ручного добавления ссылки. Далее переименуйте только эту учебную страницу и подтвердите новое название в навигации. Остальные страницы в этом опыте не изменяйте.

Убедитесь, что все ожидаемые элементы можно открыть, а не только посчитать. Если в будущем ограничите размер списка, записывайте это ограничение в инструкции сопровождения. Сокращённое отображение не доказывает отсутствие остальных документов. Критерий полноты должен учитывать и структуру, и параметры макроса.

Проверка под читателем и границы доступа

Обычный читатель открывает опубликованную родительскую страницу в своей сессии и проходит тот же маршрут. Для опыта с ограниченной инструкцией заранее согласуйте доступ к одной нейтральной дочерней странице. Пользователь без права просмотра не должен видеть её в макросе; наличие права редактировать родителя само по себе не является проверкой всех дочерних разрешений.

Сверяйте и прямой URL: отсутствие ссылки не доказывает запрет доступа к документу. Ограничения просмотра наследуются вниз по ветке, а ограничения редактирования ведут себя иначе. Если родитель недоступен, результат его макроса вообще нельзя использовать для сравнения. Не проводите эту проверку через административный обход ограничений.

На Free нельзя настраивать ограничения так же, как на платных планах; при понижении плана могут сохраняться прежние настройки. Если тестовое ограничение недоступно, отметьте эту часть матрицы непроверенной и согласуйте доступный способ с администратором. Для проверки навигации менять тариф не требуется.

В пилоте используйте обычный вход в Confluence, без публичной ссылки. У публичного представления другой набор возможностей: большинство макросов, собирающих внешнее содержимое, в нём недоступны. Публичная ссылка также не является подходящей проверкой внутренних ограничений просмотра.

Матрица приёмки и диагностика

Ниже ожидаемые результаты для проверки, а не отчёт о выполненном испытании. Для каждого пункта запишите пользователя, URL родителя, настройки глубины, ожидаемые и фактические ссылки. Несовпадение разбирайте до удаления контрольного ручного перечня.

Если материал отсутствует, сначала найдите его по прямому адресу и посмотрите, где он расположен в дереве. Проверьте публикацию, права читателя и ограничения размера списка. Страница с похожим названием в соседнем разделе не становится дочерней автоматически. Переезд в другую ветку тоже требует пересмотра ожидаемой навигации.

• Один уровень: видны две исходные непосредственные дочерние инструкции.
• Два уровня: дополнительно доступна диагностическая страница под VPN.
• Соседний материал: не входит в список при обеих глубинах.
• Новая непосредственная дочерняя страница: появляется после публикации без правки перечня.
• Переименование учебной страницы: список показывает актуальную подпись, ссылка открывает нужный материал.
• Ограниченный читатель: видит только разрешённые документы; прямой доступ проверен отдельно.

Когда требуется другой способ навигации

Child items подходит для перечня, заданного фактической вложенностью. Если инструкции разбросаны по разным веткам и объединены только темой, не переносите их под одного родителя ради макроса. Сначала решите с владельцем базы знаний, должна ли тема стать частью структуры или нужна подборка по другому признаку.

Для раскрываемой иерархии рассмотрите Content tree, для разделов внутри одной страницы — Table of Contents. Это разные задачи: список дочерних материалов не является оглавлением заголовков текущей страницы. Если нужны владельцы, состояния и дополнительные столбцы, используйте отдельный реестр свойств, а не пытайтесь превратить навигацию в отчёт.

Не скрывайте документ перемещением из видимой ветки вместо настройки доступа. Скрытое положение в дереве не отменяет поиск и открытие по URL. Любое рабочее перемещение согласуйте отдельно: меняются контекст и возможное наследование ограничений. Проверка учебного списка не является основанием массово перестраивать пространство.

Откат и дальнейшее сопровождение

Если навигация не проходит проверки, удалите только добавленный макрос из родительской страницы и опубликуйте изменение. Верните сохранённый ручной перечень, если он был убран. Не удаляйте дочерние документы и не меняйте их ограничения ради восстановления внешнего вида входной страницы.

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

Назначьте владельца навигации. При добавлении нового раздела он проверяет родителя, глубину и доступ, а при переносе инструкции — её исчезновение из прежней подборки и появление в новой. Автоматический список снимает ручное ведение ссылок, но не заменяет решение о структуре и полноте базы знаний.