VCS の変更の表示と編集
アクティビティストリームには、現在の課題に関連する VCS 変更のリストが表示されます。これらのイベントは、VCS の変更フィルターが有効な場合に表示されます。この情報は、プロジェクトがバージョン管理システムと統合されている場合にのみ利用できます。YouTrack は、バージョン管理システムと直接統合することも、TeamCity や Jenkins などのバージョン管理に接続されている別のアプリケーションを通じて統合することもできます。
統合の表示設定が 1 つ以上のグループに制限されている場合、指定したグループのいずれかのメンバーである場合にのみ、VCS の変更が表示されます。
課題がメンションされたとき、名前に課題 ID を含むブランチに変更がコミットされたとき、またはコミットメッセージまたはプル / マージ要求でコマンドが課題に適用されたときに、VCS の変更が課題に自動的に追加されます。この情報を使用して、各課題に関連するコードベースの変更を追跡します。
コミット数
コミットメッセージまたはブランチ名で課題が参照されるたびに、VCS 変更のコレクションにコミットが追加されます。コミットで課題を参照する方法の詳細については、参照の課題を参照してください。
現在の課題を参照するコミットについては、次の情報が表示されます。
変更をリポジトリにコミットしたユーザーの名前。
コミットがリポジトリから取得された日時。
VCS の変更に対して入力されたコミットメッセージ。
アクティビティストリームのコミットイベントの上にポインタを移動すると、ツールバーに追加のアクションが表示されます。
アクション | 説明 |
|---|---|
コミットを見る | このコントロールは、VCS 変更に割り当てられている短縮されたコミットハッシュを示します。ハッシュをクリックして、接続されているリソースの変更の詳細を表示します。コミットが複数のリソースに記録されている場合は、下矢印をクリックして、開きたいリソースを選択します。 |
追加情報を見る | 追加の詳細を表示するには、ポインターを |
切り離す | 現在の課題から VCS の変更を削除します。コミットメッセージに課題 ID が含まれている場合、コミットは切り離されますが、アクティビティストリームでは淡色表示されたままです。 |
移動 | コミットを移動ダイアログを開きます。これにより、現在の課題からコミットを削除し、代わりに別の課題に添付することができます 詳しくは、コミットを別の課題に移動するを参照してください。 |
情報アイコンの上に移動してください。このアクションは、手動で追加されたコミットまたはエラーが含まれているコミットに対して表示されます。エラーを含むコミットは、ページでハイライトされます。
変更をリポジトリにプッシュした VCS ユーザーが YouTrack ユーザーアカウントと一致しない場合は、ユーザー名が赤いテキストで表示されます。警告ツールチップには、課題を解決するために実行できる手順が表示されます。
コミットメッセージに課題に適用できなかったコマンドが含まれている場合、そのコマンドは赤いテキストで表示されます。警告ツールチップは、コマンドのどの部分が認識されなかったかを示します。
手動でコミットを追加する
アクティビティストリームは、VCS コミットメッセージまたはブランチ名の課題にメンションする変更を自動的に表示するか、VCS コミットメッセージの課題にコマンドを適用します。自動的に VCS 変更のリストに追加されなかった課題に関連する変更がある場合は、手動で追加できます。
手動でコミットを追加するには:
課題を単一の課題ビューで開きます。
さらに表示メニューから、
コミットを追加オプションを選択します。
コミットを追加ダイアログが開きます。
コミット用のハッシュを VCS リポジトリに入力するか貼り付けます。
追加ボタンをクリックしてください。
改訂が VCS の変更のリストに追加されます。
コミットを別の課題に移動する
コミットメッセージで誤った課題 ID を誤って参照した場合、VCS の変更は本来あるべき場所に表示されません。このようなミスが発生した場合は、コミットを正しい課題に移動するだけです。
コミットを別の課題に移動するには:
課題アクティビティストリームの VCS の変更セクションでコミットを見つけます。
VCS 変更イベントのツールバーの
移動アイコンをクリックします。コミットを移動ダイアログが開きます。
表示された入力フィールドに対象の課題の ID を入力します。
移動ボタンをクリックしてください。
コミットが現在の課題から削除され、ターゲットの課題に関連付けられている VCS 変更のコレクションに追加されます。
プルリクエスト
プルリクエスト（一部のバージョン管理システムではマージリクエストと呼ばれます）は、プルリクエストのタイトルまたは説明に課題が含まれている場合は常に、VCS 変更のコレクションに追加されます。
現在の課題を参照するプルリクエストについて、次の情報が表示されます。
プルリクエストを送信したか、既存のプルリクエストに関連するアクションを実行したユーザーの名前。
関連付けられた日時で実行されたアクション。
統合バージョン管理システムのオブジェクトへのリンクとしてフォーマットされた、プルリクエストの参照 ID。
プルリクエストの説明。
プルリクエストとコミットはアクティビティストリームの VCS タブに一緒に表示されますが、それらは異なる方法で処理されます。
YouTrack は、課題に関連するコマンドのプルリクエストのタイトルと説明を解析しません。これらのフィールドに書き込まれるテキストはすべて Markdown でフォーマットされ、アクティビティストリームに表示されます。コミットメッセージに含まれているときにコマンドとして処理されるものはすべて無視されます。
プルリクエストを手動で課題に添付したり、別の課題に移動したりすることはできません。代わりに、ユーザーがリンクされたバージョン管理システムでプルリクエストのタイトルまたは説明を編集すると、これらの参照が自動的に更新されます。
参照の課題
変更を課題にリンクする場合は、コミットとともに課題 ID を参照してください。課題 ID を参照するには、次のオプションがあります。
参照場所 | 詳細 |
|---|---|
コミットメッセージ: | コミットメッセージで課題 ID を参照するには、次の 2 つの方法があります。
|
ブランチ名 | YouTrack は、コミットメッセージ内に課題参照が見つからない場合、ブランチの名前で課題 ID を確認します。ブランチ名に課題 ID が含まれている場合、コミットはこの課題に関連付けられます。この場合、コミットメッセージ内のコマンドはすべて無視されます。 ブランチ名による参照の課題を有効にするには、VCS 統合設定で課題の参照については、ブランチ名を確認してください機能を有効にします。詳細については、VCS 統合を参照してください。 |
プルリクエストのタイトルと説明 | YouTrack は、プル要求のタイトルと説明で課題 ID を確認し、プル要求をメンションされた課題に添付します。プルリクエストのタイトルと説明にあるコマンドはすべて無視されます。プルリクエストの処理の詳細については、プルリクエストを参照してください。 |
VCS 変更作成者と YouTrack ユーザーの一致
VCS の変更をリンクしてコミットメッセージでコマンドを処理するには、YouTrack はコミットメッセージの作成者と一致するユーザーアカウントを見つける必要があります。コミットメッセージでコマンドが指定されている場合は、YouTrack でユーザーアカウントに付与されているアクセス許可に基づいて適用されます。ユーザーアカウントは、バージョン管理システムへの接続の種類に基づいてさまざまな方法で識別されます。
接続タイプ | 説明 |
|---|---|
Kotlin DSL スニペット | YouTrack は、VCS に変更をコミットしたユーザーの TeamCity ユーザープロファイルに保存されているメールアドレスをチェックします。変更をコミットした TeamCity ユーザーを認識するために、VCS ユーザー名を TeamCity のユーザープロファイルに関連付ける必要があります。 |
VCS 統合 | VCS 統合の場合、課題にコマンドを適用する機能は、VCS 統合設定のコミット者グループのメンバーであるユーザーに限られています。
|
コミットメッセージの作成者が YouTrack で見つからない場合、コマンドは適用されません。ユーザー名は、VCS の変更タブに赤いテキストで表示されます。警告ツールチップは、課題を修正するために使用できる情報を提供します。
この課題を解決するためにユーザーができることは基本的に 2 つあります。
YouTrack と統合 VCS のアカウントに同じメールアドレスを使用してください。
自分の Hub アカウントの VCS のユーザー名のリストに自分の名前（または Bitbucket のニックネーム）を追加します。
関連ページ：
VCS コミットでのコマンドの適用
バージョン管理システムのコードリポジトリへの変更をコミットするときに、コマンドを課題に適用できます。YouTrack を開く必要すらありません。これらの変更を適用するには、特別な形式を使用して、コミットメッセージでコマンドを指定します。YouTrack でサポートされているコマンドの完全なリストについては、コマンドリファレンスを参照してください。コミットメッセージに課題へのリンクを追加する方法をすでに見たかもしれません。これはさらに一歩進んだものです。課題とバージョン管理システム間を移動するのに...
VCS 統合
YouTrack を使用すると、バージョン管理システムへの接続をセットアップできます。YouTrack は、GitHub、GitLab、Bitbucket との直接統合をサポートしています。YouTrack と、自己ホスト GitHub Enterprise、GitLab Community Edition(CE)、および GitLab Enterprise Edition(EE)、Bitbucket サーバー、Gogs、Gitea サーバー間の統合をセットアップすることもできます。新しい統合を...
経過時間の追跡
プロジェクトでタイムトラッキングが有効になっている場合、課題に作業項目を追加できます。この機能を使用すると、課題の作業に費やした時間を記録し、実行された作業の種類を記録できます。この機能の詳細については、「タイムトラッキングチュートリアル」を参照してください。使用時間の計算：各作業項目に入力された時間は、タイプを格納するフィールドに追加されます。このデータを格納する実際のフィールドはプロジェクトレベルで定義されています。このフィールドには、issue のすべての作業項目について報告された合計時...
課題、コメント、添付ファイルの可視性を設定する
課題、コメント、添付ファイルには、可視性に関する個別の設定があります。つまり、課題を表示できるグループとユーザーを指定できます。コメントまたは添付ファイルに個別の可視性制限を適用することもできます。デフォルトでは、すべての課題とコメントは、課題が割り当てられているプロジェクトで読み取り課題権限を付与されているすべてのユーザーに表示されます。可視性が制限されていない課題では、課題は課題の読者に表示されます。課題またはコメントに機密情報が含まれている場合は、課題を作成または更新するときに表示設定を変...