チームのコードベースに作業をチェックインする

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

Visual Studio 2019 |Visual Studio 2022

Visual Studio チーム エクスプローラーで、[保留中の 変更 ] ページを開いてコードを新しい変更セットにチェックインするか、キーボードの Ctrl + O、P キーを押します。

チェックインするファイルを選択する

チェックインするファイルの変更を指定するには、チーム エクスプローラーの [保留中の変更] ページの [含まれる変更] セクションと [除外された変更] セクションの間で変更をドラッグします。 Visual Studio の他の領域で作業するときにチェックインすることもできます。

• ソリューション エクスプローラーで、ソリューション、1 つ以上のコード プロジェクト、または 1 つ以上のファイルを右クリックし、[チェックイン] を選択します。

• ソース管理エクスプローラーで、保留中の変更があるアイテムを 1 つ以上選択するか、保留中の変更があるアイテムを含む 1 つ以上のフォルダーを選択します。 TFVC チェックアウト状態アイコン は、保留中の変更がある項目を示します。 選択した項目を右クリックし、[ チェックイン] を選択します。

チェックインするアイテムの保留中の変更が表示されない場合は、除外された変更として一覧表示されていないことを確認します。 [保留中の変更] ビューを開き、[除外された変更] の下にある [検出済み] リンクを選択します。 [ 候補の変更の昇格 ] ダイアログ ボックスで、チェックインする項目のいずれかを選択し、[ 昇格] を選択します。 項目は [ 含まれる変更 ] セクションに移動し、チェックインできるようになりました。

作業項目の関連付け

変更をチェックインするときは、作業項目を変更に関連付ける必要があります。 この方法には、次の利点があります。

• 作業項目を参照するチーム メンバーは、 変更セットに直接リンク して、自分が行った作業を確認できます。
• 変更した ファイルの履歴を確認 するチーム メンバーは、変更セットを表示し、変更の正当な理由であった作業項目を確認できます。
• CI ビルドやゲート チェックイン ビルドなど、自動ビルド システムで変更をビルドできます。 チーム メンバーは、タスクが完了したビルドまたはバグが修正されたビルドを確認できます。

作業項目を変更に関連付けるには、次のいずれかを実行できます。

• [保留中の変更] ページの [関連する作業項目] セクションで、[ID による作業項目の追加] を選択します。 作業項目 ID を入力し、[ 追加] を選択します。

• チーム エクスプローラーの [作業項目] ページから 、[保留中の変更] ページの [関連する作業項目] セクションに作業項目をドラッグします。

作業項目を追加した後、項目の横にあるリンクを選択して、変更に関連する項目の関連付 け または 解決を選択できます。 これらのオプションは、作業項目が解決済み、完了、終了など、このリレーションシップを妨げる状態になっていない場合にのみ使用できます。

変更をチェックインする

1. チーム エクスプローラーで [Home] を選択し、[保留中の変更] を選択するか、Ctrl + 0、P キーを押します。

2. [ 保留中の変更] ページで コメント を入力して、後で ファイルの履歴を確認して理解 する必要があるチームメイトが、自分が行ったことを理解できるようにします。 例: ショッピング カート コントローラーを実装しました。

   一部のチームでは、メンバーが各変更セットに関する特定の種類の情報を提供することを望んでいます。また、このプラクティスを必要とするチェックイン ポリシーを実装する場合もあります。 プロジェクト管理者が チェックイン ノートを有効にしているか、必要な場合は、[ メモ ] セクションに情報を入力できます。

3. [ チェックイン] を選択します。

次のいずれかの結果が発生します。

• 変更内容がチェックインされます。

  ワークスペースから、コメント、チェックイン ノート、関連する作業項目へのリンクと共に含まれるファイルの変更はすべて、1 つの 変更セットとしてサーバーに保存されます。

• 競合によって変更がブロックされます。

  サーバー上のファイルの変更と最新バージョンの間の競合が表示されます。 Team Foundation バージョン管理の競合を解決するを参照してください。

• チェックイン ポリシーによって、チェックインがブロックされます。

  プロジェクトの管理者はチェックイン ポリシーを実装して、ベスト プラクティスに従うようチームに促すことができます。 たとえば、チェックイン ポリシーでは、チーム メンバーに少なくとも 1 つの作業項目を変更に関連付けるよう促したり、要求したりすることができます。 詳細については、「 品質ゲートの設定と適用」を参照してください。

  これらのチェックイン ポリシーをオーバーライドするには、[ ポリシーの警告 ] セクションで [警告の 上書き] を選択し、上書き理由を入力します。

• ゲート チェックイン ビルド プロセスによって制御されるフォルダーに対する変更をチェックインしています。

  ゲート チェックイン ビルド プロセスによって制御されるバージョン コントロール フォルダーへの変更をチェックインする場合は、[ゲート チェックイン] ダイアログ ボックスが表示されます。 チェックインを完了する方法については、「 ゲート チェックイン ビルド プロセスによって制御されるフォルダーへのチェックイン」を参照してください。

  

アラートをサブスクライブする

他のユーザーが TFVC プロジェクトのコードをチェックインしたときに通知を受け取る場合は、メール アラートの受信を サブスクライブ できます。 TFVC プロジェクトの ユーザー設定で、[通知] を選択 します。 [ 新しいサブスクリプション] を選択し、[コードの チェックイン テンプレート (TFVC)] から選択してカスタマイズします。

コマンド プロンプトから作業する

• Checkin コマンドを使用すると、保留中の変更を表示したり、ファイルをチェックインしたりできます。

ヒント

• リスト ビューとツリー ビューを切り替えるには、[保留中の変更] ページの [含まれているアイテム] セクションまたは [除外されたアイテム] セクションから [表示オプション] を選択します。

• 新しいコードをチェックインする前に、コード レビューの実施を検討する必要があります。 「 作業の中断、バグの修正、コード レビューの実施」を参照してください。

• 保留中の変更を管理し、必要に応じて元に戻すことができます。 コードの開発と保留中の変更の管理を参照してください。

• 変更を保存する必要がある場合は、「 作業を中断してシェルブセットを管理する」を参照してください。

• 変更はアトミックにチェックインされます。 操作は完全に成功するか、完全に失敗します。 いずれかの変更を送信できない場合、どの変更もコミットされず、変更セットは作成されません。 たとえば、チェックイン操作の途中でネットワーク接続が失われると、操作全体が失敗します。

  1 つの例外があります。これは、作業項目と変更セットの関連付けです。 作業項目の関連付けが失敗しても、チェックイン操作の他のすべての側面が成功した場合は、変更セットが作成されます。 作業項目を変更セットに手動で関連付けることができます。

次のステップ

ファイルとフォルダーの名前を変更または移動する