Как перенести таблицу из Confluence в Excel: от ручного копирования до автоматизации

Работа с данными в Confluence удобна для совместного редактирования, но когда требуется аналитика, фильтрация или сложные вычисления, без экспорта в Excel не обойтись. Проблема в том, что стандартные инструменты Atlassian не всегда предлагают прямой путь для выгрузки — особенно если таблица содержит вложенные страницы, макросы или форматирование. В этой статье разберём все актуальные способы переноса данных, от простейшего копирования до автоматизации через REST API, с учётом нюансов версий Confluence Server/Data Center и Cloud.

Важно понимать: метод экспорта зависит от структуры таблицы, её размера и ваших прав доступа. Например, таблицу с 5 строками можно скопировать вручную за секунды, а для выгрузки отчёта на 10 000 строк потребуется скрипт или плагин. Мы проанализировали каждый вариант по критериям скорости, точности и технической сложности — данные сведены в сравнительную таблицу ниже.

1. Ручной экспорт: копирование и вставка

Самый очевидный способ — выделить таблицу в Confluence и вставить её в Excel (или Google Sheets). Он работает в 90% случаев, но имеет ограничения:

• 📋 Подходит для таблиц до 500 строк — при большем объёме данные могут "съехать" или потерять форматирование.
• 🎨 Сохраняет базовое форматирование (жирный текст, цвета ячеек), но теряет ссылки, макросы и вложенные страницы.
• ⚡ Быстро — занимает менее минуты, если таблица простая.

Как скопировать правильно:

1. Выделите таблицу в Confluence вместе с заголовками (кликните на иконку таблицы в левом верхнем углу).
2. Нажмите Ctrl+C (или Cmd+C на Mac).
3. Откройте Excel и вставьте данные через Ctrl+V.
4. Если данные "разъехались", используйте функцию Текст по столбцам (Data → Text to Columns).

Когда этот метод не подходит:

• 🚫 Таблица содержит вложенные страницы или динамические макросы (например, JIRA Issues).
• 🚫 Нужно сохранить историю изменений или метки версий.
• 🚫 Данные обновляются автоматически (например, через SQL-макросы).

2. Экспорт через плагины: расширения для Confluence

Если ручное копирование не подходит, используйте плагины из Atlassian Marketplace. Они добавляют кнопки экспорта прямо в интерфейс Confluence и поддерживают форматы .xlsx, .csv, а иногда и .pdf. Популярные решения:

Как установить плагин:

1. Перейдите в Администрирование → Управление приложениями.
2. Найдите плагин по названию в Marketplace.
3. Нажмите Установить и подтвердите права доступа.
4. После установки на странице с таблицей появится кнопка Export to Excel.

Предупреждение о безопасности:

⚠️ Внимание: Плагины от сторонних разработчиков могут запрашивать доступ к данным вашей страницы. Перед установкой проверьте рейтинг вендора и отзывы. Избегайте плагинов с правами ACT_AS_USER или ADMIN, если они не сертифицированы Atlassian.

3. Экспорт через REST API: для технических пользователей

Если вам нужно автоматизировать выгрузку или работать с большими объёмами данных, используйте Confluence REST API. Этот метод требует знаний Python, Bash или Postman, но даёт полный контроль над процессом.

Базовый алгоритм:

1. Получите API-токен в личном кабинете Atlassian (Account Settings → Security → API tokens).
2. Найдите pageId или spaceKey страницы с таблицей (они видны в URL).
3. Выполните GET-запрос к эндпоинту /wiki/rest/api/content/{pageId}?expand=body.storage.
4. Распарсьте ответ (формат HTML или XHTML) и извлеките данные таблицы.
5. Сохраните в .xlsx с помощью библиотеки openpyxl (Python) или xlsx (Node.js).

Пример скрипта на Python:

import requests
from openpyxl import Workbook

Настройки
API_TOKEN = "ваш_токен"
EMAIL = "ваш_email@domain.com"
PAGE_ID = "12345678"  # ID страницы Confluence
URL = f"https://ваш_домен.atlassian.net/wiki/rest/api/content/{PAGE_ID}?expand=body.storage"

Запрос данных
auth = (EMAIL, API_TOKEN)
response = requests.get(URL, auth=auth)
data = response.json()
html_content = data["body"]["storage"]["value"]

Парсинг таблицы (упрощённо)
from bs4 import BeautifulSoup
soup = BeautifulSoup(html_content, "html.parser")
table = soup.find("table")

Создание Excel-файла
wb = Workbook()
ws = wb.active
for row in table.find_all("tr"):
for cell in row.find_all(["th", "td"]):
ws.append([cell.get_text(strip=True)])
wb.save("confluence_table.xlsx")

Нюансы API-экспорта:

• 🔗 Для Confluence Server URL будет другим: /rest/api/content/{pageId}?expand=body.storage (без поддомена wiki).
• 🛠️ Если таблица сгенерирована макросом (например, SQL или JIRA), её данные могут не попасть в body.storage. В этом случае используйте эндпоинт /macro/body.
• 📊 Для сложных таблиц (с объединёнными ячейками) потребуется доработка парсера.

4. Экспорт через Google Sheets: обходной путь

Если у вас нет доступа к плагинам или API, но есть Google Account, можно использовать Google Sheets как промежуточный формат. Этот метод подходит для таблиц среднего размера (до 2 000 строк) и сохраняет базовое форматирование.

Инструкция:

1. Скопируйте таблицу из Confluence (Ctrl+C).
2. Откройте Google Sheets и вставьте данные (Ctrl+V).
3. Проверьте структуру: если данные "разъехались", используйте Data → Split text to columns.
4. Экспортируйте в Excel: Файл → Скачать → Microsoft Excel (.xlsx).

Преимущества метода:

• 🌐 Работает на любом устройстве (включая мобильные).
• 🔄 Автоматическое исправление кодировки (важно для кириллических символов).
• 📊 Поддержка формул (если они были в исходной таблице).

5. Автоматизация через Power Query (для продвинутых)

Если вам нужно регулярно обновлять данные из Confluence в Excel, настройте автоматическую выгрузку через Power Query (доступно в Excel 2016+ и Office 365). Этот метод требует первоначальной настройки, но потом обновляет данные в один клик.

Пошаговая инструкция:

1. В Excel перейдите на вкладку Данные → Получить данные → Из других источников → Из веб.
2. Вставьте URL страницы Confluence (например, https://ваша_компания.atlassian.net/wiki/spaces/SPACEKEY/pages/PAGEID).
3. В открывшемся окне выберите таблицу (Power Query автоматически распознает HTML-таблицы).
4. Нажмите Загрузить — данные появятся в новом листе.
5. Для обновления кликните Данные → Обновить все.

Ограничения:

• 🔒 Работает только для публичных страниц или если у вас есть доступ к Confluence без входа (настройка Anonymous Access).
• 🛠️ Если страница требует аутентификации, используйте Power Query с API-токеном (настройка через Дополнительные параметры → Заголовки).

Проверьте, что страница Confluence доступна без логина (или настройте токен)

Убедитесь, что таблица имеет чёткую HTML-структуру (теги

import schedule
import time
from confluence_api import export_to_excel  # ваша функция

def daily_export():
export_to_excel(page_id="12345", output="report.xlsx")

schedule.every().day.at("09:00").do(daily_export)
while True:
schedule.run_pending()
time.sleep(60)