Asana からのデータのインポート
The Asana importer for the Jira Importers plugin allows you to import data from Asana by connecting to a live Asana API.
Asana インポートプロセスでは、Asana Import Wizard が実行されます。これによって、Asana に接続し、データを Jira にマッピングおよびインポートする操作を行います。Asana インポーターは、ユーザーの Asana API Key を利用して Asana に接続します。これは、Asana のアカウント設定で見つけることができます。https://asana.com で [API Key...] をクリックし、[APPS] タブを選択します。
Asana インポーターはユーザーのすべての Asana ワークスペースにアクセスしてデータをインポートできるようになります。すべてのワークスペースを選択する必要はありません、Asana インポーターは、すべてのワークスペース内のすべてのプロジェクトを表示し、ユーザーは Jira プロジェクトにマッピングする Asana プロジェクトを選択することができます。
Asana に添付ファイルがあり、それを併せてインポートするには、Jira で添付ファイルが有効になっていることを確認する必要があります。添付ファイルは既定で有効になっています。
Asana Import Wizard を実行する
Jira インストールに既存のデータがある場合、開始する前に、既存の Jira データをバックアップします。
- Jira 管理者グローバル権限を持つユーザーとしてログインします。
- インポート ウィザードを使用して、他のソースからデータをインポートできます。 > [システム] を選択します。[インポートとエクスポート] > [外部システムのインポート] を選択すると、[外部プロジェクトのインポート] ページが開きます。
- Asanaを選択してAsana インポートウィザードを開きます。
On the Asana Connection page, instead of providing regular credentials (login and password), please provide the Asana API key. Asana API Key is a single authentication token that can be used by external systems to connect to Asana for data extraction and insertion. You can find it in your Asana account settings on https://asana.com - select the "APPS" tab, then click "API Key...".
次へをクリックします。Map projects ページに、Asanaにある全ての作業スペースにある、Asana Projectの全リストが表示されます。
- Map projects ページでデータのインポート元プロジェクトとインポート先を選択します。
すべての Asana プロジェクトは、初期状態では "Don't import this project" に設定されています。 プロジェクトをインポートするには、データのインポート先となる既存の互換プロジェクトを選択するか、新規プロジェクトを作成します。新規プロジェクトを作成するには、ドロップダウンメニューから Create New を選択し、 Add A New Project ダイアログボックスで次の項目を入力します。- 新規プロジェクトの名前
- 新規プロジェクトのキー
これは Jira プロジェクトのすべての課題 ID の接頭辞として使用されます。 - プロジェクトリード
- [次へ] をクリックします。[フィールドのマッピング] ページで、新しく作成した Jira プロジェクトに使用するワークフロー スキームを選択します。
- [次へ] をクリックします。[値のマッピング] ページでは、Asana タスクのスケジューリング ステータスを Jira 優先度に、完了フラグを Jira ワークフロー ステップにマッピングできます。
- [次へ] をクリックします。[リンク] ページでは、課題のサブタスクを Jira でリンクする方法を選択できます。
インポート開始をクリックします。
- これで、Asana データを Jira に正常にインポートできました。エラーや警告が発生している場合、内容をご確認ください。
注意:- インポートで問題が生じた場合 (または関心がある場合)、詳細ログのダウンロードリンクをクリックして、Asana インポート ウィザードのプロセスに関する詳細情報を表示します。
- この手順を通じて使用した設定と同じ (または類似の) 設定で、別の Asana プロジェクトからデータをインポートする必要がある場合は、設定を保存リンクをクリックして、Asana 設定ファイル (テキストファイル) をダウンロードします。この設定ファイルは、Asana インポートウィザードの最初のステップで使用できます。
- 同じプロジェクトに対して別のインポートを実行する前に、前のインポートで作成された外部の課題 ID フィールドを削除することをおすすめします。削除しない場合、インポーターは既存のインポート済み課題を次のインポートと関連付け、既存の ID より少ない値の新しい課題のインポートをスキップします。たとえば、最初に 50 件の課題をインポートすると、1 から 50 までの ID が割り当てられます。次のインポートでは、Jira に ID が存在する最初の 50 件の課題がスキップされます。
- Asana では名前をつけずにタスクを作成できます。Jira ではサマリーのない課題は許可されないため、このようなタスクには既定の名前が付けられ、ログに警告が表示されます。
これで、Asana のリポジトリ データを Jira に正常にインポートできました。ご不明な点や、問題が生じた場合は、アトラシアン サポートにご連絡ください。