YouTrack サーバー 2024.2 ヘルプ

Mantis バグトラッカーからのインポート

Mantis バグトラッカー (英語) (MantisBT) からのインポートでは、プロジェクト、ユーザー、課題、その他のエンティティを MantisBT から YouTrack にインポートできます。

セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、YouTrack のプロジェクトを MantisBT のプロジェクトにマップできます。MantisBT に課題用のカスタムフィールドセットがある場合は、YouTrack でインポートスクリプトを直接編集できます。

前提条件

MantisBT から YouTrack にプロジェクトをインポートする前に、次の要件を確認してください。

  • MantisBT のバージョンは 2.14.0 以降です。

  • YouTrack と MantisBT は、インバウンド接続にアクセスできます。具体的には、ネットワークが MantisBT と YouTrack 間の接続をブロックしないようにする必要があります。

  • MantisBT のユーザーアカウントには管理者権限があります。

  • パスワードまたはトークンを使用して、ソースアプリケーションに直接ログインしてアクセスできます。

    YouTrack のインポートエンジンは、外部認証モジュールによる認証をサポートしていません。

詳細のインポート

MantisBT データベースに YouTrack にまだ存在しないエンティティへの参照が含まれている場合は、それらが作成されます。インポートの実行に使用する YouTrack ユーザーアカウントには、インポートされたすべてのエンティティを作成するための十分な権限が必要です。インポートを実行するには、システム管理者ロールまたは低レベルの管理者書き込み権限を持つアカウントを使用することをお勧めします。

インポートされたエンティティ

MantisBT からインポートされたエンティティのリストと YouTrack エンティティへのマッピングは次のとおりです。

MantisBT のエンティティ

YouTrack のエンティティ

プロジェクト

プロジェクト

課題

課題

デフォルトの発行フィールド

カスタムフィールド

バージョンフィールド

カスタムフィールド

カテゴリ

Category カスタムフィールド値

タグ

タグ

ノート

コメント

添付

添付

課題を監視しているユーザー

ウォッチャー

関係

リンク

Mantis バグトラッカーからのインポートを設定する

新しいインポート構成を追加する前に、MantisBT インスタンスへのアクセスを許可する API トークンを作成する必要があります。その後、YouTrack でインポートをセットアップするときに、承認用のトークンを使用できます。

セットアップウィザードは、セットアッププロセスをガイドします。

Mantis Bug Tracker からのインポートを構成するには:

  1. 管理メニューから、統合> インポートを選択します。

  2. 新規インポートボタンをクリックして、セットアップダイアログを開きます。

    New import dialog
  3. Mantis を選択します。

    • Mantis からの新しいインポートの設定が表示されます。

    Mantis import settings.
  4. 以下の設定に値を入力します。

    設定

    説明

    URL

    MantisBT の URL。

    トークン

    MantisBT の管理者アカウントからの API トークン。

    MantisBT で必要な場合は、クライアント認証に SSL キーを使用するオプションを有効にします。

  5. 次へボタンをクリックしてください。

    • インポート設定の 2 番目のセットが表示されます。

    Confirm settings and start import
  6. オプションのデータセットのインポートを管理するセクションを展開します。ここでは、インポート中にソースデータベースの特定の部分を無視するようにインポートエンジンを構成できます。

    設定

    説明

    課題履歴

    このトグルを無効にして、インポート中に課題の変更履歴を無視します。

    課題リンク

    インポート中に課題間のリンクを無視するには、このトグルを無効にします。

    デフォルトでは、これらのトグルは有効になっています。これは、インポートスクリプトがサポートしている場合、YouTrack が過去の変更をプルし、インポートソースからリンクを発行することを意味します。

  7. インポートするソースおよびターゲット YouTrack プロジェクトを選択します。プロジェクトマッピング構成の詳細については、プロジェクトマッピングを参照してください。

  8. インポートを開始しますボタンをクリックしてください。

    • YouTrack は、構成されたプロジェクトマッピングに従って、新しいプロジェクトを作成し、既存のプロジェクトにデータをインポートします。

    • YouTrack は、選択した MantisBT プロジェクトからターゲット YouTrack プロジェクトに課題、コメント、ユーザーをインポートします。

インポートを設定すると、インポートリストに表示されます。構成とインポートの詳細を表示するには、リストからインポート構成を選択します。

Import results

詳細サイドバーの YouTrack には、インポートステータス、最後にインポートされた日時、インポートされたデータの詳細が表示されます。インポート中に課題が発生した場合は、エラーメッセージがここに表示されます。

ツールバーの 再開ボタンをクリックして、変更のポーリングとソース MantisBT プロジェクトからの更新のインポートを明示的に開始します。

インポートログファイルをダウンロードして、必要に応じて調査および調査することもできます。

プロジェクトマッピング

インポート設定の最後のステップで、YouTrack にインポートする MantisBT プロジェクトを選択できます。インポート用に新しいプロジェクトを作成するか、データを YouTrack の既存のプロジェクトにインポートするかを選択することもできます。

YouTrack は、Web アドレスが以前のインポートによってソースプロジェクトをすでにマップしているかどうかを認識します。YouTrack ですでにマップされているインポートされたソースプロジェクトは選択できません。重複データをインポートせずに、同じソースから複数のインポートジョブを作成できます。

Project Mapping

プロジェクトマッピングを構成するには:

  1. インポートする MantisBT プロジェクトを見つけます。

    右側のフィルターバーを使用して、プロジェクトを名前でフィルターします。

  2. インポートするプロジェクトを選択します。リストの上部にあるオプションを選択して、使用可能なすべての MantisBT プロジェクトをインポートします。

  3. MantisBT プロジェクトごとにターゲット YouTrack プロジェクトを選択します。

    • マッピングのために MantisBT プロジェクトのリストをロードするとき、YouTrack は、対応する名前を持つ既存の YouTrack プロジェクトをチェックします。MantisBT プロジェクトと同じ名前の YouTrack プロジェクトが見つかった場合、YouTrack はそれをターゲットプロジェクトとして提案します。

    • 対応する名前の既存の YouTrack プロジェクトがない場合、YouTrack は新しいプロジェクトを作成することを提案します。

  4. ターゲットプロジェクトを変更する場合は、リストの対応するドロップダウンから別のオプションを選択します。

  5. インポートを開始しますをクリックしてインポートの設定を完了し、インポートを開始します。

    • インポートが開始されます。

インポートオプション

最初のインポート後、サイドバーで次のコントロールを使用できます。

Import Options

コントロール

説明

再開

前回のインポート後に選択した MantisBT プロジェクトに加えられた変更をすぐにインポートします。

編集

統合設定ページを編集モードで開きます。このオプションを使用して、別の MantisBT インスタンスに接続したり、ログイン資格情報を更新したり、プロジェクトマッピングを更新したりします。

削除

現在のインポート設定を削除します。接続された MantisBT インスタンスからインポートされたプロジェクト、課題、コメント、ユーザー、グループは影響を受けません。インポート設定を削除して同じ MantisBT インスタンスに接続すると、課題は新しい課題 ID で既存のプロジェクトに再インポートされます。

インポートログのダウンロード

インポートログをダウンロードします。このオプションを使用して、インポート中に発生したエラーを表示および調査します。