Redmineと連携する

はじめにRedmineへの接続情報を入力します。

種別設定と取り込むチケットの範囲の指定を行う。

種別マッピングは、Redmineのトラッカーに対応するCATの分類をプルダウンから選択して設定します。連携しないを選択すると、そのトラッカーのチケットは同期しません。

カスタムクエリは、CATに同期するチケットを絞り込む設定です。ここで指定したカスタムクエリの対象外のチケットは同期しません。API連携キーを発行したユーザーが作成したカスタムクエリを利用できます。

共通設定項目では、次の項目を設定します。

それぞれRedmine側の値に対応するCATの値を設定します。 尚、再設定時等、次ページ以降の設定をそのまま引き継ぎ省略する場合、画面右上の「以降の設定をスキップする」ボタンを押してください。確認画面にジャンプします。

以下で各種マッピングの設定方法を説明します。

個別設定を行います。トラッカー毎に連携キー及びカスタムフィールドを設定します。

※上記のマッピング表にRedmineのカスタムフィールドを追加したとき、紐付先のCAT側フィールドとして選択肢に表示されるのは、RedmineのカスタムフィールドタイプにCATのフィールドタイプが対応している場合のみです。フィールドの対応関係についてはRedmineフィールド対応関係を参照してください。

※カスタムフィールドを選択するには、連携対象のトラッカーごとに、連携したRedmineに1つ以上の起票が必要です。起票がない場合、カスタムフィールドが表示されないため、ダミー等のチケットを登録してください。

各項目の設定が完了したら次へボタンを押して、次の画面に進んで下さい。

詳細設定では連携時の警告について設定します。詳細設定では以下の2つの設定ができます。

ユーザー連携の警告は外部BTS連携詳細情報画面で確認できます。この画面は、課題一覧の上にある警告(詳細)リンクから開くことができます。CATに登録されていないメールアドレスのユーザーがチケットの担当者や作成者である場合に、そのメールアドレス、ユーザー名、チケット番号、プロジェクト名が表示されます。

各項目の設定が完了したら次へボタンを押して、次の画面に進んで下さい。

設定を確認し、設定が正しければ登録ボタンを押してください。

外部BTSの設定を正常に登録完了すると下図のような画面が現れます。一覧に戻るボタン、または詳細に戻るボタンを押して外部BTSの設定を終了してください。

※外部BTS連携更新を行うとそのプロジェクトで登録していたCAT上の課題は削除されます。必要な課題は連携前にダウンロード等を行って下さい。

連携設定完了後、設定した連携のステータスはプロジェクトトップ等で確認することができます。警告またはエラーの場合はステータスボタンをクリックし外部BTS連携詳細情報を確認してください。

利用しているRedmineのAPIキーが管理者でない場合やRedmineのメールアドレスとCATのメールアドレスが一致しない場合は手動でマッピングができます。

※CATはEメールアドレスを参照してユーザ情報をマッピングしているため、RedmineのEメールアドレスを取得できない場合や、CATに登録されていないEメールアドレスがRedmineにあるとユーザのマッピングができません。

以下は外部BTSとCATのフィールド対応関係です。カスタムフィールドの連携マッピングを行う時等に参照してください。なお、外部BTS上に課題が存在しない場合カスタムフィールドの取り込みを行うことはできません。