バージョンのマッチング
更新 : 2007 年 11 月
Migrate コマンドを使用して VSS コンバータを実行すると、Visual SourceSafe から Team Foundation にファイルが移行されます。場合によっては、予期しない原因により、移行プロセスでエラーが発生することがあります。その結果、バージョンの不一致が発生することがあります。つまり、固定された最新バージョンの Team Foundation のファイルが、固定された最新バージョンの Visual SourceSafe の同じファイルと一致しないという状況です。このようなバージョンの不一致の発生を検出および修正するために、VSS コンバータは、Migrate コマンドの最終フェーズで、バージョンのマッチングを実行します。バージョンの不一致が検出された場合、自動的に修正されます。バージョンの不一致を修正できない場合、レポートで報告されます。
固定されたバージョンのマッチング
VSS コンバータは、ファイルを移行した後で、固定されたバージョンのファイルが正常に移行されたかどうかを検証します。固定されたファイルおよび固定解除されたファイルで移行されたものすべてに対し、PINNED_LATEST ラベルが適用されます。この結果、PINNED_LATEST ラベルが付いたファイルを取得すると、Visual SourceSafe の Get Latest と一致することになります。PINNED ラベルは、固定されたファイルの固定されたバージョンに対してのみ適用されます。
VSS コンバータは、Visual SourceSafe の Get Latest に相当する処理を実行し、そのファイルを、Team Foundation のラベル PINNED_LATEST の取得に相当する処理の結果に照らして比較します。エラーが検出された場合に取りうる修正方法には、次の表に示す 3 つがあります。
Visual SourceSafe のファイル |
Team Foundation のファイル |
対応する処理 |
|---|---|---|
あり |
なし |
固定されたバージョンを Visual SourceSafe から取得し、Team Foundation に追加して、PINNED ラベルと PINNED_LATEST ラベルの両方を適用します。 |
なし |
あり |
PINNED ラベルと PINNED_LATEST ラベルの両方をファイルから削除します。 |
あり |
あるが、異なっている |
固定されたバージョンを Visual SourceSafe から取得します。それを Team Foundation からチェック アウトします。正しいバージョンに置き換え、再度チェック インします。そして、PINNED ラベルと PINNED_LATEST ラベルの両方を新しいバージョンに適用します。この方法で修正されたすべてのバージョン不一致は、単一の変更セットとしてチェック インされ、"ピン設定されたバージョンを修正するためにコンバータによって送信されました" というコメントが付けられます。 |
固定されたバージョンのバージョン マッチングのフェーズで、コンソール ウィンドウに次のように出力されることがあります。
ピン設定されたバージョンを検証しています...
ピン設定されたバージョンの検証: $/VSSFolder/a.c
ピン設定されたバージョンの検証: $/VSSFolder/b.c
最新バージョンのマッチング
VSS コンバータは、ファイルを移行した後で、最新 Tip バージョンのファイルが正常に移行されたかどうかも検証します。VSS コンバータは、移行した各ファイルについて、Visual SourceSafe の Tip バージョンと Team Foundation の Tip バージョンを比較します。エラーが検出された場合に取りうる修正方法には、次の表に示す 3 つがあります。
Visual SourceSafe のファイル |
Team Foundation のファイル |
対応する処理 |
|---|---|---|
あり |
なし |
Visual SourceSafe から Tip バージョンを取得し Team Foundation に追加します。 |
なし |
あり |
Team Foundation のファイルを削除します。 |
あり |
あるが、異なっている |
Tip バージョンを Visual SourceSafe から取得します。それを Team Foundation からチェック アウトします。最後に、正しいバージョンに置き換え、再度チェック インします。この方法で修正されたすべてのバージョン不一致は、単一の変更セットとしてチェック インされ、"最新 Tip バージョンを修正するためにコンバータによって送信されました" というコメントが付けられます。 |
Tip バージョンのバージョン マッチングのフェーズで、コンソール ウィンドウに次のように出力されることがあります。
最新 Tip バージョンを検証しています...
最新 Tip バージョンの検証: $/VSSFolder/a.c
最新 Tip バージョンの検証: $/VSSFolder/b.c
バージョン不一致のエラー
バージョン不一致のエラーによっては、VSS コンバータで修正できない場合があります。その場合、移行レポートのログにエラー情報が記録されます。この中には、固定されたバージョンのエラーと Tip バージョンのエラーのどちらであるかと、修正できなかったファイルの一覧が示されます。これらのエラーは、移行後に手動で修復します。