ダウンロード/チェックアウト

ファイルのダウンロードおよびチェックアウトは、ユーザが Vault 内のエンティティのコピーを取得することができる機能です。コピーは、ローカルの作業フォルダへのダウンロード、Vault からのチェックアウト、またはその両方を行うことができます。

この機能には、サイレントモード、簡易 GUI、完全に設定可能な GUI でアクセスできます。

操作のモード
 
操作には、サイレント、簡易 GUI、完全な GUI の 3 つのモードがあります。
  • サイレント

    GUI で操作せずに、ダウンロードおよびチェックアウトのビジネス ロジックが実行されます。すべての進行状況、制限、およびローカル ファイルの検証は、カスタマイズ可能なコールバックによって処理されます。

  • 簡易 GUI

    ダウンロードが開始すると、処理全体を通じて進行状況ダイアログが表示されます。メッセージおよび制限が発生すると、問題を解決するためにメッセージ ボックスや制限ボックスがポップアップ表示されることがあります。

  • 完全な GUI

    収集オプション、チェックアウトするファイル、コメント、ダウンロードの場所などのオプションを変更できる対話形式の GUI オプションが表示されます。この GUI では、リスト ビュー、フォルダ ビュー、またはデザイン ビューでファイルを表示できます。すべてのビューで、サムネイルのサポートを含む設定可能な列をサポートします。

    ダウンロード/チェックアウト ダイアログには、折りたたみ表示と展開表示があります。

    折りたたみ

    展開

制限事項
 

ダウンロードを試行する前に、VDF により、次のいずれかの状態かどうかが検出されます。

  • ファイルが他のユーザにチェックアウトされている
  • ファイルが現在のユーザの別のコンピュータでチェックアウトされている
  • ファイルが現在のユーザの別のフォルダでチェックアウトされている
  • ファイルがロックされており、編集できない
  • ファイルが別のユーザにより同じ共有フォルダ内でチェックアウトされている

上記の状態にある場合、操作をキャンセルするか、問題のあるファイルをスキップして継続するかを選択できます。

問題をどのように処理するかを決定するロジックは拡張可能です。また、カスタムの解決エンジンを使用することができます。

ローカル ディスクの同期
 

VDF では、ディスク上のファイルが Vault 内のファイルのバージョンと同期されていないかが確認されます。この場合、ファイルを上書きするか、ダウンロードをスキップするかを選択できます。解決ロジックは拡張可能であり、既定の処理をカスタム ソリューションで置き換えることができます。

    検出されるシナリオは次のとおりです。

  • ディスク上のファイルがダウンロード中のファイルと同じバージョンで、同じチェックサムがある場合、ダウンロードはスキップされます。
  • ディスク上のファイルが現在のユーザにより既に同じ場所にチェックアウトされている場合。
  • ディスク上のファイルがダウンロードしているファイルより新しい場合。
  • ユーザがログインしたリモート サーバ上に Vault ファイルが存在せず、複製する必要がある場合。
並行処理
 

並行処理機能により、一度に複数のファイルをダウンロードすることができます。

関係収集
 
ファイルをダウンロードまたはチェックアウトする場合、関連するファイルもダウンロードまたはチェックアウトするかどうかを指定することができます。VDF では、子関係を含める関係、親関係を含める関係、リンクされたファイルを含める関係をサポートしています。
  • 子関係を含める
  • 親関係を含める

  • リンクされているエンティティを含める

複数のエンティティのダウンロード
 

VDF では、ファイルおよびフォルダのダウンロードだけではなく、アイテム、変更管理、カスタム オブジェクトなどのエンティティのダウンロードもサポートしています。VDF によりこれらのエンティティが特定されて、関連する 1 次ファイルがダウンロード用に選択されます。

進行状況の拡張機能
 

ダウンロードおよびチェックアウトの操作により、インタフェースを介して進行状況が報告されます。進行状況をコンソール、ログ ファイル、ステータス バー、または他のハンドラにリダイレクトするために、カスタムの進行状況プロバイダを使用することができます。

オプション
 
追加の設定用エンティティ オプションがあります。
  • ダウンロードするソース ファイルのリビジョンを設定することができます。
  • リリース済みバイアス オプションを設定することができます。
  • ダウンロード場所を設定できます(作業フォルダ、ダウンロードなし、カスタムの場所など)。
  • チェックアウト コマンドを設定できます。
ファイル解決
 

ファイルのダウンロード時に、ファイル(つまり、パーツ参照が含まれているアセンブリ)内の参照が古くなっているかどうかを検出することもできます。VDF には、ダウンロード中に古い参照を自動的に修正する機能が用意されています。

この機能は、追加可能な拡張ハンドラ システムを使用し、拡張ハンドラがインストールされているコンピュータで実行中の VDF クライアント(アドインを含む)に対して機能します。