Excelファイルのインポートとエクスポート

SpreadJS は、次の方法を使用して Excel ファイルへのインポートとエクスポートをサポートします。

クライアント側で Excel のインポートとエクスポート
SJS ファイル形式で Excel のインポートとエクスポート
暗号化された Excel ファイルのインポートとエクスポート

クライアント側で Excel のインポートとエクスポート

クライアント側でインポートおよびエクスポートメソッドを使用すると、Excelファイル（.xlsx）をJSONにインポートしたり、JSONオブジェクトをExcelにエクスポートしたりできます。

type=warning
saveメソッドで生成したExcel形式ファイルの状態は、ダウンロードによって読み取り専用となります。これはインターネットを経由してダウンロードされるファイルに対してウェブブラウザがZone.Identifier情報を自動的に付与した影響です。Microsoft ExcelはZone.Identifier情報を検知し、Excel形式ファイルの初回オープン時に警告メッセージを表示します。また、エクセルファイルをインポートおよびエクスポートするには、gc.spread.excelio.xx.x.x.min.jsを参照する必要があります。

Excelファイルをローカルにダウンロードすることも、返されたExcelファイル（BLOB型）を取得し、サーバーに送信することもできます。

コードの使用

次のサンプルコードは、Excelファイルを開き、保存します。コードの最初の部分は、クライアント側のインポートおよびエクスポートの依存関係のファイルを示します。

<!DOCTYPE html>
<html lang="en">
<head>
    <title>SpreadJS Client Side ExcelIO</title>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/FileSaver.js/2023-11-29/FileSaver.min.js"></script>
    <link href="./css/gc.spread.sheets.excel2013white.x.x.x.css" rel="stylesheet"/>
    <script src="./scripts/gc.spread.sheets.all.x.x.x.min.js" type="application/javascript"></script>
    <!--For client-side excel i/o-->
    <script src="./scripts/interop/gc.spread.excelio.x.x.x.min.js"></script>
</head>
<body>
<div>
    <input type="file" name="files[]" id="fileDemo" accept=".xlsx"/>
    <input type="button" id="loadExcel" value="Import" onclick="ImportFile()"/>   
    <input type="button" class="btn btn-default" id="saveExcel" value="Export" onclick="ExportFile()"/>
<input type="text" id="exportFileName" placeholder="Export file name" class="form-control" value="export.xlsx"/>
    <div id="ss" style="width:100%; height:500px"></div>
</div>
</div>
</body>
<script>
    var workbook, excelIO;
window.onload = function () {
workbook = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
excelIO = new GC.Spread.Excel.IO();
    }
    function ImportFile() {
        var excelFile = document.getElementById("fileDemo").files[0];
        excelIO.open(excelFile, function (json) {
            var workbookObj = json;
           workbook.fromJSON(workbookObj);
        }, function (e) {
            console.log(e);
        });
    }
    function ExportFile() {
        var fileName = document.getElementById("exportFileName").value;
        if (fileName.substr(-5, 5) !== '.xlsx') {
            fileName += '.xlsx';
        }
        var json = JSON.stringify(workbook.toJSON());
        excelIO.save(json, function (blob) {
            saveAs(blob, fileName);
        }, function (e) {
            console.log(e);
        });
    }
</script>
</html>

SJS ファイル形式で Excel のインポートとエクスポート

Excelファイル（.xlsx）を.SJS形式（SpreadJSファイルタイプ）にインポートし、openまたはsaveメソッドを使用して.SJSファイルをExcelファイルにエクスポートすることができます。膨大なExcelファイルをインポートする場合、.SJS形式を利用することで、読み込み時間とメモリ使用量を大幅に改善できます。また、再保存時にファイルサイズを大幅に削減できます。

このサンプルコードは、open メソッドと save メソッドを使用して Excel ファイルを開いて保存する方法を示します。

// SJS ファイルをスプレッドに開きます。
function OpenFile() 
{ 
var excelFile = document.getElementById("fileDemo").files[0]; 
spread.open(excelFile, () => { 
}, function (e) { 
    console.log(e); 
});  
} 

// スプレッドをxlsxファイルにエクスポートします。
function SaveFile()
{ 
var fileName = document.getElementById("exportFileName").value; 
if (fileName.substr(-5, 5) !== '.xlsx') 
{ fileName += '.xlsx'; } 
spread.save(sjs, function (blob)  {
    saveAs(blob, fileName);
}, function (e) { 
    console.log(e);
});
}

次の表は、Excelファイルにインポートまたはエクスポートできる機能を示します。

機能	説明	インポート（excelをjsonに）	エクスポート（jsonをexcelに）
ワークブック（spread）	tabstrip: tabStripVisible, startSheetIndex, tabStripRatio, tabColor	√	√
	スクロールバー： showHorizontalScrollbar, showVerticalScrollbar	√	√
	シート: シートの名前、シートの表示/非表示設定	√	√
	参考スタイル：R1C1またはA1	√	√
	カスタム名	√	√
共有の文字列	データシートに使用された文字列（共通の文字列、空白文字列）	√	√
テーマ	カラースキーム	√	√
	フォントスキーム（ Spread.Sheetsには詳細なフォントがありません）	√	√
	フォーマットスキーム（Spread.Sheetsにはフォーマットスキームがありません）	X	√
スタイル	cellStyles：Spread.Sheetsがサポートされているすべてのスタイル	√	√
	さまざまな形式（テーブルに使用される形式、条件付き形式またはフィルタ）	√	√
	tableStyles	√	√
ワークシート	rowRangeGroup、colRangeGroup	√	√
	rowCount と columnCount	√	√
	グリッドライン表示/非表示設定、グリッドラインの色	√	√
	列ヘッダ/行ヘッダの表示/非表示設定	√	√
	ズーム	√	√
	選択	√	√
	activeRow、 activeColumn	√	√
	行・列の固定 (frozenRowCount, frozenColumnCount)	√	√
	デフォルトのrowHeightまたはcolumnWidth	√	√
	columnInfo：列の幅、表示/非表示、スタイル設定	√	√
	セル結合	√	√
	シートの保護の状態	√	√
	rowInfo: 行の高さ、表示/非表示、スタイル設定	√	√
	cellInfo：セルの値、数式、スタイル、結合設定	√	√
	カスタム名	√	√
	条件付き形式	√	√
	コメント	√	√
	画像	√	√
	スライサー	√	√
	スパークライン	√	√
	テーブル	√	√
	フィルタ	√	√
	検証	√	√
	アウトライン	√	√
	印刷	√	√

暗号化された Excel ファイルのインポートとエクスポート

SpreadJSは、暗号化されたExcelファイルのインポートとエクスポートをサポートします。インポートまたはエクスポートする時に、次のモジュールを参照する必要があります。

<script src="scripts/gc.spread.sheets.io.0.0.0.min.js"></script>

暗号化されたExcelファイルのインポート

暗号化されたExcel ファイルをインポートするには、importメソッドのpasswordプロパティにパスワードを設定する必要があります。正しいパスワードが指定されている場合、ファイルは正常にインポートされます。ただし、無効または正しくないパスワードを指定すると、errorCallBack 関数がトリガーされ、エラーが返されます。ErrorCode 列挙体のメンバーを使用すると、エラーメッセージを指定できます。

次のサンプルコードは、暗号化されたExcelファイルをインポートする方法を示します。

const userPassword = 'Asdf0123';   
// パスワード付き Excel ファイルをインポートします。
const errorCallback = (e) => {
    if (e.errorCode = GC.Spread.Sheets.IO.errorCode.invalidPassword) {
        console.log('無効なパスワードです。');
    } else if (e.errorCode = GC.Spread.Sheets.IO.errorCode.noPassword) {
        console.log('パスワードを入力してください。');
    }
}
spread.import(file, () => { }, errorCallback, {
    fileType: GC.Spread.Sheets.FileType.excel,
    password: userPassword, 
})

暗号化されたExcelファイルのエクスポート

exportメソッドのpasswordプロパティを指定することで、 Excel ファイルをエクスポートする時にパスワードを設定することは出来ます。SpreadJS では、パスワードを指定する場合に暗号化されたExcelファイルがエクスポートします。パスワードを指定しない場合、暗号化されない元のExcelファイルをエクスポートします。

次のサンプルコードは、暗号化されたExcelファイルをエクスポートする方法を示します。

const userPassword = 'ABC0123';
const fileName = 'encrypt-export.xlsx';
// パスワード付き Excel ファイルをエクスポートします。
spread.export(blob => saveAs(blob, fileName), e => console.log(e),
 {fileType: GC.Spread.Sheets.FileType.excel,
 password: userPassword,
}
);

デザイナの使用

SpreadJSデザイナを使用する場合もExcelファイルのインポートまたはエクスポートする時にパスワードを設定することができます。

暗号化されたファイルをインポートするには、［ファイル］をクリックして［インポート］を選択します。［インポート］メニューページで［Excelファイル］を選択してファイルインポート設定を指定し、［パスワード］フィールドにパスワードを入力して［Excelファイル］をクリックします。

ImportEncryptedExcel

暗号化されたファイルをエクスポートするには、［ファイル］をクリックして［エクスポート］を選択します。［エクスポート］メニューページで［Excelファイル］を選択してファイルのエクスポート設定を指定し、［パスワード］フィールドにパスワードを入力して［Excelファイル］をクリックします。

ExportEncryptedExcel