JIRA からインポート
YouTrack を使用すると、Jira(英語) インスタンスに接続できます。この統合により、次のタスクを実行できます。
Jira から既存のプロジェクト、ユーザー、グループ、グループメンバーシップをインポートします。
以前にインポートしたプロジェクトを更新して、Jira で行われた課題に変更を適用します。最後のインポート以降に Jira プロジェクトの課題に適用される新しい課題と変更が YouTrack に追加されます。
セキュリティレベルが設定された Jira からインポートされた課題の表示設定は、プロジェクト管理者グループに設定されます。
前提条件
Jira から YouTrack にプロジェクトをインポートする前に、次の要件を確認してください。
Jira クラウドからインポートする場合は、Jira インスタンスのユーザーデータのコピーを CSV ファイルとしてエクスポートしています。
インポートするプロジェクトは、Jira バージョン 5 以降で作成されました。
Jira インスタンスはリモート API 呼び出しを許可します。
Jira のユーザーアカウントには管理権限があります。管理者ロールが割り当てられていないアカウントで Jira インスタンスに接続する場合、グループと関連データをインポートできません。
パスワードまたはトークンを使用して、ソースアプリケーションに直接ログインしてアクセスできます。
YouTrack のインポートエンジンは、外部認証モジュールによる認証をサポートしていません。
詳細のインポート
Jira データベースに、YouTrack にまだ存在しないエンティティへの参照が含まれている場合、それらは作成されます。インポートの実行に使用する YouTrack ユーザーアカウントには、インポートされたすべてのエンティティを作成するための十分な権限が必要です。インポートを実行するには、システム管理者ロールまたは低レベルの管理者書き込み権限を持つアカウントを使用することをお勧めします。
インポートされたエンティティ
Jira からインポートされたエンティティのリストと YouTrack エンティティへのマッピングは次のとおりです。
Jira のエンティティ | YouTrack のエンティティ |
|---|---|
プロジェクト | プロジェクト |
ユーザー | ユーザー |
グループとメンバーシップ | グループとメンバーシップ |
課題 | 課題 |
課題リンク | 課題リンク |
添付 | 添付 |
課題の種類、ステータス、解決策、優先順位 | カスタムフィールドとその値 |
カスタムフィールド | カスタムフィールド |
ラベル | タグ YouTrack は、Jira で少なくとも 1 つの課題をマークするラベルのみをインポートすることに注意してください。 |
ログに記録された作業 | 作業項目 |
コメント | コメント |
課題履歴 | 課題履歴 |
ウォッチャー | ウォッチャー |
投票者 | 投票者 |
ユーザーデータのインポート
この統合により、Jira インスタンスに保存されているユーザーアカウントもインポートされます。Jira で課題を作成、更新、追加し、課題を割り当てたユーザーと同じ値が、YouTrack の対応するユーザーアカウントに設定されます。
Jira クラウドは、プログラムインターフェースを介してアクセスできるユーザーデータの量を制限します。Jira のユーザーアクティビティを YouTrack にインポートされた課題に正常にマップするには、課題データのインポートを開始する前に、Jira ユーザーのデータセットのコピーを YouTrack にアップロードする必要があります。
セットアップ中に、現在 Jira データベースに保存されているユーザーアカウントに関する情報を含む CSV ファイルをアップロードするように求められます。この情報をダウンロードするためのアクセス権がない場合、Jira インスタンスから課題をインポートすることはできません。
セルフホスト Jira サーバーインストールは、この制限の対象ではありません。これは、課題を YouTrack にインポートする前に、ユーザーデータを手動でエクスポートおよびアップロードする必要がないことを意味します。
Jira インスタンスのユーザーデータをエクスポートするには:
アトラシアン管理のディレクトリセクションに移動し、ユーザーページを開きます。
ヘッダーの右上隅にあるさらにメニューから、ユーザーのエクスポートボタンをクリックします。
ユーザーを CSV にエクスポートページが開きます。
次のガイドラインを使用して、エクスポートするユーザー選択を構成します。
設定
説明
ユーザー
サイト上のすべてのユーザーをエクスポートするか、選択したグループからのみエクスポートするかを選択します。選択には、インポートされたプロジェクトの課題関連のイベントに関連付けられているすべてのユーザーを含める必要があります。
ユーザーステータス
アクティブユーザーのみをエクスポートするか、すべてのユーザーをエクスポートするかを選択します。最良の結果を得るには、すべてのユーザーをエクスポートすることをお勧めします。
追加データ
グループメンバーシップと製品アクセスデータをエクスポートするかどうかを選択します。これらのオプションが有効になっている場合にユーザーエクスポートファイルに含まれるデータは、課題を YouTrack にインポートするために必要ありません。
ユーザーのエクスポートボタンをクリックしてください。
Jira は、Jira インスタンスからのユーザーデータを含む CSV ファイルを生成し、それをメールに送信します。
メールボックスを開き、ユーザーデータを含む CSV ファイルをダウンロードします。
Jira アカウント認証
Jira サーバーのインストールからデータをインポートすると、YouTrack は自動的に Jira 認証モジュールを作成して有効にします。認証モジュールは、サーバーへの接続とインポートの課題を認証するために使用されるのと同じ資格情報を使用します。
これは、インポートされたユーザーが自分の Jira アカウント資格情報を使用して YouTrack にログインできることを意味します。この認証モジュールの詳細については、アトラシアン Jira 認証モジュールを参照してください。
ユーザーデータの同期
YouTrack は、Jira サーバーインストールからの継続的なインポートのみをサポートします。YouTrack と Jira クラウド間のユーザーデータの自動同期はサポートされていません。
Jira クラウドインスタンスから継続インポートをアクティブ化すると、最初の課題のバッチをインポートするために使用した元のデータセットに含まれていなかったユーザーによって行われた変更をインポートするリスクがあります。元のユーザーデータセットに含まれていなかったユーザーアカウントがインポートされた課題のアクティビティを報告する場合、このアクティビティは YouTrack の未定義のユーザーアカウントに割り当てられます。
Jira クラウドからの継続的な課題のインポートは、Jira インスタンスのユーザーベースが比較的静的である場合にのみ推奨されます。Jira クラウドインスタンスから課題を継続的にインポートする場合は、継続的なインポート設定をオフのままにして、代わりに次の手順に従うことをお勧めします。
Jira クラウドインスタンスを YouTrack と同期する準備ができたら、AtlassianAdministration サイトからユーザーデータセットの新しいコピーをエクスポートします。
データセットを YouTrack の統合設定にアップロードします。
再開オプションを使用して、データを同期します。
ユーザーデータの同期に一貫性がないと、すぐに大きな課題が発生する可能性があります。Jira クラウドから課題をインポートする前に、Jira から完全に切り替え、ユーザーデータを転送し、すべての課題追跡アクティビティを YouTrack に移行する準備ができるまで待つことを強くお勧めします。継続的なインポートをサポートしたいのと同じくらい、Jira クラウドの API の現在の制限により、シームレスな統合をセットアップすることは困難です。
Jira からのインポートを設定する
新しいインポート構成を追加する前に、Jira インスタンスへのアクセスを許可する資格情報を準備します。YouTrack でインポートを設定するときは、認証のためにこれらのクレデンシャルが必要になります。
Jira のデプロイタイプに応じて、さまざまな資格情報の組み合わせが必要になります。
Jira 型 | ユーザー識別子 | 認証方法 |
|---|---|---|
Jira サーバー | ユーザー名 | パスワード |
Jira クラウド | ユーザー名またはメール | API トークン。 API トークンの作成の詳細については、Jira クラウドの API トークンを作成するを参照してください。 |
Jira クラウドを使用している場合は、インポートを構成する前にユーザーデータをエクスポートしてください。ユーザーデータの処理の詳細については、ユーザーデータのインポートを参照してください。
Jira クラウドの API トークンを作成する
Jira クラウドからの記事のインポートを設定するには、まず、Atlassian アカウントの API トークンを作成する必要があります。
Atlassian アカウントの API トークンを作成するには:
管理者権限が付与されたアカウントで Atlassian アカウント設定(英語)にログインします。
API トークンの作成ボタンをクリックして、トークンのラベルを指定します。
作成をクリックします。
新しい API トークンがリストに追加されます。
Atlassian 製品の API キーの作成の詳細については、アトラシアンのドキュメント(英語)を参照してください。
YouTrack で Jira からのインポートを構成する
セットアップウィザードは、セットアッププロセスをガイドします。
Jira インスタンスからのインポートを設定するには:
管理メニューから、を選択します。新規インポートボタンをクリックしてください。
新規インポートダイアログが開きます。
Jira を選択します。
Jira からの新しいインポートの設定が表示されます。
以下の設定に値を入力します。
設定
説明
URL
Jira インスタンスのベース URL を入力します。
ユーザー名またはメール
Jira インスタンスへのログインに使用されるアカウントのユーザー名を入力します。プロジェクト、ユーザー、グループ、関連データをインポートするには、このアカウントに Jira の管理者権限が必要です。
Jira インストールの場合、ユーザー名を入力します。メールアドレスを入力しないでください。
Jira Cloud の場合、ユーザー名としてメールアドレスを使用できます。
パスワードまたは API トークン
Jira サーバーの場合、Jira インスタンスへのログインに使用するアカウントのパスワードを入力します。
Jira クラウドの場合、Atlassian アカウントの API トークンを作成し、入力フィールドに貼り付けます。詳細については、Jira クラウドの API トークンを作成するを参照してください。
SSL キー
Jira インスタンスでクライアント SSL 認証が必要な場合は、クライアント認証に SSL キーを使用するスイッチをアクティブにします。次に、YouTrack サーバーを識別する SSL キーをリストから選択できます。
リストには、YouTrack にすでにインポートされている SSL 鍵のみが表示されます。SSL キーを生成してアップロードする方法については、SSL キーを参照してください。
次へボタンをクリックしてください。
インポート設定の 2 番目のセットが表示されます。
以下の設定に値を入力します。
設定
説明
ユーザーデータ
（Jira クラウドのみ）ユーザーデータをアップロードするボタンをクリックして、Jira インスタンスからのユーザーデータのコピーを含む CSV ファイルを選択します。
Jira からのユーザーデータのエクスポートの詳細については、Jira インスタンスのユーザーデータをエクスポートするには: を参照してください。
継続的なインポート
Jira インスタンスの課題に適用された変更を、YouTrack に定期的にインポートされた課題と同期させる場合は、このスイッチをアクティブにします。
このオプションを有効にすると、YouTrack は Jira インスタンスで選択したプロジェクトの変更を 2 分ごとにチェックします。(YouTrack は、無料の YouTrack クラウドアカウントを 10 分ごとにチェックします)。前回のインポート以降に追加または更新された課題は、YouTrack で処理および更新されます。
Jira クラウドからの継続的なインポートは、ユーザーデータの一貫性のない同期につながる可能性があります。Jira インスタンスのユーザーのコレクションが定期的に更新される場合は、この設定をオフのままにして、変更を手動でインポートすることを強くお勧めします。詳細については、ユーザーデータの同期を参照してください。
プロジェクトマッピング
インポートするソースプロジェクトとターゲットプロジェクトを選択します。詳細については、プロジェクトマッピングを参照してください。
オプションのデータセットのインポートを管理するセクションを展開します。ここでは、インポート中にソースデータベースの特定の部分を無視するようにインポートエンジンを構成できます。
設定
説明
課題履歴
このトグルを無効にして、インポート中に課題の変更履歴を無視します。
課題リンク
インポート中に課題間のリンクを無視するには、このトグルを無効にします。
デフォルトでは、これらのトグルは有効になっています。これは、インポートスクリプトがサポートしている場合、YouTrack が過去の変更をプルし、インポートソースからリンクを発行することを意味します。
インポートを開始しますボタンをクリックしてください。
YouTrack は、構成されたプロジェクトマッピングに従って、新しいプロジェクトを作成し、既存のプロジェクトにデータをインポートします。
YouTrack は、課題、コメント、ユーザー、グループ、関連データを、選択した Jira プロジェクトからターゲット YouTrack プロジェクトにインポートします。
継続的なインポートオプションが有効になっている場合、YouTrack はターゲット Jira プロジェクトを定期的にチェックして、更新された課題と新しい課題を確認します。
インポートを設定すると、インポートリストに表示されます。構成とインポートの詳細を表示するには、リストからインポート構成を選択します。
詳細サイドバーの YouTrack には、インポートステータス、最後にインポートされた日時、インポートされたデータの詳細が表示されます。インポート中に課題が発生した場合は、エラーメッセージがここに表示されます。
ツールバーの 
再開ボタンをクリックして、変更のポーリングとソース Jira プロジェクトからの更新のインポートを明示的に開始します。
インポートログファイルをダウンロードして、必要に応じて調査および調査することもできます。
プロジェクトマッピング
インポート設定の最後のステップで、YouTrack にインポートする Jira プロジェクトを選択するオプションがあります。インポート用に新しいプロジェクトを作成するか、YouTrack の既存のプロジェクトにデータをインポートするかを選択することもできます。
YouTrack は、Web アドレスが以前のインポートによってソースプロジェクトをすでにマップしているかどうかを認識します。YouTrack ですでにマップされているインポートされたソースプロジェクトは選択できません。重複データをインポートせずに、同じソースから複数のインポートジョブを作成できます。
プロジェクトマッピングを構成するには:
インポートする Jira プロジェクトを見つけます。
右側のフィルターバーを使用して、プロジェクトを名前でフィルターします。
インポートするプロジェクトを選択します。リストの上部にあるオプションを選択して、利用可能なすべての Jira プロジェクトをインポートします。
Jira プロジェクトごとにターゲット YouTrack プロジェクトを選択します。
マッピングのために Jira プロジェクトのリストをロードするとき、YouTrack は、対応する名前を持つ既存の YouTrack プロジェクトをチェックします。Jira プロジェクトと同じ名前の YouTrack プロジェクトが見つかった場合、YouTrack はそれをターゲットプロジェクトとして提案します。
対応する名前の既存の YouTrack プロジェクトがない場合、YouTrack は新しいプロジェクトを作成することを提案します。
ターゲットプロジェクトを変更する場合は、リストの対応するドロップダウンから別のオプションを選択します。
インポートを開始しますをクリックしてインポートの設定を完了し、インポートを開始します。
インポートオプション
最初のインポート後、サイドバーで次のコントロールを使用できます。
コントロール | 説明 |
|---|---|
再開 | 前回のインポート後に、選択した Jira プロジェクトで行われた変更をすぐにインポートします。 |
編集 | 統合設定ページを編集モードで開きます。このオプションを使用して、別の Jira インスタンスに接続したり、ログインクレデンシャルを更新したり、プロジェクトマッピングを更新したり、Jira インスタンスのユーザーデータを含む CSV ファイルの新しいコピーをアップロードしたりします。 |
削除 | 現在のインポート設定を削除します。インポートされた課題にアタッチされている Jira エンティティ ID も削除されます。接続された Jira インスタンスからインポートされたプロジェクト、課題、ユーザー、グループは影響を受けません。インポート設定を削除して同じ Jira インスタンスに接続すると、課題は新しい課題 ID で既存のプロジェクトに再インポートされます。 |
インポートログのダウンロード | インポートログをダウンロードします。このオプションを使用して、インポート中に発生したエラーを表示および調査します。 |
関連ページ：
ユーザーアカウントの禁止
ユーザーアカウントを禁止できるため、禁止されたユーザーは YouTrack にアクセスして操作を実行できなくなります。禁止ユーザーは、ライセンス制限のアクティブユーザーとしてカウントされません。たとえば、10 個のユーザーアカウントのライセンスがあり、すでに 10 人の登録ユーザーがいる場合、1 つのアカウントを禁止して新しいアカウントを作成できます。もちろん、ユーザーを禁止するのはそれだけではありませんが、最も便利なものの 1 つです。ユーザーを禁止する場合、ステータスを選択し、オプションで禁...
アトラシアン Jira 認証モジュール
この認証モジュールにより、ユーザーは自分の Jira アカウントで YouTrack にログインできます。Jira 認証を有効にする：ユーザーが自分の Jira アカウントで YouTrack にサインインできるようにするには、Jira 認証モジュールを有効にします。Jira 認証を有効にするには管理メニューから、を選択します。新規モジュールドロップダウンリストからアトラシアン Jira を選択します。サイドバーにモジュールの追加ダイアログが開きます。、モジュールの追加ダイアログで、以下の設定に...
SSL キー
YouTrack では、SSL キーストアを YouTrack にインポートできます。キーストアは、公開鍵と秘密鍵のペア、それらが関連付けられている証明書のコンテナーです。キーストアは、サードパーティーへの接続を試行するときに、YouTrack をクライアントとして識別します。キーストアを使用して、サードパーティサービスの公開キーを（証明書の形式で）キャッシュすることもできます。外部サービスのキーと証明書を含むキーストアがある場合は、このページでアップロードできます。それ以外の場合は、SSL 証...
JetBrains Space からインポート
JetBrains Space からのインポートにより、プロジェクト、課題、コメント、ユーザー、ドキュメント、その他のデータを Space 組織から YouTrack に移行できます。セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、YouTrack のプロジェクトを Space のプロジェクトにマップできます。スペースに課題用のカスタムフィールドセットがある場合は、YouTrack でインポートスクリプトを直接編集できます。前提条件：Space か...
Mantis バグトラッカーからのインポート
Mantis バグトラッカー (MantisBT) からのインポートでは、プロジェクト、ユーザー、課題、その他のエンティティを MantisBT から YouTrack にインポートできます。セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、YouTrack のプロジェクトを MantisBT のプロジェクトにマップできます。MantisBT に課題用のカスタムフィールドセットがある場合は、YouTrack でインポートスクリプトを直接編集できます。前...