1.3.0.0以上

説明

ファイル圧縮のダウンロードを開始する。

ファイルを圧縮を担当するサーバーのパスをsetCompressURLメソッドを使用して設定すると、ダウンロードする仮想ファイルを1つのファイルに圧縮してダウンロードする。

単一/複数ファイルのダウンロードとは異なり、圧縮ダウンロードは圧縮プロセスをサーバーに委任するため、 対象ファイルのダウンロードパスを指定する属性（downUrlまたはurl）の影響を受けません。

var dx = dx5.get("component-id");

// ただし、圧縮処理をするサーバーで圧縮対象を区別するためのvindex属性の値を必ず指定する必要がある。
// vindexは一種のユニークな文字列値により、仮想ファイルを区別するための唯一の手段である。
dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147 });
dx.addVirtualFile({ vindex: "IDX0004", name: "beach_239826.jpg", size: 239826 });
dx.addVirtualFile({ vindex: "IDX0005", name: "cosmos (empty space) 195779.jpg", size: 195779 });

// 圧縮処理し、圧縮ファイルのダウンロードパスを返すアドレスを設定する。
dx.setCompressURL("http://domain/path/service/compress.do");

// フラグの値に基づいてダウンロードを実行する。
// AUTO：仮想ファイルをダウンロードする。
// SELECTED：選択された仮想ファイルをダウンロードする。
// CHECKED：チェックされた仮想ファイルをダウンロードする。
dx.downloadCompressed("SELECTED");

コンポーネントの作成時にbtnDownloadCompressedAuto属性の値を使用すると、自動的にバインドして使用することができる。

<button id="btn-download-compressing" type="button">압축 ダウンロード</button>
<script>
  dx5.create({
    ...,
    // 圧縮ダウンロード機能が自動的に接続される。
    btnDownloadCompressedAuto: "btn-download-compressing"
  });
</script>

btnDownloadCompressedAuto属性のほかに、btnDownloadCompressedChecked、btnDownloadCompressedSelectedを使用することができる。

DEXTUploadX5マルチモジュールはdownloadCompressedメソッドが呼び出されると、圧縮対象のvindex値をコンマ（、）文字で連結した1つのリストの文字列とし、「DEXTUploadX5_VIndexes」の名前のフォームのデータには、リストの文字列をPOST形式でsubmitする。

サーバーのWebアプリケーションは、サーバーパスへの要求があったとき、ファイルを圧縮した後、対象ファイルをダウンロードできるサーバーアドレスを返す必要がある。

圧縮がサーバーで実行中は、進行ウィンドウが表示されますが、圧縮されたファイルをダウンロードするときは、単一​​のファイルのダウンロードに移行されるので、ダウンロードプロセスの独自の進行状況ウィンドウは提供されない。

形式

component.downloadCompressed(flag);

パラメータ

1.3.0.0以上

説明

ファイル圧縮を処理するサーバーアドレスを返します。

形式

url = component.getCompressURL();

リターンタ

ファイル圧縮を処理するアドレス

1.3.0.0以上

説明

ファイル圧縮を処理するサーバーアドレスを設定する。

var dx = dx5.get("component-id");

// ただし、圧縮処理をするサーバーで圧縮対象を区別するためのvindex属性の値を必ず指定する必要がある。
// vindexは一種のユニークな文字列値により、仮想ファイルを区別するための唯一の手段である。
dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147 });
dx.addVirtualFile({ vindex: "IDX0004", name: "beach_239826.jpg", size: 239826 });
dx.addVirtualFile({ vindex: "IDX0005", name: "cosmos (empty space) 195779.jpg", size: 195779 });

// 圧縮処理し、圧縮ファイルのダウンロードパスを返すアドレスを設定する。
dx.setCompressURL("http://domain/path/service/compress.do");

// フラグの値に基づいてダウンロードを実行する。
// AUTO：仮想ファイルをダウンロードする。
// SELECTED：選択された仮想ファイルをダウンロードする。
// CHECKED：チェックされた仮想ファイルをダウンロードする。
dx.downloadCompressed("SELECTED");

サーバーのWebアプリケーションは、該当サーバーパスへの要求があったとき、ファイルを圧縮した後、対象ファイルをダウンロードできるサーバーアドレスを返す必要がある。

形式

component.setCompressURL(url);

パラメータ

1.3.0.0以上

説明

ファイル圧縮要求を停止する。

DEXTUploadX5は、コンポーネント自体に圧縮要求を停止するためのボタンやGUI要素がない。

代わりに、スクリプトを使用して停止することができるように関数を提供している。

<button type="button" onclick="stop('component-id');">停止</button>
<script>
function stop(id) {
  dx5.get(id).stopCompressWaiting();
}
</script>

コンポーネントの作成時にbtnStopCompressWaiting属性値を使用して自動的にバインドして使用することができる。

<button id="btn-stop-compresswaiting" type="button">停止</button>
<script>
  dx5.create({
    ...,
    // アプチュリクエスト停止機能が自動的に接続される。
    btnStopCompressWaiting: "btn-stop-compresswaiting"
  });
</script>

stopCompressWaitingメソッドは、圧縮要求を中止する。圧縮処理が完了した後、ファイルがダウンロードされているプロセスはキャンセルされない。

形式

component.stopCompressWaiting();

1.1.0.0以上

説明

ダウンロードファイルの個別サイズ制限を設定します。ブラウザのメモリ管理上の問題により、ダウンロードファイルにはサイズ制限が課されています。

デフォルト値は100MBです。これより大きいファイルサイズを許可するには、setLimitMultiDownloadSizeメソッドを使用して制限を変更する必要があります。

// ダウンロードサイズ制限を300MBに設定する。
dx.setLimitMultiDownloadSize(1024 * 1024 * 300);

• この関数はダウンロード可能なファイルサイズを変更するものであり、ブラウザのメモリ性能を向上させるものではありません。ファイルが極端に大きい場合、ブラウザによってはクラッシュを引き起こす可能性があります。
• バージョン4.0.0.0以降、これは単一ファイルダウンロードにも適用されます。

形式

component.setLimitMultiDownloadSize(limit);

パラメータ

3.8.0.0以上

説明

複数のファイルをダウンロードするときに、継続を有効または無効にします。 ファイルのダウンロード中に中断された場合、ダウンロードは中断した時点から再開されます。 ただし、アップロードからのピックアップとは異なり、これはダウンロードをキャンセルするか、ウィンドウを閉じた後に発生します、 ダウンロードを再開すると、ダウンロードは最初から始まります。

デフォルトはtrueです。サーバーがRangeリクエストを受け付けない場合は、falseに設定することをお勧めします。

function onDX5Created(id) {
    var dx = dx5.get(id);
    // ダウンロードの再開を無効にします。
    dx.enableResumingDownload(false);
}

バージョン3.8.0.0より、ダウンロードの再開機能が実装され、サーバーへのHEADリクエストが強制的に送信されるようになりました。再開機能を無効にしても、HEADリクエストは発生します。

形式

component.enableResumingDownload(enable);

パラメータ

3.8.0.0以上

説明

複数ファイルのダウンロード操作を一時停止する。

<button type="button" onclick="pause('component-id');">Pause</button>
<script>
function pause(id) {
    dx5.get(id).pauseDownloading();
}
</script>

関数を使用して一時停止できるのは、複数ファイルのダウンロード操作のみです。downloadByIdまたはダウンロードアイコンを使用してターゲットをダウンロードしている場合、pauseDownloading関数を使用しても操作は停止されません。

形式

component.pauseDownloading();

3.8.0.0以上

説明

一時停止した複数ファイルのダウンロード操作を再開します。

<button type="button" onclick="resume('component-id');">Resume</button>
<script>
function resume(id) {
    dx5.get(id).resumeDownloading();
}
</script>

pauseDownloading メソッドを使用できるのは、pauseDownloading メソッドを使用してダウンロード操作が一時停止された場合、またはエラーによって一時停止された場合のみです。

形式

component.resumeDownloading();

3.8.0.0以上

説明

複数ファイルダウンロード操作のダウンロード単位サイズを設定する。

複数ファイルのダウンロード操作を行う時、DEXTUploadX5はファイルをユニットサイズで分割してダウンロードします。ダウンロード単位サイズを大きく設定すると、ダウンロードの反復回数が減り、逆に大きく設定すると、ダウンロードの反復回数が増えます。ファイルを引き継ぐ場合、単位サイズが小さいほど、ダウンロード操作を停止したときに失われるデータが少なくなります。

// ダウンロードするファイルのサイズを500MBに制限する。
dx.setLimitMultiDownloadSize(1024 * 1024 * 500);

// ダウンロード単位サイズを10MBに設定する。
dx.setDownloadBlockSize(1024 * 1024 * 10);

// 複数ファイルのダウンロードを開始する。
dx.download("AUTO", true);

• ダウンロード・ユニット・サイズは10MBが適切で、現在デフォルトで設定されています。
• これより小さい単位サイズは、メモリのオーバーヘッドを引き起こす可能性があり、低速ネットワークでのみ推奨されます。
• サーバーはHEADリクエストを許可しなければなりません。
• サーバーがRangeリクエストを許可していない場合、ファイルを分割せずに一度に受け取ることになります。

形式

component.setDownloadBlockSize(size);

パラメータ

2.0.0.0以上 4.4.0.0未満

説明

HD アプリケーションが単一ファイルのダウンロードに使用されているかどうかを返します。

形式

using = component.isUsingHDWhenSingle();

リターンタ

単一のファイルのダウンロードをする際にHDアプリケーションを使用するかどうか

2.0.0.0以上 4.4.0.0未満

説明

単一ファイルダウンロード用のHDアプリケーションを有効または無効にします。

画面上（GUI）からダウンロードアイコンをクリックしたときに実行される単一のファイルのダウンロードのみになる。downloadByIdメソッドを使用している場合には、設定に関係なく、ブラウザベースのダウンロードが実行される。

// HDアプリケーションを使用するように設定する。
dx.setUsingHDWhenSingle(true);

ダウンロードする対象と同じ名前を持つ項目が既に存在する場合、開発者は、このエントリを追加（重複）したり、無視できるように、コールバック関数（duplicated）を使用することができる。

dx.setUsingHDWhenSingle(true, function (duplicated) {
    if (confirm(duplicated + "ファイルが既に存在する。それでも追加しますか？")) {
        // return 0;または戻り値がない場合、重複に関係なく追加する。
    } else {
        // 無視する。
        return 1;
    }
});

戻り値に応じた内部処理方式は、次のとおりである。

• 1：項目を追加していない。
• 2：項目を追加し、以降に発生する重複件に対してコールバックを呼び出すことなく、自動的に追加される。
• 3：項目を追加せず、後に発生する重複件に対してコールバックを呼び出すことなく、自動的に無視される。
• その他の値：項目を追加する。

形式

component.setUsingHDWhenSingle(enable[, funcDuplication]);

パラメータ

3.10.0.0以上

説明

ファイルダウンロード操作の間隔を表す値を返します。

形式

interval = component.getDownloadTimeInterval();

リターンタ

ミリ秒（1/1000）単位の時間間隔値

3.10.0.0以上

説明

ファイルのダウンロード操作間の時間間隔の値を設定します。

複数ファイルのダウンロードでは、ファイル数とチャンク数に応じて複数のダウンロード操作が発生し、それぞれ指定した時間値だけ遅延します。

var dx = dx5.get("component-id");
dx.setDownloadTimeInterval(1000);

形式

component.setDownloadTimeInterval(interval);

パラメータ

3.10.0.0以上

説明

ダウンロードのためにサーバに HEAD リクエストを送信するかどうかを返します。

形式

useHead = component.isDownloadHeadRequestEnable();

リターンタ

true/false

3.10.0.0以上

説明

サーバーにダウンロードのための HEAD リクエストを送信するかどうかを設定します。

本製品は事前にHEADリクエストを送信し、ダウンロードするファイルの情報を取得します。サーバーがHEADリクエストを許可していない場合は、falseに設定してください。

HEADリクエストを行わないと、Continue機能が使えませんし、1つのファイルをダウンロードする際にサーバーエラーをチェックすることが難しくなります。

var dx = dx5.get("component-id");
dx.setDownloadHeadRequestEnable(false);

形式

component.setDownloadHeadRequestEnable(enable);

パラメータ

4.0.0.0以上

説明

ダウンロード方式を返します。

形式

mode = component.getDownloadMode();

リターンタ

'DEFAULT'、'AWSS3'、'NCPOS'、'AZRBSのいずれかが返されます。デフォルトは 'DEFAULT' です。

4.0.0.0以上

説明

ダウンロード方法を設定します。

• DEFAULT(デフォルト)： デフォルトでサポートするダウンロード方式を使用するときに使用します。
• AWSS3: Amazon S3からファイルをダウンロードする際に使用されます。4.0.0.0以降でサポートされています。
• NCPOS: NAVER CLOUD PLATFORM Object Storageからファイルをダウンロードする際に使用されます。4.2.0.0以降でサポートされています。
• AZRBS: Azure Blob Storageからファイルをダウンロードする際に使用されます。4.3.0.0以降でサポートされています。

const dx = dx5.get(id);
dx.setDownloadMode("AWSS3");

形式

component.setDownloadMode(mode);

パラメータ

4.0.0.0以上

説明

Amazon S3からファイルをダウンロードするための設定値を定義します。

dx.setDownloadMode("AWSS3");
dx.setAWSS3DownloadConfig({
    type: "NON-SECRET",
    accessKeyId: "ABCD...1234",
    secretAccessKey: "ABCD...1234",
    region: "ap-northeast-2",
    bucket: "abc-bucket"
});

形式

component.setAWSS3DownloadConfig(config);

パラメータ

dx.setAWSS3DownloadConfig({
    makeKey: item => {
        return item.name;
    }
});

4.2.0.0以上

説明

NAVER CLOUD PLATFORM Object Storageからファイルをダウンロードするための設定値を定義します。

dx.setDownloadMode("NCPOS");
dx.setNCPOSDownloadConfig({
    type: "NON-SECRET",
    accessKeyId: "ABCD...1234",
    secretAccessKey: "ABCD...1234",
    // kr, us, sg, jp, de
    region: "kr",
    bucket: "abc-bucket"
});

形式

component.setNCPOSDownloadConfig(config);

パラメータ

dx.setNCPOSDownloadConfig({
    makeKey: item => {
        return item.name;
    }
});

4.3.0.0以上

説明

AZURE Blob Storageからファイルをダウンロードするための設定値を定義します。

dx.setDownloadMode("AZRBS");
dx.setAZRBSDownloadConfig({
    sasDownloadURL: "https://example.com/get-download-sastoken.ashx"
});

形式

component.setAZRBSDownloadConfig(config);

パラメータ

dx.setAZRBSUploadConfig({
    makeKey: item => {
        return item.name;
    }
});

1.0.0.0以上

説明

ファイルのダウンロードを開始する。

ファイルをダウンロードするには、サーバーに存在する対象のパス情報を得る必要がありますが、仮想ファイルの属性を使用する。

デフォルトでは、ダウンロードできる仮想ファイルは1つだけです。したがって、フラグに一致するターゲットのうち、最初のファイルのみがダウンロードされます。もし複数のファイルのダウンロード（1.1.0.0からサポート）をしたい場合はuseMDパラメータをtrueに設定すると、複数のファイルのダウンロード方法で処理がされ、flagに合うターゲットの両方が順次ダウンロードされる。

ダウンロードはしたい仮想ファイルは必ずdownUrl属性にダウンロードすることができ、サーバー側アドレスが設定されなければならない。（1.4.1.0バージョンからurl属性でも可能である。）

ターゲットパスは、サーバーの機能を使用して、必ずContent-dispositionレスポンスヘッダの値がattachment状態であるように設定する必要がある。

ファイルダウンロードの場合、ターゲットが存在するかどうかを判断するためにHEADメソッドリクエストが送信され、HTTPレスポンスコードがエラーでなければ、ダウンロードが再度実行されます。

<script>
  function onDX5Created(id) {
    var dx = dx5.get(id);
    // ダウンロードパス情報がなくてダウンロードすることができない、仮想ファイルである。
    dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
    // ダウンロードパスがあればダウンロードすることができる。
    dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, downUrl: "http://domain/path/common-download.do?key=FID0001" });
  }
  function download(id) {
    // フラグの値に基づいてダウンロードを実行する。
    // AUTO：最初の仮想ファイルをダウンロードする。
    // SELECTED：選択された対象の中の最初の仮想ファイルをダウンロードする。
    // CHECKED：チェックされた対象の中の最初の仮想ファイルをダウンロードする。
    dx5.get(id).download("AUTO");
  }
  function multidownload(id) {
    // フラグの値に基づいてダウンロードを実行する。
    // AUTO：すべての仮想ファイルのエントリをダウンロードする。   
    // SELECTED：選択された仮想ファイルのエントリのすべてをダウンロードする。
    // CHECKED：チェックされた仮想ファイルのエントリのすべてをダウンロードする。
    dx5.get(id).download("AUTO", true);
  }
</script>
<button type="button" onclick="download('component-id');">単一ファイルのダウンロード</button>
<button type="button" onclick="multidownload('component-id');">複数のファイルをダウンロード</button>

ダウンロード方法をご利用の場合、バージョン1.0.0.0との違いがあります。単一ファイルのダウンロードの場合は、1.0.0.0のバージョンでは、flagの値に対応する対象がdownUrlが明示がされていない場合は、ダウンロードがキャンセルになったが、1.1.0.0のバージョンでは、flagの値に対応する対象がdownUrlが明示がされていない場合は、次の適切な対象を探す。したがって、正確に指定された対象をダウンロードするには、downloadはなくdownloadByIdを使用することをお勧めします。

バージョン1.1.0.0で追加されたマルチファイルダウンロード機能は、プラグイン技術を使用せず、純粋にブラウザの機能として実装されています。プラグインを使用したダウンロードのように、進行状況ウィンドウを提供はするが、ブラウザが最終的にファイルを保存する段階（製品が関与することはできない）が存在するため、ダウンロードが完了した場合でも、ブラウザでクエリするメッセージが表示されることがている。また、macOSでは、Safariブラウザのバージョン10.1以上のみをサポートしています。また、iOSおよびiPadでは、Safariブラウザのバージョン17以降がマルチファイルダウンロード（10ファイル以下）をサポートしています。

<script>
  function onDX5Created(id) {
    var dx = dx5.get(id);
    // ダウンロードパス情報がなくてダウンロードすることができない、仮想ファイルである。
    dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
    // ダウンロードパスがあればダウンロードすることができる。
    dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, url: "http://domain/path/common-download.do?key=FID0001" });
  }
  function download(id) {
    // フラグの値に基づいてダウンロードを実行する。
    // AUTO：すべての仮想ファイルのエントリをダウンロードする。
    // SELECTED：選択された仮想ファイルのエントリのすべてをダウンロードする。
    // CHECKED：チェックされた仮想ファイルのエントリのすべてをダウンロードする。
    dx5.get(id).download("AUTO");
  }
</script>
<button type="button" onclick="download('component-id');">ダウンロード</button>

形式

// 1.1.0.0以上
object.download(flag[, useMD]);

パラメータ

1.0.0.0以上

説明

指定された一意のIDに対応する仮想ファイルをダウンロードする。

ファイルをダウンロードするには、サーバーに存在する対象のパス情報を得る必要がありますが、仮想ファイルの属性を使用する。

ダウンロードする仮想ファイルは、downUrl属性にダウンロード可能なサーバー側のアドレスが設定されている必要があります（バージョン1.4.1.0では、url属性でも可能です）。

<script>
  function onDX5Created(id) {
    var dx = dx5.get(id);
    // ダウンロードパス情報がなくてダウンロードすることができない、仮想ファイルである。
    dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
    // ダウンロードパスがあればダウンロードすることができる。
    dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, downUrl: "http://domain/path/common-download.do?key=FID0001" });
  }
  function download(id) {
    var dx = dx5.get(id);
    // 二番目の仮想ファイルを選択します。
    var itemId = dx.getItemId(1);
    dx.downloadById(itemId);
  }
</script>
<button type="button" onclick="download('component-id');">ダウンロード</button>

ダウンロードパスはサーバー側コンポーネントを使用し、Content-dispositionレスポンスヘッダの値がattachmentでなければなりません。

さらに、ターゲットが存在するかどうかを判断するためにHEADメソッドリクエストが送信され、HTTPレスポンスコードがエラーでなければ、ダウンロードが再度実行されます。

<script>
  function onDX5Created(id) {
    var dx = dx5.get(id);
    // ダウンロードパス情報がなくてダウンロードすることができない、仮想ファイルである。
    dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
    // ダウンロードパスがあればダウンロードすることができる。
    dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, url: "http://domain/path/common-download.do?key=FID0001" });
  }
  function download(id) {
    var dx = dx5.get(id);
    // 二番目の仮想ファイルを選択します。
    var itemId = dx.getItemId(1);
    dx.downloadById(itemId);
  }
</script>
<button type="button" onclick="download('component-id');">ダウンロード</button>

形式

component.downloadById(id);

パラメータ

2.0.0.0以上 4.4.0.0未満

説明

指定された一意のIDに対応する仮想ファイルをHDアプリケーションを使用してダウンロードする。

ファイルをダウンロードするには、サーバーに存在する対象のパス情報を得る必要がありますが、仮想ファイルの属性を使用する。

仮想ファイルは、urlプロパティにダウンロードすることができ、サーバー側アドレスが設定されなければならない。

バージョン1.4.1.0から、downUrlとurlの2つのプロパティが使えるようになりました。

<script>
    function onDX5Created(id) {
        var dx = dx5.get(id);
        // ダウンロードパス情報がなくてダウンロードすることができない、仮想ファイルである。
        dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
        // ダウンロードパスがあればダウンロードすることができる。
        dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, url: "http://domain/path/common-download.do?key=FID0001", chunkSize: 10 });
    }
    function download(id) {
        var dx = dx5.get(id);
        // 二番目の仮想ファイルを選択します。
        var itemId = dx.getItemId(1);
        dx.downloadByIdToHD(itemId);
    }
</script>
<button type="button" onclick="download('component-id');">ダウンロード</button>

HDアプリケーションを使用してダウンロードをするときは、ダウンロード要求に対するサーバーのContent-dispositionレスポンスヘッダがattachementあるいはinlineの場合にかかわらず、強制的にファイルをダウンロードすることができる。

ダウンロードする対象と同じ名前を持つ項目が既に存在する場合、開発者は、このエントリを追加（重複）したり、無視できるように、コールバック関数（duplicated）を使用することができる。

var dx = dx5.get(id);
// 二番目の仮想ファイルを選択します。
var itemId = dx.getItemId(1);
dx.downloadByIdToHD(itemId, function (fileName) {
    if (confirm(fileName + "ファイルが既に存在する。それでも追加しますか？")) {
        // return 0;または戻り値がない場合、重複に関係なく追加する。
    } else {
        // 無視する。
        return 1;
    }
});

戻り値に応じた内部処理方式は、次のとおりである。

• 1：項目を追加していない。
• 2：項目を追加し、以降に発生する重複件に対してコールバックを呼び出すことなく、自動的に追加される。
• 3：項目を追加せず、後に発生する重複件に対してコールバックを呼び出すことなく、自動的に無視される。
• その他の値：項目を追加する。

形式

component.downloadByIdToHD(id[, duplicated]);

パラメータ

2.0.0.0以上 4.4.0.0未満

説明

HDアプリケーションを使用して、複数のファイルのダウンロードを開始する。

ファイルをダウンロードするには、サーバーに存在する対象のパス情報を得る必要がありますが、仮想ファイルの属性を使用する。

ダウンロードはしたい仮想ファイルは必ずurlプロパティにダウンロードすることができ、サーバー側アドレスが設定されなければならない。

バージョン1.4.1.0から、downUrlとurlの2つのプロパティが使えるようになりました。

<script>
    function onDX5Created(id) {
        var dx = dx5.get(id);
        // ダウンロードパス情報がなくてダウンロードすることができない、仮想ファイルである。
        dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
        // ダウンロードパスがあればダウンロードすることができる。
        dx.addVirtualFile({ vindex: "IDX0003", name: "bridge_509147.jpg", size: 509147, url: "http://domain/path/common-download.do?key=FID0001", chunkSize: 10 });
    }
    function download(id) {
        // フラグの値に基づいてダウンロードを実行する。
        // AUTO：仮想ファイルをダウンロードする。
        // SELECTED：選択された仮想ファイルをダウンロードする。
        // CHECKED：チェックされた仮想ファイルをダウンロードする。
        dx5.get(id).downloadToHD("AUTO");
    }
</script>
<button type="button" onclick="download('component-id');">파일 ダウンロード</button>

特別なコードを処理せずに「AUTO」のパラメータの値を持ってアップロードを処理しようとした場合、コンポーネントの作成時にbtnDownloadToHDAuto属性値を使用して自動的にバインドして使用することができる。

<button id="btn-download" type="button">ダウンロード</button>
<script>
    dx5.create({
        ...,
        // ファイルのダウンロード機能が自動的に接続される。
        btnDownloadToHDAuto: "btn-download"
    });
</script>

btnDownloadToHDAuto属性のほかに、btnDownloadToHDSelected、btnDownloadToHDCheckedを使用することができる。

ダウンロードする対象と同じ名前を持つ項目が既に存在する場合、開発者は、このエントリを追加（重複）したり、無視できるように、コールバック関数（duplicated）を使用することができる。

var dx = dx5.get(id);
dx.downloadToHD("AUTO", function (fileName) {
    if (confirm(fileName + "ファイルが既に存在する。それでも追加しますか？")) {
        // return 0;または戻り値がない場合、重複に関係なく追加する。
    } else {
        // 無視する。
        return 1;
    }
});

戻り値に応じた内部処理方式は、次のとおりである。

• 1：項目を追加していない。
• 2：項目を追加し、以降に発生する重複件に対してコールバックを呼び出すことなく、自動的に追加される。
• 3：項目を追加せず、後に発生する重複件に対してコールバックを呼び出すことなく、自動的に無視される。
• その他の値：項目を追加する。

ボタンに自動的にバインドをして使用する場合には、重複処理のためのコールバック関数を適用することができない。

形式

component.downloadToHD(flag[, duplicated]);

パラメータ

2.0.0.0以上 4.4.0.0未満

説明

HDアプリケーションに設定されたダウンロードパスを返します。

dx.getDownloadPathOfHD(function (path) {
  // HDアプリケーションのダウンロードパスである。
  console.log(path);
});

HDアプリケーションを使用する場合に使用されるメソッドは、ほとんど内部的に非同期操作を実行する。非同期の操作を実行するため、戻り値を受け取るまでスレッドが待機していない、要求の結果を受け取るためのコールバック関数を使用しなければならない。

形式

component.getDownloadPathOfHD(success);

パラメータ

2.0.0.0以上 4.4.0.0未満

説明

ダウンロードパスを設定する。

// ドライブ文字で開始すると、絶対パスが設定される。
dx.setDownloadPathOfHD("c:\\temp");
// <home>文字列で起動すると、ユーザーフォルダサブ経路が設定される。
dx.setDownloadPathOfHD("<home>\\temp");
// <doc>文字列で起動すると、ドキュメントフォルダのサブ経路が設定される。
dx.setDownloadPathOfHD("<doc>\\temp");
// <desktop>文字列で起動すると、デスクトップフォルダサブパスが設定される。
dx.setDownloadPathOfHD("<desktop>\\temp");
// <downloads>文字列で起動すると、ダウンロードフォルダサブパスが設定される。（2.5.0.0バージョンからサポート）
dx.setDownloadPathOfHD("<downloads>\\temp");

もしダウンロードパスを変更した後は、その変更値をすぐに知りたい場合は、コールバック関数（success）を使用する。

dx.setDownloadPathOfHD("<doc>\\temp", function (path) {
  console.log(path);
});

HDアプリケーションを使用する場合に使用されるメソッドは、ほとんど内部的に非同期操作を実行する。非同期の操作を実行するため、ジョブの処理結果を受け取るまでスレッドが待機していない、要求の結果を受け取るためのコールバック関数を使用しなければならない。

形式

component.setDownloadPath(path[, success]);

パラメータ

1.0.0.0以上

説明

現在ダウンロードの状態情報を持つオブジェクトを返します。

ファイルがダウンロードされているプロセスで使用すると、アップロードの状態情報を把握することができる。

この関数を使用して、返されたオブジェクトは、時間に応じて異なる値を持つのではなく、関数呼び出し時の状態をコピーした値のみ持つ。

ダウンロードする過程の変化を継続取得するにはsetTimeoutのような関数を使用する必要がある。

function toggleDownloadStatus(isBegin) {
  function downloadProgress() {			
    var dx = dx5.get("dext5"), 
        out = document.getElementById("downstatus-value"), 
        status = dx.getDownloadStatus();
    out.innerHTML = "" + 
      "name: " + status.currentName + "<br/>" + 
      "speed: " + status.totalSpeed + "(sec)<br/>" + 
      "count(completed/total): " + status.completeCount + "/" + status.totalCount + "<br/>" + 
      "current rate: " + status.currentRate + " % <br/>" + 
      "current size(received/total): " + status.currentReceiveSize + "/" + status.currentSize + " (bytes)<br/>" + 
      "current time(past/remained): " + status.currentTime + "/" + status.remainedCurrentTime + "<br/>" + 
      "total rate: " + status.totalRate + " % <br/>" + 
      "total size(received/total): " + status.totalReceiveSize + "/" + status.totalSize + " (bytes)<br/>" + 
      "total time(past/remained): " + status.totalTime + "/" + status.remainedTotalTime + "<br/>" + 
      "";
    if (window.isDownloading === true) {
      setTimeout(downloadProgress, 1000);
    }
  }
  window.isDownloading = isBegin;
  if (isBegin) downloadProgress();
}

形式

status = component.getDownloadStatus();

リターンタ

ダウンロード転送状態値を持つオブジェクト

以下は、オブジェクトが持つ属性の説明である。

2.0.0.0以上 4.4.0.0未満

説明

HDアプリケーションのダウンロードフォルダを変更するためにフォルダ選択ダイアログウィンドウを表示し。

複数のファイルをダウンロードするために、ダウンロードする前にダウンロードする場所を設定する必要がある。

ダウンロードの場所を変更しない場合、デフォルトの場所（ドキュメントフォルダのサブDEXTUploadX5 HDMフォルダ）が使用される。

function changePath(id) {
  var dx = dx5.get(id);
  dx.openDownloadPathDialogOfHD();
}

openDownloadPathDialogOfHDメソッドは、ユーザーにダウンロードパスを選択機会を与える目的で使用される。

ダウンロードパスが変更になると、コールバック関数を使用して変更されたパスを得ることができる。

function changePath(id) {
  var dx = dx5.get(id);
  dx.openDownloadPathDialogOfHD(function (path) {
    // 変更されたダウンロードパスを得ることができる。
    console.log(path);
  });
}

形式

component.openDownloadPathDialogOfHD([success]);

パラメータ

2.4.0.0以上 4.4.0.0未満

説明

HDアプリケーションに設定されたオプションの情報をコールバック関数に返されます。

dx.getOptionsOfHD(function (option) {
  // optionパラメータは、HDアプリケーションのオプション情報を持っているJSONオブジェクトである。
});

オプションオブジェクトは、次のとおりである。

{
	// ファイルが追加されると、プログラムが自動的に有効に
	autoActivation: true,
	// ファイルが追加されると、自動的にダウンロードを開始
	autoDownload: true,
	// ファイルを削除すると、ローカルに残された一時ファイルの情報も削除
	deleteTemporary: false,
	// ダウンロードが中断されたファイルがあるとき、プログラムが有効になるとすぐにダウンロードを開始し
	resumeDownload: true,
	// ファイルがダウンロードされるとき、プログラムが閉じても、一時的な情報で残される項目対象
	saveStatus: {
		// スタンバイまたは停止された項目
		waitStop: true,
		// ダウンロードしていた項目
		downloading: true,
		// ダウンロードが完了した項目
		complete: true,
		// エラーが発生したアイテム
		error: true
	}
}

形式

component.getOptionsOfHD(success);

パラメータ

2.4.0.0以上 4.4.0.0未満

説明

HDアプリケーションのオプションを一度に設定する。

dx.setOptionsOfHD({
	autoActivation: true,
	autoDownload: true,
	deleteTemporary: false,
	resumeDownload: true,
	saveStatus: {
		waitStop: true,
		downloading: true,
		complete: true,
		error: true
	}
}, function () { ... });

形式

component.setOptionsOfHD(option[, success]);

パラメータ

{
	// ファイルが追加されると、プログラムが自動的に有効に
	autoActivation: true,
	// ファイルが追加されると、自動的にダウンロードを開始
	autoDownload: true,
	// ァイルを削除すると、ローカルに残された一時ファイルの情報も削除
	deleteTemporary: false,
	// ダウンロードが中断されたファイルがあるとき、プログラムが有効になるとすぐにダウンロードを開始し
	resumeDownload: true,
	// プログラムが閉じても維持されている項目対象
	saveStatus: {
		// スタンバイまたは停止された項目
		waitStop: true,
		// ダウンロード中だった項目
		downloading: true,
		// ダウンロードが完了した項目
		complete: true,
		// エラーが発生したアイテム
		error: true
	}
}

2.4.0.0以上 4.4.0.0未満

説明

自動アクティブ化オプションの値を設定する

自動アクティブ化とは、ダウンロードしたいファイルのエントリをHDアプリケーションに登録したとき、HDアプリケーションをアクティブに変えることをいう。この値がtrueであれば、隠されていたアプリケーションがウィンドウモードで見えるようになる。

// 自動アクティブ化オプションをtrueに変更する。
dx.setAutoActivationOptionOfHD(true, function () {
    ...
});

形式

component.setAutoActivationOptionOfHD(value[, success]);

パラメータ

2.4.0.0以上 4.4.0.0未満

説明

自動ダウンロードオプションの値を設定する。

自動ダウンロードとダウンロードしたいファイルのエントリをHDアプリケーションに登録したとき、HDアプリケーションを対象にすぐにダウンロードすることをいう。

// 自動ダウンロードオプションをtrueに変更する。
dx.setAutoDownloadOptionOfHD(true, function () {
    ...
});

形式

component.setAutoDownloadOptionOfHD(value[, success]);

パラメータ

2.4.0.0以上 4.4.0.0未満

説明

一時ファイルを削除するオプションの値を設定する。

一時ファイルの削除とは、アプリケーションからダウンロード項目を削除するときは、アイテムの一時ファイルも削除することをいう。ファイルのダウンロードを開始した後、ダウンロードが完了しない場合、常に、一時ファイルが残っている。

// 一時ファイルを削除するオプションをtrueに変更する。
dx.setDeleteTemporaryOptionOfHD(true, function () {
    ...
});

形式

component.setDeleteTemporaryOptionOfHD(value[, success]);

パラメータ

2.4.0.0以上 4.4.0.0未満

説明

再（再度）のダウンロードオプションの値を設定する。

再（再度）ダウンロードとダウンロードが完了していない項目がある状態で、プログラムが終了した後、再度プログラムが実行されると、完了していない対象のファイルを自動的にダウンロードする。

// 再（再度）ダウンロードオプションをtrueに変更する。
dx.setResumeDownloadOptionOfHD(true, function () {
    ...
});

形式

component.setResumeDownloadOptionOfHD(value[, success]);

パラメータ

2.4.0.0以上 4.4.0.0未満

説明

終了後に保持対象のオプションの値を設定する。

終了後に保持対象とプログラムが終了した後、再度プログラムが実行されたとき、支持項目を指す。

// 終了後に保持対象を変更する。
dx.setSaveStatusOptionOfHD(15, function () {
    ...
});

downloading値（2）が不足している場合、再（再度）ダウンロードオプションの設定に影響を受ける項目がないので、自動的にダウンロードするアイテムが保持されない。

形式

component.setSaveStatusOptionOfHD(value[, success]);

パラメータ

1.1.0.0以上

説明

ファイルのダウンロードを停止する。

DEXTUploadX5は、コンポーネント自体にダウンロードを停止するボタンやGUI要素がない。

代わりに、スクリプトを使用して停止することができるように関数を提供している。

<button type="button" onclick="stop('component-id');">停止</button>
<script>
function stop(id) {
  dx5.get(id).stopDownloading();
}
</script>

コンポーネントの作成時にbtnStopDownloading属性値を使用して自動的にバインドして使用することができる。

<button id="btn-stop-downloading" type="button">停止</button>
<script>
  dx5.create({
    ...,
    // ダウンロードを停止機能が自動的に接続される。
    btnStopDownloading: "btn-stop-downloading"
  });
</script>

IEモジュールとは異なり、複数のモジュールは、1.1.0.0のバージョンが後からサポートする。

中断できるのは、複数ファイルのダウンロード操作のみです。 ダウンロード対象がdownloadByIdまたはダウンロードアイコンを使用してダウンロードされている場合、stopDownloading関数を使用しても操作は中断されません。

形式

component.stopDownloading();