用語
スプレッドシート
CSVファイルまたはExcelファイル、およびそのデータを示します。行列をベースとするデータ形式を持ちます。
ワークブック
CSVファイルまたはExcelファイル全体を表します。ワークブックは、ひとつないし複数の ワークシート から構成されています。
ワークシート
行列からなる表形式のデータです。
Excelでは、タブによって切り替えが行われ、各ワークシートは名称を持っています。
CSVファイルは、名前のないワークシートが1枚だけ含まれるという構造になります。
行列 と データベース・テーブル
SheetAssetにはワークシート内のデータを取得する方法が2種類あります。これらは同一のスプレッドシート
ひとつはExcelのように、表形式の情報をそれぞれテンプレート・タグのループにより取得する行列形式です。
もうひとつは、1行目を列名として、それ以降の各行で列名による値の指定を可能にするデータベース・テーブル形式です。RDBMSのテーブルにちなんでそのように呼びます。
それぞれのデータ形式をJSONで表現すると以下のようになります。
行列
行列形式は配列の配列となります。ワークシートの内容をそのまま出力する場合に便利です。
[
[ '店舗名', '住所' ],
[ '本店', '東京都港区1-1-1' ],
[ '札幌支店', '北海道札幌市1-1-1' ],
[ '福岡支店', '福岡県福岡市1-1-1' ]
]データベース・テーブル
データベース・テーブル形式はオブジェクトの配列となります。ワークシートから特定の列を抜き出して出力する場合に便利です。
[
{ '店舗名': '本店', '住所': '東京都港区1-1-1' },
{ '店舗名': '札幌支店', '住所': '北海道札幌市1-1-1' },
{ '店舗名': '福岡支店', '住所': '福岡県福岡市1-1-1' },
]