VCS コミットでのコマンドの適用

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

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

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

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

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

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

コマンド関連の通知

VCS によって変更が課題に適用されているかどうかを監視し、サーバー統合を構築することを可能にする特別なイベントカテゴリがあります。これらのイベントの購読オプションは、YouTrack プロファイル設定で利用できます。

次のオプションが利用可能です:

YouTrack プロファイルの通知設定を更新する方法については、一般的な通知スキームを参照してください。

コマンド構文

VCS またはビルドサーバー統合の設定には、課題のコメントに対するコミットを解析するオプションが含まれています。課題コメントに対するコミットを解析しますを有効にして、コマンドが別の課題のコメントにコピーされた後に新しい行で始まるメッセージテキストをコミットします。この機能はプロジェクトごとに個別に有効または無効にすることができ、デフォルトでは無効になっています。詳細については、VCS のコミットからコメントを生成するを参照してください。

課題にコマンドを適用するために使用するパターンは、この設定の影響を受けません。VCS のコミットメッセージからの課題にコマンドを適用するには、次の構文を使用します。

または

コマンドや課題のコメントを含むコミットメッセージ全体が、アクティビティストリームの VCS 変更レコードの一部として表示されます。

メッセージテキストは次のコンポーネントに分類されます。

次の例は、課題 ID と概要がコミットメッセージテキストとして使用され、その後に課題の状態を準備完了に変更するコマンドが続くコミットメッセージを示しています。

複数の課題を更新する

括弧内の ID で課題をグループ化することにより、複数の課題にコマンドを適用することもできます。各課題に個別に同じコマンドを指定する必要はありません。例:

この例のコマンドは 3 つの課題に適用されます。課題の状態は Fixed に設定され、レビューアーフィールドは john.d に設定されています。リビジョンフィールドの値は、${revision} プレースホルダーを使用して自動的に現在のリビジョンに設定されます。

次の例は、ボスなどの課題を更新する方法を示しています。1 つのコミットメッセージで、これらすべての変更が一度に適用されます。

• 課題 TST-345 の場合、状態は Fixed に設定され、変更を確認した開発者がレビューアーフィールドに追加され、TeamCity からの改訂番号がリビジョンフィールドに追加され、コメントが課題に追加されます。

• 課題 TST-423 および TST-348 の場合、状態は処理中に設定され、両方の課題にコメントが追加されます。

プレースホルダー

${revision} をコミットメッセージのプレースホルダーとして使用できます。プレースホルダーは、VCS コミットの実際のハッシュに置き換えられます。

TeamCity 統合は、ビルド属性用の追加のプレースホルダーをサポートしています。これらのプレースホルダーは、YouTrack でビルド番号が割り当てられているすべての課題に自動的に適用されるコマンドで使用されます。手動のコミットメッセージでこれらの追加のプレースホルダを使用することはできません。詳しくは、Kotlin DSL スニペットを参照してください。