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