esa(エサ) からNotePMへデータ移行する

esaからのインポート仕様と、NotePMへデータを移行するための手順を紹介します。

インポート仕様

登録されるデータ

• インポートの対象は以下の通りです。

  • 記事
  • コメント
  • 記事やコメントに埋め込まれた画像や添付ファイル
  • テンプレートページ
  • タグ

• インポート機能では、esaのカテゴリ毎にプライベートノートを作成して記事をインポートします。

  サブカテゴリは、フォルダとして登録されます。

対応表

以下の項目の登録可能な文字数や文字種類は、NotePMの仕様を優先されます。
そのため、指定文字数でのカット処理や文字列置換が自動で実施される場合がございます。予めご了承ください。

• カテゴリ
• 記事タイトル
• 本文
• タグ
• コメント
• テンプレート

NotePMへデータを移行する

esa側の設定方法

NotePMからesaにアクセスするためのアクセストークンを取得

esaで「Owner」のロールを持つアカウントで実施してください。

1. esaのApplications画面（ URL：https://[チーム名].esa.io/user/applications）を開きます。
   

2. 「Personal access tokens」にある「Generate new token」をクリックします。
   

3. 「Token description」（トークンの説明）を入力して、Select scopes（スコープ）で「Read」にチェックしていることを確認して「Save」をクリックします。
   

   Token description の内容は任意ですが、NotePMへのインポート用など用途が分かる内容にします。

4. 表示された「Personal access token」をコピーして保管してください。
   

   作成されたアクセストークンはNotePM側の設定で使用します。

NotePM側の設定方法

1. NotePMのインポート画面を開き、esaタブを選択して以下情報を入力します。
   入力後は「インポート確認する」をクリックします。

   項目名	入力内容
   チームURL	https://チーム名.esa.io（esaのチームURL）
   APIトークン	先ほど取得した Personal access token（アクセストークン）

   インポート画面
   

   NotePMのインポート機能を利用できる権限は、オーナーのみです。

2. 「インポート確認する」をクリックすると、ユーザー紐づけ詳細画面へ遷移します。
   ユーザー紐づけ内容に問題ない場合は「インポート」をクリックします。
   ユーザー紐づけ詳細画面
   

   注意：ユーザーの紐づけができていないページの作成者・更新者は、NotePM-bot が設定されます。

   • ユーザー紐づけを修正したい場合、「キャンセル」 をクリックしてインポート画面へ戻ります。
   • esaユーザーのメールアドレスまたはNotePMユーザーのメールアドレスを変更した後、インポート画面の「インポート確認する」をクリックしてユーザー紐づけ詳細画面を再度開きます。

3. インポートを開始するかについて確認ポップアップが表示されるため「OK」をクリックします。
   

4. 「OK」をクリックすると、インポートが開始されます。
   インポート画面（インポート履歴）
   

5. インポートが正常終了した場合、ステータスが「完了」と表示されます。
   インポート画面（インポート履歴）
   

• データ移行スクリプト対応サービス
  • ファイルをNotePMに一括インポートする
  • WordファイルをMarkdown変換してNotePMにインポート
  • CSVファイルからNotePMのページを作成する
  • DocBaseから移行する
  • Kibelaから移行する
  • Qiita Teamから移行する

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

• NotePM ：テレワーク時代のクラウド型ナレッジ共有ツール