YouTrack 統合プラグイン

YouTrack 統合プラグインをインストールする

IDE でこのセットアップを直接実行します。YouTrack で何も構成する必要はありません。IDE のさまざまなプロジェクトのプラグイン設定を個別に構成できます。

YouTrack アカウントを接続する

プラグインの使用を開始するには、まず YouTrack アカウントでサインインする必要があります。このためには、次の情報を提供する必要があります。

• YouTrack サイトの Web アドレス (URL):

• YouTrack アカウント用に生成された永久トークン。

YouTrack インストールが別の場所に移行されている場合、または別の YouTrack サイトの課題に対処したい場合は、IDE で設定 / 環境設定のツール> タスク> サーバーセクションに移動し、新しいサーバーをリストに追加します。

YouTrack ツールウィンドウで課題を見る

YouTrack 統合プラグインは、YouTrack ツールウィンドウを IDE に追加します。

ツールウィンドウには、課題とタイムトラッキングの別々のビューがあります。

課題ビューは、次の 2 つのペインに分かれています。

• 左側のペインには、現在の検索条件に一致する課題のリストが表示されます。この検索クエリは、ツールウィンドウの上部にある入力フィールドでいつでも編集できます。このリストは、2 つの詳細レベルをサポートしています。

  • 1 行表示では、課題の優先度、ID、概要、最後の更新の日時が表示されます。

  • コンパクトビューでは、カスタムフィールドの値も表示されます。

• 右側のペインに課題の詳細が表示されます。ここでは、課題 ID、概要、タグ、課題リンク、課題の説明、添付ファイルを見つけることができます。アクティビティストリームには、コメントと費やした時間の個別のタブが表示されます。説明とコメントは、YouTrack に示すようにフォーマットされています。

ツールウィンドウの左側にあるツールバーから、次のアクションにアクセスできます。

課題通知を受け取る

プラグインを通じて YouTrack に接続すると、更新通知が IDE に直接配信されます。つまり、メールや外部メッセージングクライアントに切り替えることなく、すべての課題について最新の情報を得ることができます。

IDE に送信される通知は、ユーザープロファイルの通知タブで構成されている個人通知設定に基づいています。詳細については、通知を参照してください。

各通知に対して次のアクションを使用できます。

これらの通知の外観と動作は、IDE の通知設定によって決まります。これらの設定は、通知をバルーン通知として表示するかどうか、および通知の表示方法を決定します。これらの設定の詳細については、IDE のドキュメントを参照してください。JetBrains IDE の場合、通知設定は IntelliJ IDEA のドキュメントで説明されているオプションに似ています。

リストで課題を検索する

特定の課題を検索するには、ツールウィンドウを選択して入力を開始します。検索クエリに一致する最初の課題がリストでハイライトされます。

IDE のタスクとしての未解決の課題

タスク管理プラグインと同様に、YouTrack 統合プラグインを使用すると、課題をタスクとして開き、現在の作業コンテキストを設定できます。

課題の作成

IDE の課題の解決に取り組んでいるときに、別の課題またはタスクで対処したい他の課題が発生する場合があります。YouTrack 統合プラグインを使用すると、コンソールでコードブロックまたはメッセージをハイライトし、YouTrack の新しい課題の説明フィールドに挿入できます。

YouTrack の課題を作成オプションは、コードエディターのコンテキストメニュー、およびスクリプトを実行するためのツールウィンドウ、デバッグコンソール、イベントログから利用できます。

コマンドに関する更新の課題

YouTrack 統合プラグインを使用すると、IDE から直接課題にコマンドを適用できます。IDE でコマンドを適用ダイアログを開くには:

• ツールバーの YouTrack コマンドを実行するボタンをクリックします。

• Ctrl + Shift + Y （macOS では Command + Shift + Y）を押します。

コマンドを適用ダイアログは、YouTrack とまったく同じように機能します。詳細については、コマンドを参照してください。

IDE でスタックトレースを開く

YouTrack は、課題の説明またはコメントに挿入された Java および C# スタックトレースを自動的に認識してフォーマットします。

スタックトレースがフォーマットされると、ソースコードへの参照やその他の課題がリンクとして設定されます。これらのリンクをクリックして、IDE でターゲット参照を開きます。

経過時間の追跡

YouTrack のプロジェクトでタイムトラッキング機能が有効になっている場合は、IDE での作業に費やした時間を追跡し、この情報を作業項目として YouTrack の課題に投稿できます。

タイムトラッキング

ツールウィンドウのタイムトラッキングタブには、YouTrack のさまざまな課題に投稿した作業項目のリストが表示されます。

• ツールウィンドウの上部にある検索ボックスを使用して、さまざまな条件を使用してリストをフィルタリングします。

• プラグインのツールバーのコントロールを使用すると、リストを発行または日付で並べ替えるかどうかを選択できます。

• ツールバーの追加のコントロールは、IDE を使用するときに課題に作業項目を投稿する方法を管理できます。これらのコントロールの可視性は、プラグイン設定での追跡モードオプションの現在の選択に基づいています。

プラグインは、IDE での作業に費やした時間を追跡するための 3 つの異なるモードをサポートしています。使用するモードを選択するには、プラグイン設定ダイアログでタイムトラッキング設定を編集します。

追跡モード: オフ

追跡モードオプションがオフの場合でも、IDE での作業中に、使用した時間を YouTrack の課題に投稿することができます。これは、経過時間を追加ダイアログで手動で作業項目を作成することによって管理されます。このダイアログを開くには、プラグインのツールバーにある対応するアイコンをクリックします。

次のフィールドを使用して、YouTrack の課題に作業項目を手動で追加します。

フィールド	説明
経過時間	作業項目に追加する時間を時間と分で設定します。
課題	作業項目を追加する課題を選択します。 IDE の作業コンテキストとして YouTrack の課題がすでに発生している場合は、自動的に選択されます。それ以外の場合は、リストから課題を選択します。リストは、プラグインの課題に現在適用されている検索条件に一致するようにフィルタリングされます。
作業タイプ	リストからワークアイテムタイプを選択します。
カスタム作業項目の属性	必要に応じて、カスタム作業項目属性の値を選択します。
コメント	この作業項目によって表されるアクティビティを説明するオプションのコメントを入力します。
日付	作業が行われた日付を選択します。デフォルトでは、現在の日付が選択されています。

追跡モード: マニュアル

時間を追跡するための 2 番目のオプションでは、タイマーを使用して費やした時間を測定できます。

マニュアルモードがアクティブな場合、プラグインのツールバーに次のアクションが追加されます。

アクション	説明
作業タイマーの開始	タイマーを開始して、現在のタスクの作業に費やした時間を追跡します。 クリックすると、このコントロールは作業タイマーの一時停止アクションに切り替わります。
作業タイマーの一時停止	アクティブな課題に費やした時間を投稿せずにタイマーを一時停止します。 クリックすると、このコントロールは作業タイマーの開始アクションに切り替わります。
作業タイマーのリセット	アクティブなタスクに対して現在追跡されている時間をクリアし、タイマーを再開します。
作業タイマーを停止します	タイマーを停止し、アクティブなタスクに対して現在追跡されている時間を、対応する課題に作業項目として追加します。作業項目のタイプとコメントの値は、プラグインのデフォルト設定から取得されます。
追跡された時間を表示する	ローカルに保存された時間エントリのリストを含むダイアログを開きます。使用時間のローカル追跡の詳細については、使用時間のローカル追跡を参照してください。

次の設定は、手動モードでも使用できます。

設定	説明
作業タイプ	作業タイマーを停止しますアクションを使用して転記されるすべての作業項目のデフォルトの作業タイプを設定します。
コメント	作業タイマーを停止しますアクションを使用して投稿されるすべての作業項目のデフォルトのコメントテキストを設定します。

使用時間のローカル追跡

費やした時間を追跡しながらタスクを頻繁に切り替えると、タスクで報告される小さな作業項目が多数表示される場合があります。タスクが乱雑になり、サブスクライバーにスパムが送信されないようにするために、各タスクに費やした時間を累積し、IDE にローカルに保持し、準備ができたら 1 つの作業項目に集計時間を報告できます。

作業タイマーがあり、作業コンテキストを切り替えると、タイマーは自動的に一時停止し、これまでに追跡した時間がローカルに保存されます。プラグインツールバーの追跡された時間を表示するアクションをクリックすると、現地時間のエントリにアクセスできます。

追跡時間ダイアログには、ローカルに保存した時間エントリのリストが表示されます。各エントリには、課題と、これまでに追跡した時間が表示されます。

このダイアログでは、追跡された時間エントリを管理できます。ダイアログで使用できるコントロールは次のとおりです。

オプション	説明
すべて選択	リストのすべての時間エントリを選択します。
YouTrack への投稿	選択した現地時間エントリを作業項目として YouTrack の対応する課題に転記します。
破棄	選択した現地時間のエントリを削除します。
キャンセル	変更せずにダイアログを閉じます。

作業コンテキストを、すでに時間を追跡しているタスクに切り替えると、ダイアログが表示されます。

既存の時間記録が見つかりましたダイアログが提供する 2 つのオプションがあります。

オプション	説明
YouTrack への投稿	現在のタスクのタイマーを一時停止し、作業コンテキストを変更します。 既存の時間エントリを作業項目として、新しい作業コンテキストとして設定したタスクに転記します。 新しい作業コンテキストの新しいタイマーを開始します。
保存して続行	現在のタスクのタイマーを一時停止し、作業コンテキストを変更します。 新しい作業コンテキストのタイマーを再開します。タイマーは、既存の時間エントリに時間を追加し続けます。

ネットワーク接続が不安定な場合は、費やした時間のローカル追跡が便利です。追跡された時間を投稿する必要があるときに IDE が接続を失った場合、プラグインはそれをローカルに保存します。IDE が接続を復元すると、追跡した時刻にアクセスして YouTrack に投稿できます。

使用時間のローカル追跡は、自動およびマニュアル追跡モードで使用できます。