仮想ファイルを登録する

説明

仮想ファイルとは、ユーザーのローカルPC上に存在しない仮想ファイルのことである。一般的に、仮想ファイルはすでにアップロードされたファイルに関する情報を保持するために使用されます。つまり、サーバーにファイルが存在することを示すものとして使用されます。実際にはローカルに存在しないので、アップロードするファイルではない。

仮想ファイルを登録するには、addVirtualFile関数またはaddVirtualFileList関数を使用します。仮想ファイルはjsonオブジェクト形式で登録されます。

vindex: (必須フィールド）仮想ファイルを区別する一意のキー。形式は問いませんが、重複しないようにします。
name: （必須フィールド）仮想ファイルの名前。
size: （必須フィールド）仮想ファイルのサイズ：仮想ファイルのサイズ（バイト単位）。
lock: ロック・ステータスがtrueの場合、ファイルは削除できない。

var dx = dx5.get(id);
// 個別に登録する場合
dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
dx.addVirtualFile({ vindex: "IDX0002", name: "virtual_file_locked.txt", size: 45678, lock: true });
dx.addVirtualFile({ vindex: "IDX0003", name: "cosmos.jpg", size: 195779 });

// 一度に複数登録する場合  
dx.addVirtualFileList([
	{ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 },
	{ vindex: "IDX0002", name: "virtual_file_locked.txt", size: 45678, lock: true },
	{ vindex: "IDX0003", name: "cosmos.jpg", size: 195779 }
]);

addVirtualFile関数とaddVirtualFileList関数は非同期にファイルを登録するので、この2つの関数に続くコードが先に実行されることに注意。

説明

例