Confluenceからのインポート

すべてのデータを1か所にまとめることは重要です。ConfluenceスペースをNotionにインポートするための役立つチュートリアルをご紹介します。ニーズに合わせて、ConfluenceからNotionへインポートする方法は2つあります。

• Zipファイルインポーター: ワークスペースの一部のみをインポートする場合に使用できます。最大5GB（リクエストにより最大15GB）までの小規模なワークスペースのみインポート可能です。

• APIインポーター: ワークスペース全体のみをインポートできます。最大30GBまでのワークスペースをインポート可能です。コメントとユーザーマッピングは保持されます。

複数スペースのインポート: 最大10個のConfluenceスペースを、UIから直接一度にインポートできます。選択した各Confluenceスペースは独自のログページを生成し、個別のトップレベルのプライベートページとしてインポートされます（必要に応じて異なるNotionチームスペースにインポートされます）。この機能はビジネスプランおよびエンタープライズプランでのみ利用可能です。

• Confluenceサイト → Notionの組織

• Confluenceスペース → Notionワークスペース

• Confluenceページ → Notionページ

• マクロ → 変換されたコンテンツまたは最も類似したNotionブロックタイプ（例：Confluenceの展開 → Notionトグル）

• 最大約5万ページまたは30GBまでのサイズをインポートできます。これを超えるインポートは失敗する可能性があります。

  • ヒント: 大規模なスペースの場合は、サブスペースやセクションごとにエクスポートを分割し、ZIPインポーターを使用してください。ワークスペースのサイズが100GBを超える場合は、アカウントマネージャーにお問い合わせください。

• インポートが開始されたら、ブラウザを閉じても問題ありません。インポートが完了したら、通知メールを送付します。

• インポートの進捗状況は、設定 → インポートで確認できます。そこで、インポートのステータスや完了したインポートを確認できます。

ConfluenceのスペースをHTMLにエクスポートする

1. Confluenceのワークスペースで、右上のサイドバーのスペース設定を開きます。

2. 上部のツールバーから コンテンツツール を選択し、そのすぐ下のツールバーから エクスポート を選択します。いずれも表示されていない場合、ワークスペースの管理者にエクスポート権限の付与を依頼する必要があります。

3. 形式のリストからHTMLを選択します。

4. カスタムエクスポートを選択し、コメントを含めるボックスのチェックを外します。

5. エクスポートしたいページを選択します。大容量の添付ファイルを含むページがあると、エクスポートサイズが大幅に大きくなり、手順が非常に煩雑になるためご注意ください。

6. エクスポートの処理が終わるまで待ちます。大規模なワークスペースの場合、時間がかかる場合があります。

7. 完了したら、ダウンロードをクリックして、エクスポートしたファイルをコンピュータに保存します。ファイル名は Confluence-space-export-XXXXXX.html.zip のようになります。

Notionにインポートする

1. ConfluenceのコンテンツをインポートするNotionのワークスペースに移動します。

2. サイドバーの設定 → インポート → サードパーティのインポート → Confluenceの順に移動します。

3. Confluenceからエクスポートした.zipファイルを選択し、アップロードします。.zipファイルの解凍は不要です。アーカイブ全体をアップロードしてください。

4. 「アップロード中...」というメッセージに続き、インポートの進捗に合わせてステータスが表示されます。

5. インポートが完了すると、新しくインポートされたコンテンツに移動します。

ConfluenceとNotionの接続

1. サイドバーの設定 → インポート → Confluenceの順に移動します。

2. API経由でインポートを選択します。

3. Confluenceのインスタンスタイプ（クラウドまたはサーバー）を選択します。インスタンスタイプを確認するには、Confluenceを開き、プロフィールの横にあるヘルプ → ? → Confluenceについての順にクリックします。Notionはクラウドおよびサーバーインスタンスのみをサポートしています。

Confluence Cloudでの認証

1. Confluenceのメールアドレスとサイトを入力します。

2. AtlassianアカウントからAPIトークンを作成し、フィールドに入力します。 Confluenceでのトークンの作成について詳しくはこちらをご参照ください。

3. 認証をクリックします。

Confluence Serverでの認証

1. Confluenceのバージョンを確認し、選択します。

2. Confluenceのメールアドレスとサイトを入力します。

3. Confluence 7.9以降のバージョンをご使用の場合は、個人用アクセストークンを作成して貼り付けます。それより前のバージョンをご使用の場合は、Confluenceのユーザー名とパスワードを入力してください。

4. 認証をクリックします。

インポート

1. インポートメニューからConfluenceをクリックします。

2. インポートの進捗状況を確認します。このステップは、スペースのサイズによっては数時間かかる場合があります。

   • ページをインポートしています...のメッセージが表示されたら、ブラウザウィンドウを閉じても問題ありません。インポートが完了したら、メールでお知らせします。

3. 複数のConfluenceスペースをインポートする場合は、このセクションの手順を繰り返してください。

• Notionは、すべてのコンテンツをプライベートセクション内の単一のルート/親スペースに、またはインポートを行うユーザーが選択したチームスペースにインポートします。

• ユーザーは、他のユーザーを招待する前に、ワークスペースの構造を整理し、設定することが求められます。

• Notionで権限を再適用する必要があります。Confluenceのグループと制限をNotionのグループ、チームスペース、ページレベルの権限にマッピングするため、インポート後の作業を計画してください。

• Confluenceテーブルにファイルまたは添付ファイルがある場合、そのテーブルはNotionデータベースになります。それ以外の場合は、シンプルテーブルになります。

• テーブルのスタイル設定やマクロ/プラグインは、多くの場合崩れます（例：UI手順、コールアウト、画像のキャプション）。

• ほとんどのマクロはサポートされていません。Notionはデータを最も近いNotionブロックにマッピングしようとします。

• Confluence APIの信頼性の低さによる一時的な障害により、インポート全体または特定のページのインポートが失敗する可能性があります。インポート全体をやり直す必要がある場合があります。

• 複数のスペースがある場合、マルチスペースインポート（ビジネスプラン/エンタープライズプランのみ）を使用しない限り、インポートを順次（一度に1つのスペースずつ）実行します。

• 複雑なConfluenceデータ（例：結合されたセル、テーブルの中のテーブル）の場合、インポートに失敗することがあります。

• NotionはユーザースコープのAPIトークンのみをサポートしています（スコープ付きトークンはサポートしていません）。認証時には個人用APIトークンのオプションを使用してください。

• ページで参照されていない添付ファイルやメディアはインポートされません。

• 場合によっては、階層が完全に保持されないことがあります。試験的なインポートで確認してください。

• LaTeX数式ブロックが正しくインポートされない

  • 原因: ConfluenceのLaTeXプラグインのブロックマクロ形式は、インライン数式とは異なります。NotionはインラインLaTeXマクロをサポートしていますが、ブロックマクロ形式はサポートしていません。

  • 対処方法：再インポートする前に、ConfluenceでLaTeXブロックマクロをインラインマクロに変換するか、LaTeXをコードブロックに配置し、インポート後に手動で数式ブロックに変換します。

• Gliffyコンテンツをインポートできない

  • 原因：Notionは、ファイルインポーターを介したGliffy画像のインポートをサポートしていません。

  • 対処方法：インポート前に、Gliffyブロックを正しいファイルを参照する画像ブロックに置き換えるようにHTMLを変更してください。

• インポートが失敗する

  • 原因：非常に大規模なスペース、不適切な形式のエクスポートファイル、レート制限、タイムアウト。

  • 対処方法：一度に1つのスペースずつインポートするか、大きなスペースを複数のセクションに分割するか、問題のないZIPファイルを再エクスポートするか、APIインポーターをスコープ指定付きで実行します。

• インポートで画像や添付ファイルが欠落している

  • 原因：エクスポートバンドルにアセットが含まれていないか、APIトークンでアクセスできない可能性があります。

  • 対処方法：エクスポート時に「添付ファイルを含める」が選択されていることを確認するか、ZIP内の相対パスをそのまま保持するか、インポート後に主要なアセットを再アップロードします。

• インポート後にJiraリンクプレビューが機能しない

  • 原因：Jiraリンクプレビューは、移行を開始する前にユーザーが認証されている場合にのみ機能します。

  • 対処方法：移行を実行する前に、Jiraで認証します。

• ファイルの階層が想定どおりに保持されない

  • 原因：エクスポート構造または深層ネストにおける特殊なケース。

  • 対処方法：最初に代表的なサブセットでテストし、インポート後にNotionで再編成します。

• Confluenceのマクロや特別な書式設定が失われる：

  • 原因：サポートされていないマクロまたはアプリコンテンツ。

  • 解決策: Notionネイティブのブロックにマッピングします。『展開する』を『トグル』に、そして『対応事項』を「To-do」に変換してください。複雑なテーブルは簡略化するか、CSVにエクスポートしてからNotionデータベースにインポートしてください。

• Confluenceの権限がNotionに複製されない：

  • 原因：これは、セルフサービスのインポートでは予想されることです。

  • 対処方法：コンテンツがNotionに移行された後、Notionのグループ、チームスペース、ページレベルの権限を使用して、権限のマッピングを計画、実行してください。