チームのコードベースへの作業のチェックイン
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Visual Studio の [チーム エクスプローラー] で、[保留中の変更] ページを開いてコードを新しい変更セットにチェックインするか、キーボードで Ctrl + O、P キーを押します。
ヒント
ドッキング解除アイコン を選択すると、[チーム エクスプローラー] から [保留中の変更] ページのドッキングを解除し、別のウィンドウに表示できます。
チェックインするファイルを指定する
[チーム エクスプローラー] の [保留中の変更] ページにある [除外される変更] セクションと [含まれる変更] セクションの間で変更をドラッグすることで、チェックインするファイル変更を指定できます。 また、Visual Studio の他の領域で作業しながらチェックインすることもできます。
[ソリューション エクスプローラー] で、ソリューション、コード プロジェクトを 1 つ以上、またはファイルを 1 つ以上右クリックし、[チェックイン] を選択します。
ソース管理エクスプローラーで、保留中の変更がある項目を 1 つ以上選択するか、保留中の変更を含むフォルダーを 1 つ以上選択します。 TFVC チェックアウト状態アイコン は、保留中の変更がある項目を示しています。 選択した項目を右クリックし、[チェックイン] を選択します。
重要
選択した項目に保留中の変更がない場合、[チェックイン] オプションは表示されません。
チェックインする項目の保留中の変更が表示されない場合は、除外された変更として表示されていないか確認してください。 [保留中の変更] ビューを開き、[除外された変更] の下にある [検出] リンクを選択します。 [候補の変更の昇格] ダイアログ ボックスで、チェックインする項目を選択し、[昇格] を選択します。 項目を [含まれる変更] セクションに移動すると、チェックインできるようになります。
作業項目を関連付ける
変更をチェックインする際には、変更と作業項目を関連付ける必要があります。 この作業には次のような利点があります。
- 作業項目を表示するチーム メンバーは、変更セットに直接リンクして、行った作業を確認することができます。
- 変更したファイルの履歴をレビューするチーム メンバーは、変更セットを表示して、変更の理由となった作業項目を確認できます。
- CI ビルドやゲート チェックイン ビルドなど、自動化されたビルド システムで変更をビルドできます。 チーム メンバーは、どのビルドでタスクが完了したか、またはバグが修正されたかを確認できます。
作業項目を変更に関連付けるには、次のいずれかを実行します。
[保留中の変更] ページの [関連作業項目] セクションで、[ID を指定して作業項目を追加] を選択します。 作業項目 ID を入力し、[追加] を選択します。
[チーム エクスプローラー] の [作業項目] ページから、[保留中の変更] ページの [関連作業項目] セクションに作業項目をドラッグします。
作業項目を追加すると、項目の横にあるリンクを選択して、項目とその変更の関連性を [Associate](関連付け) か [Resolve](解決) から選択できます。 これらのオプションは、作業項目が、[解決済み]、[完了]、[終了] など、このリレーションシップを除外する状態ではない場合にのみ使用できます。
変更をチェックインする
[チーム エクスプローラー] で、[ホーム] を選択してから、[保留中の変更] を選択するか、Ctrl + 0、P キーを押します。
後でファイルの履歴をレビューして把握する必要のあるチームメートが、ファイルにどのような変更が加えられたかを把握できるように、[保留中の変更] ページで [コメント] ボックスに入力します。 たとえば、「買い物カゴ コントローラーを実装」と入力します。
一部のチームでは、メンバーが各変更セットに関する特定の種類の情報を提供することを望んでおり、この作業を必須とするチェックイン ポリシーを実装している場合もあります。 プロジェクト管理者がチェックイン メモを有効または必須にしている場合は、[メモ] セクションに情報を入力できます。
[チェックイン] を選択します。
次のいずれかの結果になります。
変更がチェックインされます。
ワークスペースのすべての含まれるファイル変更は、コメント、チェックイン メモ、および関連作業項目へのリンクと共に、サーバー上に 1 つの変更セットとして保存されます。
競合により変更がブロックされます。
システムは、変更とサーバー上にあるファイルの最新バージョンの間の競合を表示します。 「Team Foundation バージョン管理の競合の解決」を参照してください。
チェックポリシーによって、チェックインがブロックされます。
プロジェクト管理者は、チェックイン ポリシーを実装して、ベスト プラクティスを準拠するようにチームを促すことができます。 たとえば、チェックイン ポリシーによってチーム メンバーが少なくとも 1 つの作業項目を変更に関連付けるように促すまたは要求することができます。 詳細については、「品質ゲートの設定と適用」を参照してください。
これらのチェックイン ポリシーをオーバーライドするには、[ポリシーの警告] セクションで [オーバーライド警告] を選択し、オーバーライドする理由を入力します。
ゲート チェックイン ビルド プロセスで制御されるフォルダーへの変更をチェックインしています。
ゲート チェックイン ビルド プロセスで管理しているバージョン管理フォルダーに変更をチェックインすると、[ゲート チェックイン] ダイアログ ボックスが表示されます。 チェックインを完了する方法については、ゲートイン チェックイン ビルド プロセスで管理しているフォルダーへのチェックインに関する記事を参照してください。
アラートをサブスクライブする
TFVC プロジェクトにコードがチェックインされたときに通知を受け取る場合は、電子メール通知の受信登録を行うことができます。 TFVC プロジェクトの [ユーザー設定] で、[通知] を選択します。 [新しいサブスクリプション] を選択してから、[コード (TFVC)] の チェックイン テンプレート を選択してカスタマイズします。
コマンド プロンプトから作業する
- Checkin コマンドを使用すると、保留中の変更とチェックイン ファイルを表示できます。
ヒント
リスト ビューとツリー ビューを切り替えるには、[保留中の変更] ページの [Included Items](含まれる項目) セクションまたは [除外された項目] セクションから [表示オプション] を選択します。
新しいコードをチェックインする前に、コード レビューの実施を検討してください。 「作業の中断、バグの修正、およびコード レビューの実行」を参照してください。
保留中の変更を管理し、必要に応じて、元に戻すことができます。 「コードの開発と保留中の変更の管理」を参照してください。
変更を保留する必要がある場合は、「作業の中断とシェルブセットの管理」を参照してください。
変更は自動でチェックインされます。 操作は完全に成功するか、完全に失敗するかのどちらかです。 いずれかの変更が送信できない場合、どの変更もコミットされず、変更セットは作成されません。 たとえば、チェックイン操作中にネットワーク接続が失われた場合は、操作全体が失敗します。
例外は、変更セットに対する作業項目の関連付けのみです。 作業項目の関連付けに失敗しても、チェックイン操作の他の要素がすべて成功すると、変更セットが作成されます。 変更セットに対する作業項目の関連付けは手動で実行できます。