Notionへのデータ移行体験談とTIPS

Notionへの データ移行体験談とTIPS Notion Meetup 2023/11/08 ニフティ株式会社 石川 貴之

自己紹介 ニフティ株式会社 会員システムグループ N1! テックリード 石川 貴之 (Ishikawa Takayuki) 担当業務 ● ● ● AWS/GCP組織管理 技術寄りSaaS管理（Atlassian, Notion, GitHubなど） 自社WEBサービスのクラウドアーキテクト、バックエンド 2

本日お話しする項目 データへのアプローチ 人へのアプローチ 会社へのアプローチ ● 移行先調査・選定 ● 移行・導入説明 ● 予算管理 ● 掃除 ● Notion講習 ● 稟議 ● 分類分け ● 普及促進 ● セキュリティ・監査 ● 配置決め ● サポート ● 普及・移行状況報告 ● 移行作業 ←本日はここ

Atlassian製品からの移行 2015年から利用しているJira/Confluence Serverを2022年にNotionへ移行 開発プロジェクト管理として利用していたJiraはGitHub Issuesへ移行 参考：Spring Framework's Migration from Jira to GitHub Issues

• https://spring.io/blog/2019/01/15/spring-framework-s-migration-from-jira-to-github-issues

目次 ● Confluenceからの移行 ○ 付録 ● Jiraからの移行 ● まとめ

Confluenceから の移行

NotionのConfluence Importerを利用 Confluence Importer 2.0 - API Importerが追加 Zip-file ImporterがServer版をサポート 2022年時点では2.0になる前。 Server版非対応のままどう移行したのか、もう 使えないノウハウもありますが供養として紹介 します。 https://www.notion.so/help/import-from-confluence

• https://www.notion.so/help/import-from-confluence

移行できるもの・できないもの 移行できる ページ ブログ スペース - 最新版のページ 最新版のブログ（ページへの変換が必要） 最新版の添付ファイル ページ階層 同一スペース内のページリンク（自動変換） Confluenceマクロ（HTMLのみで再現可能なもの） なし 移行できない - 移行用ユーザーに権限がない制限ページ ページ履歴 ページコメント ページ制限 ラベル 添付ファイル履歴 作成日/者、最終更新日 /者情報 Confluenceマクロ（HTMLのみで再現されないもの） ページ内にリンクされてない添付ファイル 別スペースにあるページへのリンク（変換されない） ユーザーへのメンション（テキストになる） - サイドバーの情報 スペース権限 ゴミ箱、下書き スペーステンプレート

Confluence Notion

Confluenceへの移行手順（2.0以前） ※Schedule jobにあるClean Temporary Directoryで消されないよう注意

Server版のhtmlに手を加える 当時Server版はサポート外だったのでCloud版のエクスポートhtmlっぽく編集。 htmlの構造さえCloud版に近くなっていれば元がなんであれ綺麗にインポートされる。 Confluence Importer 2.0なら不要 - 文字色を移行される近い色に変更 内部ページリンクの aタグにdata-linked-resource-typeを追加 添付ファイルの pタグにclassを追加 テーブルにclassを追加、セル内に pタグ追加 いまでも必要 - jsに依存している部分を htmlのみの表現に変更（ Google Drive/Docs for Confluenceなど） デフォルトの変換では落とされている情報をページ内に移動

ConfluenceからNotionへの移行アドバイス ★ Confuence Importerに任せておけばページ内はほぼ大丈夫 ○ ★ いまなら移行後にすぐ Wiki化するのが使いやすそう Confluenceのエクスポート時に落とされた情報もhtmlに手を入れれば移行できる ○ 作成日/者・最終更新日 /者をhtml書き換えて移行対象にすればよかった ■ ○ ★ 自身が管理していないページだと移行後に情報の新旧が判別しにくい コメントも重要な役割を持っていた場合は html書き換えて持っていくと良い インポートを行うユーザーはBotユーザーにしよう ○ 監査ログには移行したページ分 Page created が記録されるので分けた方が集計しやすい ○ 後々ページ作成者だと間違われるのを防止

付録 Confluence to Notion

主な変換挙動詳細（2.0対応） - id=”main-content”が移行対象（作成者・最終更新日から上、いいねボタンから下は移行対象外） h4は太字・下線、 h5は下線になる ページ内でリンクされていないファイルは移行されない （Drow.ioのsvgファイルも移行されない） テーブルのセル結合はなくなる テーブルのセルの色付けはなくなる、セル内はテキストになる テーブルのセル内に画像や添付ファイルがあるとデータベースに変換される Statusマクロは背景色グレーのテキストになる ユーザーメンションはテキストになる iframeで埋め込んだものは移行される Codeマクロのhighlightは引き継がれる、アドオンで追加した言語だと Plain Textになる NoformatマクロはCallout > Codeになる Confluence上でHTMLやテーブルが壊れている（セル欠損）と そのページ全体が移行されない エクスポートファイルのみ（ htmlのみ）で稼働するならアドオンによる表現も移行される

よくあるインポートエラー ● ● ● インポート処理が終わらない ○ Notionの内部API(v3のやつ)が返す移行ステータスが永遠と変わらない現象 ○ 移行されたページを見て終わったかどうか判断する ○ 終わってなかったらログアウト・ログインしてから再度インポートしてみる Validating file… で止まっている ○ zipファイルを作成した環境の問題か検証中から進まない現象 ○ 別環境で解凍して再度 zipにすると通った（謎） Import failed. アラートが起きた ○ エラー落ちしてインポート済みページ群が勝手にゴミ箱に入れられる現象 ○ スペース内で一番親のページ名で検索してゴミ箱からサルベージ可能 ○ インポートログは残っているため原因となるページが特定できる場合もある

よくある変換漏れ・移動エラー ● 空ページになる、ページ抜けがある ○ HTMLが壊れている（タグの不一致、不正な入れ子） ○ 変換できない HTMLが書かれている（アドオンのマクロや html直書きで起きやすい） ○ エクスポートしたユーザーに権限がない制限ページになっている ■ ● ● confluence-administrators だとしても権限がないとエクスポートできないので注意 スペース内のページリンクが変換されていない ○ マクロとしてのページリンクではなく文字列としてのリンクになっている ○ インポート単位では自動変換されるが複数に区切っていると変換されない インポート後にページを移動できない ○ 大量のページを持つ親ページを移動させる際はサイドバー上の D&DではなくMove toを使う

Jiraからの移行

専用Importerがないので自力 JiraはServer版もCloud版もImporterはありません。 今回はJiraのエクスポート機能（一覧表示の情報のみ）とAPI（Issue自体の情報）を2つ 組み合わせて移行を行いました。

Jira Notion

Jiraの移行手順

Jiraの移行はアーカイブが目的 移行したデータベースはアーカイブとして保存し、 新規にデータベースを作成して運用するのがよいと思います。 継続して移行したデータに追加・編集し続けるのではなくアーカイブ目的とすることで、 以下を考慮して移行する必要がなくなります。 ● フィールドマッピング、ユーザーマッピング ○ 移行時の大量通知問題 ○ 過去データと新規データでプロパティ分けたい問題 ● ユニークIDとIssue IDの番号揃え ● Wiki記法の変換

JiraからNotionへの移行アドバイス ★ ★ Jiraはフロー情報であることのほうが多いのでそこまで移行を頑張らない ○ 重要度次第だが Jiraは移行せずエクスポートして Google Driveに突っ込むだけでもいいと思う ○ Jiraのデータを移行したデータベースを使うより、新規でデータベース作った方が綺麗 Notionでどのレベルのタスク管理まで担わせるか事前に決める ○ ★ リポジトリと密に繋がる開発プロジェクト管理はJira継続か他のツールへ移行しよう ○ ★ 完全な代替とはならないので、移行するにしても向き不向きは利用者に伝えておく Notionでそこまでやるのは現状かなり厳しい インポートを行うユーザーはBotユーザーにしよう ○ Confluenceのときと一緒

まとめ

移行アドバイスまとめ 移行方針 ★ Jiraの移行はアーカイブ目的と割り切った方が楽 ★ Importerの仕様は変わることがあり移行期間は短い方がいい（1年は長すぎた） 移行作業 ★ ★ Confluence Serverのエクスポートhtmlの手直しは手間かかるがやる価値はある ○ アドオンも移行要素に含めたいならやろう ○ ページの作成日 /者と最終更新日 /者も移行要素に入れた方がいい（やればよかった） 専用のBotユーザーを使ってインポートしよう

参考 Notion全社導入に伴う移行とデータ整理のノ ウハウ | ドクセル Notionで社内情報をスムーズに検索！ 移行前の大掃除と再配置で効率アップ NIFTY engineering

• https://www.docswell.com/s/14kw/Z6YYYV-know-how-for-notion-implementation-migration-and-data-organization
• https://engineering.nifty.co.jp/blog/14534

宣伝 Notionへの移行が終わって 1年経ったから話せる導入時や運用後のうまくいった・よくなかった話を 11月18日にする予定です。気になる方は NIFTY Tech Day 2023 - connpass へご登録お願いします！

• https://nifty.connpass.com/event/300040/

Copyright © NIFTY Corporation All Rights Reserved.