ConfluenceからNotePMへ移行する

confluence NotePM

この記事ではConfluenceからNotePMへ移行する方法と、プログラムの使い方を紹介します。

Confluenceからのデータエクスポート

Confluenceのスペース設定にエクスポートタブがあります。エクスポートの形式はHTMLを選択してください。

次へを押すと、エクスポートオプションが出ます。これは通常のエクスポートを選択してください。

エクスポートボタンを押すと、データが作成されてダウンロードが実行できるようになります。ダウンロード形式はZipファイルになります。

エクスポートされたデータの形式は次のようになっています。

この内 images と styles は利用しません（あっても問題ありません）。

ではここからCSVファイルをNotePMへ取り込む手順を紹介します。まず、プログラムをインストールします。必要なものは次の通りです。

Node.jsはここからダウンロードできます。ダウンロード後、インストールを実行してください。

プログラムはNode.jsをインストールした環境であれば、次のコマンドでインストールできます。

npm install notepm_importer -g

NotePMのアクセストークンは個人設定のAPIアクセストークンから取得できます。

そしてアクセストークンを新規作成してください。スコープとして、読み込みと書き込みの両方にチェックを付けてください。

生成されたアクセストークンは、再確認する方法がありません。必ずコピーしたり控えておいてください。

Confluenceのエクスポートデータにはユーザ名（氏名）が一部しか記述されていません。そこで、Confluenceのユーザ名（氏名）とNotePMの紐付けを行います。ベースになる設定ファイルは次のように出力できます。

notepm-users -a ACCESS_TOKEN -t TEAM_DOMAIN

実行すると、次のようにYAMLファイルの内容が出力されます。

users:
  -
id:
name: プロジェクト太郎
user_code: "0000000001"
  
  -
id:
name: プロジェクト花子
user_code: "0000000002"

この内容をたとえば users.yaml として保存します。その後 id の後にConfluenceのユーザ名（氏名）を記入してください。たとえば次のような内容にします。

users:
  -
    id: 太郎鈴
    name: プロジェクト太郎
    user_code: "0000000001"
  
  -
    id: 花子鈴
    name: プロジェクト花子
    user_code: "0000000002"

これで準備完了です。

ではインポートを実行します。コマンドは次のようになります。

notepm-confluence \
  -p PATH_TO_HTML \
  -a ACCESS_TOKEN \
  -t TEAM_DOMAIN \
  -u PATH_TO_SETTING_YAML

内容は次の通りです。

スペース名でノートが作成されます。内容は次の通りです。

ノートはプライベートで作成されます。調整後、公開してください。

各HTMLファイルがページとして取り込まれます。Confluenceではページの下に子ページを追加できます。NotePM上ではページ名を使ってフォルダを作成し、その中に子ページを保存します。

取り込む際の注意点は次の通りです。

おすすめの情報共有ツール