データベース・テーブル関連タグ
データベース・テーブルとしてアクセスするテンプレート・タグ
mt:SheetAssetTable または mt:SheetAssetRecords
ブロックワークシートをデータベース・テーブルとみなし、行レコードをループします。
属性
属性名 | 説明 |
---|---|
worksheet | ワークシートを名称により指定します。 |
worksheet_index | ワークシートを番号(1 から)により指定します。 |
workbook | 1 を指定すると、ワークブック内の全てのワークシートを連結して処理します。同じ構造のデータを複数のワークシートに分けて管理している場合に便利です。 |
skip_headers | 列名を示す行までスキップする行数を指定します。デフォルトはスキップせず1行目を列名とみなします(skip_header="0" )。 |
skip_rows | 列名を示す行から実際の行レコードまでスキップする行数を指定します。デフォルトはスキップせず、2行から行レコードとみなします(skip_rows="0" )。 |
filter_field | 絞り込みを行う列名を指定します。filter_value やfilter_regex と組み合わせて使用します。 |
filter_value | 絞り込みを行う条件の値を指定します。filter_field も必ず指定します。 |
filter_regex | 絞り込みを行う条件の正規表現を指定します。filter_field も必ず指定します。 |
filter_eval | 絞り込みを行う条件のPerl式を指定します。 |
filter_invert | 条件の否定で絞り込みをします(条件に合致しないレコードを絞り込みます)。 |
sort_field | 並べ替えを行う列名を指定します。 |
sort_order | 並べ替えの順序を指定します。sort_field も必ず指定します。昇順の場合はasc 、降順の場合はdesc を指定します。指定しない場合は昇順asc が適用されます。 |
sort_as | 数値として並べ替えを行うか(number )、文字列として並べ替えを行うか(string )を指定します。省略した場合はstring が適用されます。例えば 9 と10 を文字列として比較すると、昇順の場合、10 の方が上位になりますが、数値として比較すると9 の方が上位になります。 |
sort_eval | 並べ替えを行うPerl式(map関数と互換)を指定します。 |
offset | 開始レコードを0 から始まる数値で指定します。省略すると先頭を示す0 が適用されます。 |
limit | レコード数の上限を数値で指定します。省略すると末尾までの全レコードを繰り返します。 |
file | サーバー内のファイルパスを指定します。詳しくは任意のファイルを利用するにはを参照ください。 |
url | 外部ファイルのURLを指定します。詳しくは外部のファイルを利用するにはを参照ください。 |
tag | カスタムフィールドなどのテンプレートタグ名を指定します。展開の結果、URLを指し示す場合は、url 属性にその値を指定された場合と同等に動作します。URLカスタムフィールドを使うにはや、画面上で編集可能な表を使うにはを参照ください。 |
絞り込みと並べ替えについて詳しくは、絞り込みや並べ替えをするにはをご参考ください。
mt:SheetAssetField
ファンクションmt:SheetAssetTable
テンプレート・タグの内部で、対象の行レコードの特定の列の値を出力します。
属性
属性名 | 説明 |
---|---|
name | 列名を指定します。 |
例1
店舗情報のスプレッドシートを整形して出力します。
xml
<dl>
<mt:SheetAssetTable>
<dt><mt:SheetAssetField name="店舗名"></dt>
<dd><mt:SheetAssetField name="住所"></dd>
</mt:SheetAssetTable>
</dl>