Jooto から取り込む
Jooto のプロジェクト（ボード）を、Nolto の既存プロジェクトに取り込む手順を説明します。プロジェクトのオーナーまたは管理者が、設定の「取り込み」から操作します。
できること・できないこと
タスク・コメント・添付・ラベル・チェックリストを取り込めます。取り込み後も差分を再実行し、Jooto で更新された項目を反映できます。
Nolto から Jooto への書き戻しや双方向同期には対応していません。行動履歴とガントの依存関係は取り込みません。Jooto に Wiki と共有ファイルはありません。
事前準備
Nolto に取り込み先のプロジェクトを作成します。作成者などをメールアドレスで照合するため、メンバーを先に招待しておいてください。料金ページの上限表で、課題数・保存容量がプランの上限に収まるかも確認します。
Jooto では、ビジネスプラン以上の組織で API キーを発行します。組織の設定 →「API キー」→「API キーを追加」を開き、説明を入力します。Jooto API 利用規約に同意して「追加」を押してください。手順は Jooto 公式のAPI キーの発行方法も参照できます。キーは組織のすべてのプロジェクトを読み取れます。
API キーは暗号化して保存され、画面には表示されません。取り込みが終わったら、Nolto の「接続を削除」と Jooto 側のキーの削除の両方を行ってください。組織の接続の場合は、組織の設定で接続を削除します。
組織の管理者が組織に接続を登録している場合は、プロジェクトでキーを用意しなくても取り込めます（次の章）。
組織で接続を共有する
同じ Jooto の組織 から複数のプロジェクトへ取り込むときは、組織の管理者が API キーを組織に登録し、使えるプロジェクトを指定できます。指定したプロジェクトでは、キーを入力せずに取り込めます。
| 操作 | できる人 |
|---|---|
| 接続の登録、キーの入れ直し、使えるプロジェクトの指定、削除 | 組織の管理者 |
| 組織の接続を使った取り込み | 指定したプロジェクトのオーナー・管理者 |
接続を登録する
-
右上のユーザー名のメニューの「組織」から組織の設定を開き、「取り込みの接続」の「接続を追加」を押します。
-
取り込み元で「Jooto」を選び、「API キー」を入力して「確認して登録」を押します。Nolto が Jooto への接続を確かめてから保存します。
-
続けて表示される「使えるプロジェクト」で、この接続を使うプロジェクトを選んで「保存」を押します。あとで選ぶ場合は「あとで指定する」を押します。登録しただけでは、どのプロジェクトからも使えません。
Jooto のキーは Jooto の組織のすべてのプロジェクトを読み取れます。選んだプロジェクトのオーナー・管理者は、Jooto のどのプロジェクトでも取り込めるようになります。選んだプロジェクトのメンバーも、Jooto のプロジェクトの名前の一覧を見られます。
使えるプロジェクトを変える・キーを入れ直す・削除する
- 使えるプロジェクトは、接続の行の「2 プロジェクト」のようなボタン（まだ指定していない場合は「プロジェクトを指定」）を押して変えます。外したプロジェクトでは、この接続を使う待機中の取り込みが失敗します。実行中の取り込みはそのまま終わります。
- キーを入れ直すには、「キーを入れ直す」を押し、「新しい API キー」を入力して「確認して保存」を押します。使えるプロジェクトの指定はそのまま保存されます。
- 削除するには、接続の行のごみ箱のボタンを押し、「削除する」を押します。取り込み済みの課題・コメント・添付と取り込みの履歴は削除されません。Jooto 側の API キーは消えないので、使わなくなったら Jooto でも削除してください。この接続を使う取り込みが待機中か実行中のあいだは削除できません。
取り込みの手順
-
Nolto のプロジェクトで「設定」→「取り込み」を開き、取り込み元で「Jooto」を選びます。API キーを入力して「接続」を押し、表示された組織名を確認します。
組織の接続を使えるプロジェクトでは「使う接続」が表示されます。組織の接続を選んだ場合は、API キーの入力は要りません。このプロジェクトで別のキーを使う場合は、「このプロジェクトに API キーを登録する」を選んでから入力します。
-
一覧から Jooto のプロジェクトを1つ選び、「タスク番号を引き継ぐ」を設定します。
-
「確認する」を押します。確認が完了したら、作成・更新・スキップの件数、プランの上限、取り込まれない項目と理由を確認します。メールアドレスが一致しないユーザーは、割り当てるメンバーを選ぶか「実行者名義」にします。
-
「この内容で取り込む」を押します。進捗が表示され、途中で止める場合は「中断」を押せます。
-
完了後、結果の件数とスキップされた項目を確認します。過去の実行結果は履歴から開けます。追加の変更を取り込む場合は「もう一度確認する(差分)」を押します。
番号を引き継ぐには課題が 0 件のプロジェクトが必要です。
対応表
| Jooto の項目 | Nolto での扱い |
|---|---|
| タスク・コメント | 課題・コメントとして取り込みます |
| リスト | リスト名がそのまま状態になります。名前が一致するものを使い、なければ作成します。並び順も Jooto のままです |
| 完了・中止のタスク | それぞれ状態「完了」「中止」に入り、完了扱いになります。元のリスト名は本文末尾の「取り込み元の情報」表に残します |
| 「完了」「中止」という名前のリスト、自動ステータスが完了・中止のリスト | そのリストの状態と、そこにあるタスクを完了扱いにします。Jooto の状態は「取り込み元の情報」表に残します |
| アーカイブ済みのタスク・リスト | 取り込みます。アーカイブされていることでは完了扱いにせず、「取り込み元の情報」表に「アーカイブ済み」と残します |
| ラベル | カテゴリになります。Nolto のカテゴリには色が無いので、ラベルの色は引き継ぎません。既定ラベルは「優先度:高」など Jooto の表示名で取り込みます |
| 種別・優先度 | 種別は「タスク」、優先度は「中」に揃えます |
| 担当者 | 複数いるときは先頭の人が担当者になり、残りはウォッチャーとして登録します |
| チェックリスト | 本文の末尾に、チェックボックスの一覧として残します |
| 締切・開始日・予定・実績 | 締切は期日になります。開始日・予定・実績は「取り込み元の情報」表に残します。日付に時刻は含みません |
| 添付 | 取り込みます。添付だけのコメントの添付は、タスクの添付になります。50 MiB を超えるファイルと実行形式のファイルはスキップします |
| 作成者 | メールアドレスが一致するメンバーに割り当てます。未一致で割当を指定しない場合は実行者名義にし、元の名前を「取り込み元の情報」表に残します |
| 作成日時・更新日時 | 元の日時を保持します |
説明とコメントの書式
Jooto の説明とコメントはプレーンテキストなので、書いたとおりに表示します。# や *、<b> などの記号を Markdown や HTML として解釈しません。URL はリンクになります。
コメントのメンションは Jooto 側の情報で相手が確定するので、そのまま Nolto のメンションに変換します。
差分の再実行と切替
「もう一度確認する(差分)」から同じ Jooto プロジェクトを確認し、再度取り込みます。同じ取り込み元の項目を更新し、変更のない項目はスキップします。Jooto で削除した項目は、Nolto からは削除されません。
本番の切替時は、Jooto 側の更新を止め、最後の差分を取り込みます。件数と内容を確認してから、チームの作業場所を Nolto に切り替えてください。
制限と注意
- 取り込みは全プランで使えますが、既存の上限が適用されます。たとえば Free の課題は1プロジェクトあたり100件までです。実行中に上限に達した項目はスキップされ、結果に理由が表示されます。
- 添付は、1ファイルが50 MiBを超える場合や実行形式の場合、スキップされます。
- API キーは暗号化して保存します。このプロジェクトの接続は「接続を削除」で削除できます。取り込みが終わったら Jooto 側でもキーを削除してください。Nolto に保存したキーは最終使用から30日で失効します。
- 組織の接続は、1つの組織に10件まで登録できます。指定したどれかのプロジェクトで、取り込みの画面に Jooto のプロジェクトの一覧が表示されたときと、取り込みを始めたときに最終使用が更新されます。キーを入れ直したときも30日に戻ります。30日使われなかった接続は、使えるプロジェクトの指定と一緒に削除されます。
- 同じプロジェクトで実行できる取り込みは同時に1件です。実行中の処理が終わるか、中断されてから次の取り込みを始めます。
- タスク番号を引き継げるのは、取り込み先の課題が0件の場合だけです。引き継がない場合は Nolto で番号を付けます。
- Jooto の月の API リクエスト上限に達すると、途中で止まります。取り込み済みの内容は残るので、翌月にもう一度確認すると続きから取り込めます。
トラブルシューティング
接続できない
API キーが正しいか、組織がビジネスプラン以上か、Jooto 側でキーを削除していないかを確認してください。保存したキーが失効した場合は、接続情報を入力し直します。
組織の接続で接続できない場合は、組織の管理者が組織の設定で「キーを入れ直す」を押し、新しいキーを保存します。組織の管理者でない場合は、組織の管理者に依頼してください。
組織の接続が使えなくなった
「選んでいた組織の接続は、このプロジェクトで使えなくなりました」と表示された場合は、組織の管理者が使えるプロジェクトの指定を外したか、接続が削除・失効しています。「使う接続」で選び直すか、このプロジェクトに API キーを登録してください。失効した接続は、組織の管理者がもう一度登録して、使えるプロジェクトを指定し直します。
プランの上限を超える
確認結果で、上限を超える項目と件数を確認します。料金ページで必要な上限を確認してプランをアップグレードし、もう一度取り込んでください。
ユーザーが一致しない
Jooto と同じメールアドレスのメンバーを Nolto に招待し、もう一度確認します。確認画面で割当先を選ぶこともできます。「実行者名義」を選んだ場合は、元の名前が「取り込み元の情報」表に残ります。
月の上限で止まった
翌月になると Jooto のリクエストの残りが戻ります。「もう一度確認する(差分)」を押して確認すると、取り込み済みの分はスキップして続きから取り込めます。