メインコンテンツへスキップ

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

 

esa NotePM

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

 

インポートの仕様

  • インポート機能では、esaのカテゴリごとにプライベートノートを作成して記事をインポートします。
  • 以下の項目の登録可能な文字数や文字種類は、NotePMの仕様を優先されます。
    そのため、登録できる上限を超えた文字は削除されたり、表示できる文字に自動的に変換される場合があります。
    • カテゴリ
    • 記事タイトル
    • 本文
    • タグ
    • コメント
    • テンプレート

  • 画像や添付ファイルは、本文に以下の形式で入力されたものがインポートの対象です。

    • 画像ファイル
      • imgタグ　 <img src="https://xxxxx/uploads/..." >
      • ![ファイル名](https://xxxxx/uploads/...)
    • 添付ファイル
      • videoタグ <video src="https://xxxxx/uploads/..." >
      • [ファイル名](https://xxxxx/uploads/...)

    上記URLのドメイン（xxxxx）は、以下のものになります。
    files.esa.io dl.esa.io img.esa.io esa-storage-tokyo.s3-ap-northeast-1.amazonaws.com

登録されるデータ

  • 記事
  • コメント
  • 記事やコメントに埋め込まれた画像や添付ファイル
  • テンプレートページ
  • タグ
サブカテゴリは、フォルダとして登録されます。

 

対応表

esa 項目 NotePM 項目 補足
カテゴリ

ノート

（またはフォルダ）

 カテゴリ毎にプライベートノートが作成されます。
サブカテゴリはフォルダとして登録されます。
カテゴリがない「no category」に属する記事は、
「no category」というプライベートノートを作成され、
その直下にインポートされます。
記事タイトル ページタイトル 記事タイトルに以下の実体参照値が使用されている場合、置き換えられます。
・実体参照値： &#35; → 置換後：#
・実体参照値： &#47; → 置換後：/
本文 ◯  
タグ ◯  
作成者 ◯ ユーザーを紐づけることができない場合「NotePM-bot」が設定されます。
作成日時 ◯  
更新者 ◯ ユーザーを紐づけることができない場合「NotePM-bot」が設定されます。
更新日時 ◯  
コメント ◯  
コメント作成者 ◯ ユーザーを紐づけることができない場合「NotePM-bot」が設定されます。
コメント作成日時 ◯  
コメント更新日時 ◯  
画像 ◯ 記事内に埋め込まれた画像ファイルは、NotePMにアップロードされ、
記事内のURLはNotePMのURLに置き換えられます。
画像ファイルの登録者は、記事の作成者が設定されます。
添付ファイル ◯ 記事内に埋め込まれた添付ファイルは、NotePMにアップロードされ、
記事内のURLはNotePMのURLに置き換えられます。
添付ファイルの登録者は、記事の作成者が設定されます。
テンプレート テンプレート NotePMのテンプレート一覧に登録されます。
WIP △ ページタイトルの先頭に[WIP]という文字列を付与されます。

 

NotePMへデータを移行する

esa側の設定方法

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

  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側の設定方法

NotePMのインポート機能を利用できるのは、オーナーだけです。
  1. 右上［ユーザー名］＞［その他］＞［インポート］をクリックします。

  2. esaタブを選択して以下の情報を入力し、［インポート確認する］をクリックします。
    3. 項目名 入力内容
    チームURL https://チーム名.esa.io（esaのチームURL）
    APIトークン 先ほど取得したPersonal access token（アクセストークン）
    ▼インポート画面

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

    ▼ユーザー紐づけ詳細画面

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

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

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

  5. ［OK］をクリックすると、インポートが開始されます。

    ▼インポート画面（インポート履歴）

  6. インポートが正常終了した場合、ステータスが「完了」と表示されます。

    ▼インポート画面（インポート履歴） 

    3dbbd218-590a-11ee-8948-06720a606bea_thumb.png

関連記事