ラベルを使用したファイルのスナップショット取得

ラベルは、後日そのスナップショットに戻れるように、ファイルのスナップショットを取得できます。ラベルを使用すると、多数のファイルを表示およびビルドできるだけでなく、ラベルを適用したときの状態までロールバックできます。

必要なアクセス許可

ラベルを適用するには、[ラベル] のアクセス許可が [許可] に設定されている必要があります。ラベルを検索、一覧、または表示するには、[読み取り] のアクセス許可が [許可] に設定されている必要があります。ラベルを変更または削除するには、ラベルの所有者であるか、[ラベルの管理] のアクセス許可セットが [許可] に設定されている必要があります。

この記事の内容

• ラベルの使用

• ラベルの適用

• ラベル名の変更

• ラベルの一覧、検索、表示、編集、および削除

• ワークスペースへのファイルのラベル付きバージョンのダウンロード

• [ラベル] ウィンドウを使用したラベルの操作

• ラベル付きバージョンへのファイルのロールバック

• コマンド プロンプトから行われました。

ラベルの使用

多くのソフトウェア プロジェクトでは、コードの品質と安定性が適切なレベルに達した場合、新しいバージョンの製品をビルドし、リリースします。ファイルの変更が続いている間でも、プロジェクト内のどのファイルでも新しいバージョンを取得およびビルドできるように、各ファイルの最新バージョンにマークを付ける必要があります。

理論上は、各ファイルの各変更セットの ID を手動で記録することもできますが、このようなプロセスは実用的ではありません。Team Foundation バージョン管理を使用すると、この作業が簡単になります。対象のファイルを含むフォルダー、分岐、またはチーム プロジェクトにラベルを適用するだけです。ラベルには、任意の名前付け規則に従って名前を付けることができます。たとえば、"Sprint 5"、"M1"、"Beta2"、"Release Candidate 0" などのラベル名を付けることができます。

ラベルを適用すると、特定のバージョンのファイルやフォルダーのビルド、分岐、マージ、比較、取得などの操作を限定するために使用できます。

ラベルの適用後に、ラベルを変更する必要が出てくることもあります。Team Foundation バージョン管理では、追加のファイルにラベルを適用すること、特定のファイルからラベルを削除すること、さらにラベルを適用するファイルのバージョンを変更することもできます。

ヒント
ラベルの適用には、分岐を作成できるだけでなく多くの利点がありますが、コストと複雑さは軽減されます。

ラベルの適用

ヒント
既存のラベルを追加するには、Visual Studio を使用すると、すべてのファイル バージョンからラベルを削除し、ラベルを追加します。一方、コマンド プロンプトからラベル操作は付加的です。「Label Command」を参照してください。

ラベルの適用

1. [ソース管理エクスプローラー]では、コレクションのショートカット メニュー、チーム プロジェクト、分岐、ファイルにラベルを追加し、[詳細設定]、**[ラベルの適用]**を選択するフォルダーを開きます。

   [新しいラベル] ダイアログ ボックスが表示されます。

2. [名前] ボックスにラベル名を入力します。

3. (省略可能) [コメント] ボックスにコメントを入力します。

4. [バージョン] リストでは、既定で [最新バージョン] が選択されています。このオプションは最もよく使用されると、ラベルの特定のバージョンを対象とすることが必要な場合を示しています:

   • [変更セット]: [変更セット] ボックスに変更セット番号を指定します。また、[変更セットの検索] のダイアログ ボックスを開くに**…**省略記号 () をクリックします。詳細については、「変更セットの検索と表示」を参照してください。

   • [日付]: 日付を [日付] ボックスで指定するか、いるかのドロップダウン メニューのカレンダーから日付を選択します。

   • [ラベル]: 新しいラベルの元にする既存のラベルを指定します。[ラベル] ボックスにラベル名を入力するか、[ラベルの検索] のダイアログ ボックスを開くに**…**省略記号 () をクリックします。詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。

   • ワークスペースのバージョン: ラベルは、ワークスペースのバージョンごとに作成されます。

5. 設定が終わったら、次の手順のいずれかを実行します。

   • ラベルを適用するには、**[作成]**を選択します。

   • 適用したラベルを追加し、次に変更すると、[作成および編集]を選択します。この操作でラベルが適用され、[ラベル] ウィンドウが表示されます。[ラベル] ウィンドウを使用してラベルを編集する方法の詳細については、「[ラベル] ウィンドウを使用したラベルの操作」を参照してください。

[!メモ]

既存の名前を使用してラベルを適用すると、続行するかどうかを確認する警告が表示されます。続行するに [OK] を選択すると、ラベルを適用するパスに含まれない項目には、そのラベルはありません。

ラベル名の変更

既存のラベル名は変更できませんが、別のラベルが適用されているファイルとバージョンに新しいラベルを適用することは簡単にできます。

既存のラベルに基づくラベルの適用

1. ソース管理エクスプローラーでプロジェクト コレクションのノード (ルート ノード) のショートカット メニューを開き、[詳細設定]、**[ラベルの適用]**を選択します。

   [新しいラベル] ダイアログ ボックスが表示されます。

2. [名前] ボックスにラベル名を入力します。

3. (省略可能) [コメント] ボックスにコメントを入力します。

4. [バージョン] リストで [ラベル] を選択します。

   [ラベル] ボックスが表示されます。

5. 次のいずれかの操作を実行します。

   • 既存のラベル名を入力します。

   • 既存のラベル名をよく覚えていない場合、楕円を持つ参照ボタンを選択します (…) [ラベル] ボックスの横。

     [ラベルの検索] ダイアログ ボックスが表示されます。

     [ラベルの検索] ダイアログ ボックスのオプションを使用して、ラベルの一覧をフィルター処理し、新しいラベルを適用する既存のラベルを検索します。詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。

6. **[作成]**を選択します。

7. (省略可能) 新しいラベルを作成したら、古いラベルを削除できます。詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。

ラベルの一覧、検索、表示、編集、および削除

ラベルを一覧および検索する方法は 2 つあります。[ラベルの検索] ダイアログ ボックスと [履歴] ウィンドウの [ラベル] タブです。目的のラベルを見つけたら、ラベルの表示、編集、削除や、適用先のファイルの操作を行います。

[ラベルの検索] ダイアログ ボックスを使用したラベルの検索と操作

1. メニュー バーのソース管理エクスプローラーで、[ファイル]、[ソース管理]、[検索]、**[ラベルの検索]**を選択します。

   [ラベルの検索] ダイアログ ボックスが表示されます。

2. (省略可能) 次の手順の 1 つまたは複数を実行して、検索を改善します。

   • [名前] のテキスト ボックスにラベル名を入力します。

   • [プロジェクト] リストで、検索するラベルが含まれるチーム プロジェクトを選択します。

   • [所有者] ボックスにラベルの所有者の名前またはエイリアスを入力します。

3. **[検索]**を選択します。

   [結果] リストに、入力した検索条件に一致するラベルが表示されます。

4. (省略可能) 次のいずれかの手順を実行します。

   • ラベルを表示または編集するには、を選択し、**[編集]**を選択します。

     [ラベル] ウィンドウが表示されます。詳細については、「[ラベル] ウィンドウを使用したラベルの操作」を参照してください。

   • ラベルを削除するには、を選択し、**[削除]**を選択します。

   • [閉じる] をクリックします。

ラベル名をよく覚えていない場合でも、バージョン管理でそのラベルが特定の項目に適用されたことがわかっていることがあります。このような場合に、ラベルを検索し、操作する手順について説明します。

特定の項目に適用するラベルの一覧および操作

1. ソース管理エクスプローラーで、検索するラベルが適用される開き、を選択します。**[履歴の表示]**項目のショートカット メニューが。

   [履歴] ウィンドウが表示されます。

2. この項目に適用するラベルの一覧を表示するに [ラベル] のタブをクリックします。

3. (省略可能) 次のいずれかの手順を実行します。

   • ラベルを表示または編集するには、ショートカット メニューを開き、**[ラベルの編集]**を選択します。

     [ラベル] ウィンドウが表示されます。このウィンドウの使用方法の詳細については、「[ラベル] ウィンドウを使用したラベルの操作」を参照してください。

   • ラベルを削除するには、ショートカット メニューを開き、**[ラベルの削除]**を選択します。

   • ラベルのショートカット メニューを開き、**[このバージョンの取得]**などの他のアクション、および **[比較]**を選択します。

[履歴] ウィンドウの [ラベル] タブを使用する方法の詳細については、「項目の履歴の取得」を参照してください。

ワークスペースへのファイルのラベル付きバージョンのダウンロード

一連のファイルにラベルを付ける操作は、特定の時点に存在したファイルのスナップショットを取得する場合と似ています。スナップショットの取得後、数週間または数か月経ってから、そのスナップショットの時点のファイルを表示または操作する必要が出てくる可能性があります。次の手順では、一連のファイルのラベル付きバージョンをワークスペースにダウンロードする方法について説明します。

ファイルのラベル付きバージョンをワークスペースにダウンロードする

1. ソース管理エクスプローラーで **[詳細設定]**をダウンロードし、選択する項目 **[特定のバージョンの取得]**を含むプロジェクト コレクション、チーム プロジェクト、分岐、またはフォルダーのショートカット メニューを開きます。

   [取得] ダイアログ ボックスが表示されます。

2. [種類] の一覧で、を選択します [ラベル]は、を [ラベル] ボックスにラベル名を入力するか、[ラベルの検索] のダイアログ ボックスを開くに**…**省略記号 () をクリックします。このダイアログ ボックスの使用方法の詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。

3. ラベルを確認し、必要に応じて [取得] ダイアログ ボックスで追加のオプションを選択します。

4. **取得します。*****を選択します。

[ラベル] ウィンドウを使用したラベルの操作

前述した手順のいずれかを使用して [ラベル] ウィンドウを開いたら、ラベルを操作できます。ウィンドウの上部にはコメントのボックスが表示されます。必要に応じてコメントは編集できます。

[ラベル] ウィンドウは、次のタスクの実行に使用できます。

• ラベルへの項目の追加

• ラベルからの項目の削除

• ファイルのバージョン変更

• 項目に対するその他の操作

ラベルへの項目の追加

1. [ラベル] のペインで、**[項目の追加]**を選択します。

   [項目のバージョンの選択] ダイアログ ボックスが表示されます。

2. [項目のバージョンの選択] ダイアログ ボックスで、追加する項目を探し、選択します。

   ヒント
   複数の項目を選択するには、Ctrl キーまたは Shift キーを押しながら項目を選択します。

3. ラベルが特定のバージョンを、選択 [バージョン] のリストから特定することが必要な場合 (省略可能) :

   • 最新バージョン: ラベルは、バージョン コントロールにある最新バージョンに適用されます。

   • [変更セット]: [変更セット] ボックスに変更セット番号を指定します。また、[変更セットの検索] のダイアログ ボックスを開くに**…**省略記号 () をクリックします。詳細については、「変更セットの検索と表示」を参照してください。

   • [日付]: 日付を [日付] ボックスで指定するか、いるかのドロップダウン メニューのカレンダーから日付を選択します。

   • [ラベル]: 新しいラベルの元にする既存のラベルを指定します。[ラベル] ボックスにラベル名を入力するか、[ラベルの検索] のダイアログ ボックスを開くに**…**省略記号 () をクリックします。詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。

   • ワークスペースのバージョン: ラベルは、ワークスペースのバージョンごとに作成されます。

4. [OK] をクリックします。

5. [ファイル]、上書き保存を選択します。

ラベルからの項目の削除

1. [ラベル] ウィンドウで、このラベルから削除するコレクション、チーム プロジェクト、分岐、フォルダー、またはファイルを見つけます。

2. 項目のショートカット メニューを開き、**[ラベルから削除]**を選択します。

   項目からラベルが削除されます。項目がプロジェクト コレクション、チーム プロジェクト、分岐、またはフォルダーの場合、含まれるすべての項目からもラベルが削除されます。

3. [ファイル]、上書き保存を選択します。

ファイルのバージョン変更

1. [ラベル] ウィンドウで、変更するファイルを見つけます。

2. ファイルのショートカット メニューを開き、**[ラベル付きバージョンの変更]**を選択します。

3. [ラベル付きバージョンの変更] のダイアログ ボックスが表示されます。

4. :を選択します

   • 最新バージョン: バージョン コントロール内にある最新バージョンにラベルを追加します。

   • [変更セット]: [変更セット] ボックスに変更セット番号を指定します。また、[変更セットの検索] のダイアログ ボックスを開くに**…**省略記号 () をクリックします。詳細については、「変更セットの検索と表示」を参照してください。

   • [日付]: 日付を [日付] ボックスで指定するか、いるかのドロップダウン メニューのカレンダーから日付を選択します。

   • [ラベル]: 新しいラベルの元にする既存のラベルを指定します。[ラベル] ボックスにラベル名を入力するか、[ラベルの検索] のダイアログ ボックスを開くに**…**省略記号 () をクリックします。詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。

   • ワークスペースのバージョン: ラベルは、ワークスペースのバージョンごとに作成されます。

5. [ファイル]、上書き保存を選択します。

ラベル付き項目に対するその他の操作

ラベル] ウィンドウの項目のショートカット メニューを開くと、次のコマンドを一つ選択します: 1

• [表示] (ファイルのみ)

• [履歴の表示]

• [比較] (ファイルのみ)

• 注釈します。 (ファイルのみ)

• [このバージョンの取得]

コマンド プロンプトから行われました。

• Label Command、ラベルを追加または削除します。

  ヒント
  ラベルを追加、このコマンドを使用すると、チーム プロジェクト以外の範囲を指定できます。

• Labels Command の一覧のラベル。

参照

概念

変更セットの検索と表示

ワークスペースの管理

Team Foundation Server のアクセス許可

ソース管理エクスプローラーを使用したバージョン管理下でのファイルの管理

その他の技術情報

分岐を使用したリスクの分離