Jira と同期設定をする
概要
TimeTracker NX と Jira で同期する手順を紹介します。
Jiraと同期する方法は以下の2つあり、設定が異なります。
- Jira のプロジェクトと同期を設定する
- Jira のボードと同期を設定する
Note
上記2つの違いは Jira の連携先です。
各設定における Jira と TimeTracker NX の対応関係のイメージは以下です。
まず、対象プロジェクトの設定画面から、「作成」ボタンをクリックしてください。
Note
詳細は「同期設定の一覧を確認する」の➁をご覧ください。
その後は、画面に従って以下の手順で設定してください。
1. 接続情報を入力する
以下の情報を入力してください。
- ツールの接続URL
- Jira の URL を入力してください。
- TimeTracker NX の URL はシステム管理画面で設定した内容になります。
-
ツールにアクセスするユーザー:入力するユーザーは以下の権限が必要です。
- TimeTracker NX :プロジェクト管理者
- Jira:プロジェクトの Issue を編集できるユーザー
Note
Jira はシステム管理者権限がないユーザーも入力できますが、連携範囲に制限があります。
具体的な内容は、「FAQ:連携先のシステム管理権限がないユーザーを指定した時の制約事項を教えてください。」を参照ください。
情報を入力後に「接続テスト」をクリックして、接続できることを確認してください。
接続に成功した場合、次の設定に進んでください。
2. 同期対象を入力する
この画面では以下を設定します。
- 同期対象
- 同期方向
- 詳細な同期設定
2.1. 同期対象の設定
連携する各ツールで以下を設定してください。
-
TimeTracker NX
-
連携するアイテムを指定する。
- ①リスト形式で対象のアイテムを選択できます。
- ②リスト末尾の「フォルダの選択」で、親子関係を確認できます。
-
「Jiraのバージョンの同期対象」を指定する。
- Jira のバージョンと対応付けしたいアイテムタイプを指定してください。
- TimeTracker NX のアイテムタイプのうち、「フォルダ」の属性があるアイテムタイプのみが対象になります。
Note
フォルダ属性については、TimeTracker NX ヘルプの「アイテムタイプを追加する」をご参照ください。
Note
Jira のボードと連携する場合は、「バージョン」の代わりに「スプリント」の同期対象を指定します。
-
-
Jira
- 同期対象のプロジェクトを指定する。
- リスト末尾の「プロジェクトの選択」で対象を一覧視できます。
Note
Jira のボードと連携する場合は、「プロジェクト」に加えて「ボード」も指定します。
- 同期対象のプロジェクトを指定する。
2.2. 同期方向の設定
同期の方向を設定してください。
Note
片方向を指定した場合は、矢印の方向からしかデータを同期できません。
2.3. 詳細な同期設定
以下の2つを設定できます。
-
同期対象外にするアイテム
- TimeTracker NX、Jira 両方で設定できます。
- 「+」をクリックして表示する一覧から同期対象外のアイテムをチェックし、「OK」をクリックしてください。
-
同期対象にする場合は対象のアイテムを選択し、「-」をクリックしてください。
Note
他チームとは共有したくない情報を指定することで、セキュリティを確保することができます。
-
連携対象とするフィールド
- ここで指定したフィールドが連携対象になります。
3. アイテムタイプをマッピングする
TimeTracker NX と Jira で対応する以下の項目を指定します。
- アイテムタイプ
- 各アイテムタイプのステータス
- サブタスク
Note
最低でもアイテムタイプを1つは指定してください。
アイテムタイプ
-
各アイテムタイプを指定し、「追加」ボタンをクリックしてください。
-
削除する場合は対象の右端にある「︙」をクリックし、「削除」を選択してください。
Note
マッピングされていないアイテムタイプは同期されません。
Note
同じアイテムタイプを複数のアイテムタイプとマッピングした場合、並び順で上位にある設定を適用します。
ステータスのマッピング
上記でマッピングしたアイテムタイプに対して、「歯車」アイコンをクリックしてステータスを対応付けてください。
下図のように複数のステータスを対応づけることもできます。
この設定でステータスを変えた場合、以下のように同期先ツールに反映します。
ステータスを変えるツール | 変更したステータス | 同期先ツールのステータス |
---|---|---|
TimeTracker NX | 修正完了 | 完了 |
修正不要 | 完了 | |
Jira | 完了 | 修正完了 (並び順で上位にあるステータスに同期します。) |
サブタスクのマッピング
Jira のサブタスクに対して、対応する TimeTracker NX のタスクをマッピングしてください。
サブタスクについても、アイテムタイプと同様にステータスのマッピングができます。
4. フィールドをマッピングする
TimeTracker NX と Jira でフィールドの対応を定義します。
- ① 予め必要最低限のフィールドはマッピングしています。
- ② 対応付けたいフィールドを入力してください。
- 選択肢として表示するフィールドは以下になります。
- TimeTracker NX:システムフィールド、カスタムフィールド
- Jira:システムフィールド、カスタムフィールド
- データ型が異なるフィールドはマッピングできません。
-
片方のフィールドを指定すると、もう一方のツール側で同じデータ型のフィールドを候補として選択肢に表示します。
-
- 選択肢として表示するフィールドは以下になります。
5. ユーザーをマッピングする
TimeTracker NX と Jira でユーザーのマッピングルールを設定します。
ユーザーのマッピングルールは、「リーダー」などのユーザー型フィールドを同期する際に利用します。
マッピングルール
TimeTracker NX のユーザー情報と、連携ツールのユーザー情報とマッピングの条件を選択し、[追加] をクリックしてください。
それぞれ以下の条件を設定できます。
- ユーザー情報
- マッピング条件
ユーザーの個別関連付け
上記のマッピングルールとは別で、ユーザーを指定したマッピングもできます。
TimeTracker NX の任意のユーザーと、連携ツールの任意のユーザーを選択し、[追加] をクリックしてください。
Note
ユーザー名を入力すると、プロジェクトでロールが割り当たっているメンバーを候補として表示します。
表示されない場合はプロジェクトのロールに割り当てた後、ページを再読み込み(※)してください。
※一度の前のページに移動して戻ってくる など。
Note
ユーザーのマッピングルールと個別の関連付けが重複した場合、個別の関連付けを優先します。
6. 設定結果を確認する
今までの設定を一覧で確認できます。
問題なければ「完了」ボタンをクリックして、設定を終了します。
設定項目に不足や誤りがある場合は、修正する必要があります。
一覧から不足部分がわかりますので、該当の設定画面に移動して修正してください。
Note
左の一覧をクリックすると該当ページに移動できます。