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