YouTrack サーバー 2024.2 ヘルプ

Redmine からインポート

Redmine(英語) からのインポートにより、プロジェクト、課題、ユーザー、その他のデータを Redmine から YouTrack に移行できます。

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

前提条件

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

  • Redmine バージョンは 2.4 以降です。

  • Redmine インストールでは、リモート API 呼び出しが可能です。これを確認するには、Redmine で管理> 設定> API タブを開き、REST Web サービスを有効にするオプションをオンにして、保存をクリックします。

    Redmine バージョンが 4.10 よりも古い場合、RESTAPI サポートを有効にするオプションは設定> 認証タブにあります。

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

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

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

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

詳細のインポート

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

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

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

Redmine のエンティティ

YouTrack のエンティティ

プロジェクト

プロジェクト

ユーザー

ユーザー

グループ

グループ

プロジェクトメンバー

プロジェクトチームメンバー

課題

課題

ウォッチャー

ウォッチャー

ノート

コメント

ファイル

添付

プロジェクト wiki ページ

ナレッジベースの記事

経過時間

作業項目。現在、YouTrack はアクティビティカテゴリをインポートしません。

カスタムフィールド、課題のステータス、列挙、課題のカテゴリ、バージョン。

カスタムフィールド

カスタムフィールド値

カスタムフィールド値

Redmine からのインポートを設定する

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

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

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

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

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

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

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

    New Import from Redmine dialog.
  4. 以下の設定に値を入力します。

    設定

    説明

    URL

    Redmine インスタンスの URL。

    トークン

    Redmine の管理者アカウントからの API アクセスキー。

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

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

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

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

    設定

    説明

    課題履歴

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

    課題リンク

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

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

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

    オプションで、継続的なインポートを有効にします。有効にすると、YouTrack は選択した Redmine プロジェクトの課題を定期的にポーリングし、最後の同期以降に行われた更新をインポートします。

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

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

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

    • 継続的なインポートオプションが有効な場合、YouTrack は定期的にターゲット Redmine プロジェクトをチェックして、更新された新しい課題やコメントがないか確認します。

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

Import results

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

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

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

プロジェクトマッピング

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

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

Project Mapping

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

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

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

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

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

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

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

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

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

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

インポートオプション

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

Import Options

コントロール

説明

再開

前回のインポート後に選択した Redmine プロジェクトで行われた変更をすぐにインポートします。

編集

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

削除

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

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

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