Qiita Team(キータチーム) からNotePMへデータ移行する

Qiita Team NotePM

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

インポート仕様

登録されるデータ

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

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

  • インポート機能では、Qiita Teamのグループ毎にプライベートノートを作成して記事をインポートします。

    Qiita Teamでパブリックグループの場合でも、プライベートノートで作成されます。

  • Qiita Teamの仕様上、Qiita Teamのプライベートグループは、インポートで使用するアクセストークンのユーザーが所属するグループのみが移行対象となります。

  • Qiita Team APIの仕様制約により、Qiita Teamに10,000件以上の記事が登録されている場合、全ての記事がインポートされない可能性があります。

対応表

Qiita Team 項目 NotePM 項目 補足
グループ ノート グループ毎にプライベートノートが作成されます。記事はプライベートノート直下にインポートされます。
タイトル ページタイトル
本文 ◯
タグ ◯ タグ名がインポートされます。タグに設定したバージョン情報はインポートされません。
作成者 ◯ ユーザーが紐づけできない場合「NotePM-bot」が設定されます。
作成日時 ◯
更新日時 ◯ 編集履歴がある記事の場合、更新者は「作成者」が設定されます。
コメント ◯
コメント作成者 ◯ ユーザーが紐づけできない場合「NotePM-bot」が設定されます。
コメント作成日時 ◯
コメント更新日時 ◯
画像 ◯ 記事内に埋め込まれた画像ファイルはNotePMへアップロードされ、記事内のURLはNotePMでのURLに置換されます。画像ファイルの登録者は、記事の作成者が設定されます。
添付ファイル ◯ 記事内に埋め込まれた添付ファイルはNotePMへアップロードされ、記事内のURLはNotePMでのURLに置換されます。添付ファイルの登録者は、記事の作成者が設定されます。
テンプレート テンプレート NotePMのテンプレート一覧に登録されます。

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

  • グループ
  • タイトル
  • 本文
  • タグ
  • コメント

NotePMへデータを移行する

Qiita Team側の設定方法

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

Qiita:Teamで「オーナー」または「管理者」の権限があるアカウントで実施してください。

  1. Qiita Teamのアプリケーション画面（ URL：https://teams-center.qiita.com/settings/applications）を開きます。

  2. 「個人用アクセストークン」の「新しくトークンを発行する」をクリックします。

  3. 「アクセストークンの説明」を入力して、スコープで「read_qiita_team」にチェックしていることを確認して「発行する」をクリックします。

    アクセストークンの説明 の内容は任意ですが、NotePMへのインポート用など用途が分かる内容にします。

  4. 表示された「個人用アクセストークン」をコピーして保管してください。

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

NotePM側の設定方法

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

    項目名 入力内容
    チームURL https://チーム名.qiita.com（Qiita TeamのチームURL）
    APIトークン 先ほど取得した「個人用アクセストークン」

    インポート画面

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

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

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

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

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

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

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

　

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

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