【Googleドキュメント】Confluence記事のDocsエクスポート!Atlassianからの移行

ConfluenceからGoogleドキュメントへの移行を考えている方も多いでしょう。Confluenceで管理している記事を一括でエクスポートし、Googleドキュメントに取り込む方法を解説します。本記事では、Confluenceの標準機能を使ってHTML形式でエクスポートし、Googleドキュメントにインポートする手順を紹介します。これにより、ドキュメント管理をGoogle Workspaceに統一できます。移行作業をスムーズに進めるために、具体的な操作と注意点を詳しく説明します。

ConfluenceからGoogleドキュメントへの移行方法とそのメリット

ConfluenceはAtlassian社のプロジェクト管理ツールで、多くの企業でドキュメント管理に利用されています。しかし、Google Workspaceに統一したい場合や、コスト削減のためにConfluenceから移行するケースが増えています。Confluenceにはスペース全体をエクスポートする機能があり、HTML、XML、PDFなどの形式で出力できます。このうちHTML形式をGoogleドキュメントにインポートすることで、記事の内容をほぼそのまま再現できます。移行の最大のメリットは、Googleドキュメントのリアルタイム共同編集やクラウド保存を活用できる点です。また、Googleドライブとの連携により、ファイル管理が一元化される利点もあります。

Confluence記事をGoogleドキュメントに移行する具体的な手順

Confluenceからエクスポートする手順

1. Confluenceにログインします
   移行元のConfluenceインスタンスに管理者権限でログインします。通常はシステム管理者アカウントが必要です。
2. スペースツールを開きます
   エクスポートしたいスペースに移動し、画面右上の歯車アイコンから「スペース設定」を選択し、「スペースツール」をクリックします。
3. 「スペースをエクスポート」をクリックします
   「コンテンツツール」セクションにある「スペースをエクスポート」リンクをクリックします。
4. 形式を選択します
   エクスポート形式として「HTML」を選びます。XMLやPDFもありますが、Googleドキュメントへのインポートに適しているのはHTMLです。
5. エクスポートを実行します
   「エクスポート」ボタンを押し、ZIPファイルのダウンロードが始まります。ファイルサイズが大きい場合は時間がかかることがあります。

エクスポートしたファイルをGoogleドキュメントにインポートする手順

1. ZIPファイルを解凍します
   ダウンロードしたZIPファイルを右クリックして「すべて展開」を選択します。解凍後、HTMLファイルが含まれていることを確認します。
2. Googleドキュメントを開きます
   Googleドライブにアクセスし、左上の「新規」ボタンから「Googleドキュメント」を選択して新しいドキュメントを作成します。
3. HTMLファイルをインポートします
   作成したドキュメントで、メニュー「ファイル」→「開く」をクリックします。次に「アップロード」タブを選択し、解凍したHTMLファイルを選択するか、直接ドキュメントにドラッグ&ドロップします。
4. 変換完了を確認します
   インポートが完了すると、Confluenceの記事がGoogleドキュメントに表示されます。見出しや本文、リスト構造がおおむね保持されています。

書式の調整と注意点

1. 見出しの階層を確認します
   Confluenceの見出し(h1〜h6)はGoogleドキュメントの見出しスタイル(タイトル、見出し1〜6)に変換されます。ただし、階層がずれる場合があるため、正しいスタイルが適用されているか確認します。
2. リンクと画像を修正します
   内部リンクは相対パスになっていることが多いため、絶対パスに変更します。画像は別フォルダに保存されているので、Googleドライブにアップロードしてリンクを貼り直します。
3. 表のレイアウトを調整します
   複雑な表(結合セルや罫線など)は崩れることがあります。表のセル幅や行の高さを手動で調整してください。
4. 特殊文字やコードブロックを確認します
   ConfluenceのコードマクロはGoogleドキュメントではプレーンテキストになるため、必要に応じて書式設定を適用します。

移行時によく発生する問題とその対処法

インポート後に文字化けが発生する場合

HTMLファイルの文字コードがUTF-8でない場合、日本語が文字化けすることがあります。Confluenceのエクスポート設定でエンコードをUTF-8に指定するか、ダウンロードしたHTMLファイルをテキストエディタ(メモ帳など)で開き、「名前を付けて保存」でUTF-8を選択してからインポートします。

画像が表示されない

Confluenceの画像はエクスポート時に「images」フォルダに保存されますが、HTML内のsrc属性が相対パス(例:images/photo.png)になっています。このままではGoogleドキュメントが画像を読み込めないため、画像フォルダごとGoogleドライブにアップロードし、HTML内の画像パスをGoogleドライブの共有リンクに書き換える必要があります。多数の画像がある場合は、正規表現を使って一括置換すると効率的です。

大量の記事を一括移行する方法

スペース全体をエクスポートすれば全記事を一度にダウンロードできます。ただし、記事数が多いとZIPファイルが巨大になり、アップロードにも時間がかかります。その場合は、スペースを複数の小さな単位に分割してエクスポートするか、ConfluenceのREST APIを使ってプログラム的に移行する方法もあります。APIを使用すれば、1記事ずつHTTPリクエストで取得し、Googleドキュメントに作成することが可能です。

書式が大きく崩れるケース

Confluenceで使用されているカスタムマクロやプラグインは、HTMLエクスポート時に適切に変換されません。例えば、Jira課題リンクマクロやPlantUML図などはプレーンテキストになるか、まったく出力されないことがあります。これらの要素は、移行後に手動で再作成する必要があります。移行前にConfluenceで使用しているマクロの一覧を確認し、代替方法を検討しておくとよいでしょう。

Confluenceエクスポート形式の比較

形式	長所	短所
HTML	Googleドキュメントに直接インポート可能で、ほとんどの書式が保持される	画像が別ファイルになるためリンク修正が必要
XML	構造データを保持しており、プログラムでの加工に適している	Googleドキュメントで直接開けず、変換ツールが必要
PDF	レイアウトが固定されており、印刷用に適している	編集が困難で、Googleドキュメントへの再現性が低い

まとめ

ConfluenceからGoogleドキュメントへの移行は、エクスポート機能とインポート機能を利用することで実現できます。HTML形式でのエクスポートが最も簡単で、ほとんどの書式が保持されます。インポート後はリンクや画像の修正が必要ですが、これによりドキュメント管理を一元化できます。移行計画を立て、まずはテスト用のスペースで手順を確認してみてください。慣れてきたら、APIやスクリプトを活用した自動化も検討すると良いでしょう。

📄

Googleドキュメントトラブル完全解決データベースこの記事以外にも、書式・共有・Apps Script・引用など様々な困りごとへの解決策をまとめています。逆引きに活用してください。