YouTrack サーバー 2024.2 ヘルプ

VCS コミットのリンクの課題

ソフトウェア開発チームは、課題に応じてアプリケーションコードに変更を適用することがよくあります。これらの更新は通常、バージョン管理システム(VCS)に適用されます。コードを VCS リポジトリにコミットする場合、変更内容とその理由を説明するコミットメッセージを書き込むオプションがあります。

YouTrack サーバーが VCS リポジトリと統合されている場合は、コミットメッセージまたはブランチ名で課題を参照できます。これらの参照は、リポジトリ、ビルド、YouTrack の課題へのコミットを指すリンクに変換されます。この機能は、次の統合によってサポートされています。

ビルドサーバー統合

YouTrack サーバーが TeamCity と統合されている場合は、ビルドサーバーに接続されているバージョン管理システムに変更をコミットするときに課題を参照できます。課題を参照するには、コメントに課題 ID を記載するだけです。例: fixed YP-2046

TeamCity は issue ID を対応する YouTrack issue へのリンクに変換します。課題 ID の後にある下矢印アイコンの上にポインタを移動すると、課題の概要と重要なフィールドがツールチップに表示されます。

A link to a YouTrack issue from a VCS commit in TeamCity.

コミットメッセージに課題参照が含まれていないが、ブランチ名に課題 ID が含まれている場合、このブランチへのすべてのコミットは自動的にこの課題にリンクされます。

YouTrack では、TeamCity の詳細を変更するページへのリンクが課題に追加されています。関連するすべてのコミットは、課題アクティビティストリームに表示されます。

VCS changes TeamCity

VCS 統合

バージョン管理システムと直接統合されているため、次の方法でリンクを作成できます。

  • コミットメッセージで YouTrack の課題を参照して、VCS から YouTrack へのリンクを作成します。

  • 名前に課題 ID を含むブランチへの変更をコミットして、VCS から YouTrack へのリンクを作成します。

  • YouTrack から VCS へのリンクを作成するには、コミットハッシュを懸案事項、説明、コメント、文字列型のカスタムフィールドに貼り付けます。

例:

コミットメッセージ:

VCS に表示されるコミットメッセージ

RDOC-2920 では、ヘルプデスクチケットのコメントを固定および固定解除する手順が追加されました。

RDOC-2920(英語) では、ヘルプデスクチケットのコメントを固定および固定解除する手順が追加されました。

VCS 変更作成者と YouTrack ユーザーの一致

VCS の変更をリンクしてコミットメッセージでコマンドを処理するには、YouTrack はコミットメッセージの作成者と一致するユーザーアカウントを見つける必要があります。コミットメッセージでコマンドが指定されている場合は、YouTrack でユーザーアカウントに付与されているアクセス許可に基づいて適用されます。ユーザーアカウントは、バージョン管理システムへの接続の種類に基づいてさまざまな方法で識別されます。

接続タイプ

説明

Kotlin DSL スニペット

YouTrack は、VCS に変更をコミットしたユーザーの TeamCity ユーザープロファイルに保存されているメールアドレスをチェックします。変更をコミットした TeamCity ユーザーを認識するために、VCS ユーザー名を TeamCity のユーザープロファイルに関連付ける必要があります。

VCS 統合

VCS 統合の場合、課題にコマンドを適用する機能は、VCS 統合設定のコミット者グループのメンバーであるユーザーに限られています。

  • 最初に、YouTrack はメールアドレスがコミット作成者のメールアドレスと一致するユーザーアカウントを検索します。見つかった場合は、このユーザーに代わってコマンドが実行されます。

  • コミット者グループのどのユーザーもそのようなメールアドレスを持っていない場合、YouTrack は名前で一致を見つけようとします。統合された VCS によって提供される値を取り、コミット者グループに属するユーザーの Hub アカウントに格納されている VCS のユーザー名のリストと比較します。

    • GitHub と GitLab は、名前として格納されている値を提供します。

    • Bitbucket はニックネームとして格納されている値を提供します。

コミットメッセージの作成者が YouTrack で見つからない場合、コマンドは適用されません。ユーザー名は、VCS の変更タブに赤いテキストで表示されます。警告ツールチップは、課題を修正するために使用できる情報を提供します。

VCS user not found

この課題を解決するためにユーザーができることは基本的に 2 つあります。

  • YouTrack と統合 VCS のアカウントに同じメールアドレスを使用してください。

  • 自分の Hub アカウントの VCS のユーザー名のリストに自分の名前(または Bitbucket のニックネーム)を追加します。

関連ページ:

課題テンプレート URL を生成する

そこには、掌を合わせて「どうしてこの人は、この課題を製品に割り当てるのを忘れるのだろうか? 」と自問しているいるためす。自分自身でこれを経験しているため、これを知っています。特定のカスタムフィールドに設定した値は、作業割り当てと製品リリースサイクルに関連付けられています。ただし、開発チームのメンバーではないユーザーは、これらのフィールドの重要性を認識していないか、その使用箇所を認識していないため、フィールドを空のままにします。全員が課題を作成し、必要な情報をすべて提供できたら素晴らしいと思いませ...

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

多くの開発チームは YouTrack を使ってアプリケーションのバグを報告し追跡しています。プログラマーやテスターはしばしばこれらのバグを見つけて修正するために例外を分析します。アプリケーションによって例外がスローされた場合、一般的な方法は、現在のスタックトレース(エラーが発生したときのアクティブスタックフレームのレポート)を取得し、課題の原因を突き止めることです。YouTrack でスタックトレースを操作するために使用できるトリックがいくつかあります。テスターは、課題を報告するときにスタックト...