Appearance
マークアップページの記法
マークアップページのコードの文法と、よく使う組み立て方を説明します。要素ごとの属性は、要素一覧を参照してください。
書き方の規則
コードは、HTML に似たタグで要素を書きます。書けるタグと属性は、要素一覧にあるものだけです。HTML のタグ、CSS、class、style は書けません。
html
<Columns>
<SqlView id="…" page="…" sql="…">
<Card title="今月の売上">
<Text size="2xl" weight="bold">{{ row.sales }}</Text>
</Card>
</SqlView>
<Chart id="…" page="…" chart="…" />
</Columns>- タグ名と属性名は、大文字と小文字を区別します
- すべての要素を閉じます。子を持たない要素は
/>で閉じます - 属性の値は
"で囲みます。値に"を含むときは'で囲みます - 真偽値の属性は、値なしで書くと真になります(
<Collapse open>) - 本文の
<は<と書きます。{{ … }}の中には、<をそのまま書けます - 本文の空白と改行は、1 つの空白にまとめて表示されます(空白と改行)
- Markdown は解釈されません。太字や色は
<Span>、箇条書きは<List>で書きます <!-- … -->はコメントです。{{を文字として書くときは、\{{と書きます
解釈が曖昧な書き方は、推測で補われず、エラーになります。
空白と改行
文字を表示する要素(<Text>・<Heading> など)の中の空白と改行は、HTML と同じく扱われます。
- 連続する空白と改行は、1 つの空白にまとめて表示されます。
<Text>・<Heading>などでは、中の最初と最後の空白は表示されません <Span>・<If>・<For>などの境目をまたいでも、空白は 1 つにまとめて表示されます- 制御要素の前後で改行すると、その改行も空白になります。日本語の文で空白を入れたくないときは、改行せずに続けて書きます
html
<Text>前月より<If condition="{{ row.mom > 0 }}">増加</If><Else>減少</Else>しました</Text>
<!-- 前月より増加しました -->
<Text>
前月より
<If condition="{{ row.mom > 0 }}">増加</If>
<Else>減少</Else>
しました
</Text>
<!-- 前月より 増加 しました -->- 文の中で改行するときは、
<Br />を書きます <Tag>の前後には小さな余白があるので、空白を書かずに並べても、間が空いて表示されます
コードの構造
要素ごとに、どの要素の中に書けるか(親)と、中に何を書けるか(子)が決まっています。要素のリファレンスの「構造」の表で確認できます。
構造上の区分
| 区分 | 内容 |
|---|---|
block | ページに並べる要素(<Text>・<Card>・<Chart> など)。ページの直下と、子に block を取る要素の中に書く |
inline | 文の中に書く要素(<Span>・<Link> など)。<Text>・<Span> の中に書く |
text・expr | 文字と {{ … }}。<Text>・<Heading> など、文字を表示する要素の中に書く |
control | 出し分けと繰り返し(<If>・<For> など)。子に block・inline・control のいずれかを取る要素の中に書く。条件と繰り返しを参照 |
| ― | 決まった親の中にだけ書く要素(<ListItem>・<Tab> など) |
<Card> や <TableCell> の中に文字を書くときは、<Text> で囲みます。
要素の ID
<Chart>・<SqlView>・<Heading>・<UploadedImage> など、実行結果・画像・リンクに関連付けられる要素には、id を書きます。id が必要な要素は、属性の表で確認できます。
- 形式は ObjectId(16 進数 24 文字)で、ページの中で重複しないようにします
cdm notebook formatで、不足しているidが補われます。自分で書くときは、cdm util gen-idなどで生成した値を使います- 要素をコピーしたときや、同じチャートを 2 か所に置くときは、別の
idにします
- 実行結果と画像は
idに関連付けられるため、要素を移動しても保持されます。idを書き換えると、別の要素として扱われます <SqlView>の中の要素には、idを書けません
式
本文や属性の値に、{{ … }} で式を書きます。パラメータの値や SQL の結果を、文字・条件・見た目に使えます。
書ける場所
式の書き方は、書く場所によって 2 通りあります。どちらで書くかは、属性の表の値の欄(「式:単一式」「式:文字+式」)で確認できます。
- 文字+式:文字の中に、値を文字列に変換して差し込みます(
title="{{ r.segment }} の解約")。本文と、titleなど見出しや説明の属性に書けます - 単一式:値全体を 1 つの
{{ … }}にします(condition="{{ row.mom < 0 }}")。条件・数値・色など、型が決まった属性に書けます。値の欄が「式(…)」の属性も単一式です
書ける式
- リテラル:文字列(
'…'か"…")、数値、true、false、null - 演算子:
==!=<<=>>=in&&||!c ? a : b、数値の+-*/、括弧( ) - 関数:
size()・sum()・max()・formatNumber()・formatDate()など(式の関数)
ここにない計算は、SQL で列として用意します。属性の値の式で文字列を書くときは、属性を囲む引用符と別の引用符を使います(condition="{{ row.region == 'East' }}")。
式から参照できる値
| 書き方 | 内容 | 参照できる場所 |
|---|---|---|
param_<パラメータの ID> | パラメータの値 | どこでも |
view.<名前> | 表示の状態(表示の状態) | どこでも |
env.<名前> | 閲覧している環境(式の環境変数) | どこでも |
row・rows[n]・size(rows) | <SqlView> の結果の行(行の参照) | <SqlView> の中 |
<For> の as・index の変数 | 繰り返している行やグループと、何回目か | <For> の中 |
<Group> の as の変数 | グループ化したデータ(行のグループ化) | <Group> の中 |
- パラメータは、最後に実行したときの値を参照します。入力欄で変えただけの値は、実行するまで反映されません
- 一度も実行していないパラメータはゼロ値になります(文字は
''、日付は'1970-01-01'、数値は0、複数の値は[]など)。型は式のパラメータの型にあります
値の書式
列をそのまま差し込む({{ row.ts }})と、列の型に合わせた書式で表示されます。式を通した値(計算の結果、条件で選んだ値など)には、書式が適用されません。書式は formatNumber()・formatDate() で指定します(式の書式)。
| 式 | 表示(JST の場合) |
|---|---|
{{ row.ts }} | 2026/9/30 12:34:56 |
{{ row.ok ? row.ts : '' }} | 2026-09-30T03:34:56Z |
{{ formatDate(row.ts, "dayjs", "M/D HH:mm") }} | 9/30 12:34 |
- 書式は閲覧者の言語設定に、タイムスタンプは閲覧者のタイムゾーンに従います
- ID など、桁区切りが要らない整数は
formatNumber(row.id, "d3", "d")で表示します - 書式を適用した値は文字列です。条件では、書式を適用する前の値で比較します
- 配列(複数の値を持つパラメータなど)は、
,で区切って表示されます
SQL の実行結果の表示
<SqlView> は、SQL ブロックの実行結果を、中に書いた要素で表示します。
html
<SqlView id="…" page="…" sql="…" hideFrame>
<Columns>
<Card title="売上">
<Text size="2xl" weight="bold">{{ formatNumber(row.sales, "compact") }}</Text>
<Text size="sm" color="muted">前月比 <Delta value="{{ row.mom }}" format=".1%" /></Text>
</Card>
<Card title="注文数">
<Text size="2xl" weight="bold">{{ row.orders }}</Text>
</Card>
</Columns>
</SqlView>- 中には、
<Chart>・<SqlResult>・<SqlView>・<Parameter>・<UploadedImage>は書けません。<SqlView>の外に書きます - 中に
<Card>を並べるときは、hideFrameを書いて枠の重なりを避けます <SqlView>はクロスフィルタに参加しません
行の参照
| 書き方 | 内容 |
|---|---|
row | 1 行目(rows[0] と同じ) |
rows[n] | n 行目(0 から数える)。n は整数のリテラルだけ |
size(rows) | 受け取った行の数 |
- 列は
row.salesで参照します。名前が ASCII の識別子でない列はrow['売上']で参照します - 受け取るのは、結果の先頭から 1,000 行までです。列の合計や最大値は、式の関数の
sum()・max()などで求めます。結果が 1,000 行を超えるときは、全体の件数や合計を SQL で列として返します - 0 行のときも中は表示されます。
<If condition="{{ size(rows) == 0 }}">でメッセージを表示します - 実行結果にない列を参照すると、スキーマエラーになります。スキーマエラーは
cdm notebook validateでは検出されず、cdm notebook runではステータスがERRORになります <ParameterOverride>で上書きしても、中のparam_<ID>はページのパラメータの値のままです
列の型
| 列の型 | 式での型 |
|---|---|
| 整数・小数 | 数値 |
| 文字列 | 文字列 |
| 真偽値 | 真偽値 |
| 日付 | 文字列(YYYY-MM-DD) |
| 日時・タイムスタンプ | 文字列(ISO 8601) |
| NULL | null |
| 時刻・配列・構造体・JSON など | 参照できない |
条件と繰り返し
制御要素(<If>・<ElseIf>・<Else>・<For>・<Group>)は、独自の枠を持ちません。子は、親の中に直接書いたものとして並べられます。たとえば <Columns> の中の <For> は、繰り返した 1 回分が 1 列になります。<Text> の中の <For> は、繰り返した分が文の中に並びます(<Text>担当:<For as="r"><Tag>{{ r.owner }}</Tag></For></Text>)。
出し分け
html
<If condition="{{ param_6aed7dd1fdecc9316485458f == 'JP' }}">
<Text>国内の売上</Text>
</If>
<Else>
<Text>海外の売上</Text>
</Else><ElseIf>・<Else>は、<If>か<ElseIf>の直後に書きます。間に空白・改行・コメントがあってもかまいません。最初に真になったものだけが表示されます- 非表示の中身でも、クエリは実行され、閲覧者に送信されます。データを見せない目的には使えません
- 閲覧している環境で出し分けるときは
env.<名前>を使います(env.mobile・env.printなど) - 文字だけを出し分けるときは、式で書けます(
{{ row.mom > 0 ? '増加' : '減少' }})
繰り返し
<For> は、<SqlView> の結果の行ごとに子を繰り返します。<SqlView> の中にだけ書けます。
html
<SqlView id="…" page="…" sql="…">
<Columns>
<For as="r" index="i" orderBy="{{ r.sales }}" desc limit="3">
<Card title="{{ i }}位 {{ r.name }}">
<Text size="xl" weight="bold">{{ r.sales }}</Text>
</Card>
</For>
</Columns>
</SqlView>- 行は
asの名前で、何回目か(1 から)はindexの名前で参照します whereで行を選び、orderBy・descで並べ替え、limitで回数を絞ります- 直後に
<Else>を書くと、1 回も繰り返さなかったときに表示されます - 条件に合う行があるときだけ表示するには、
<For where="{{ … }}" limit="1">を使います <For>の中に<For>は書けません。グループごとに繰り返すときは、<Group>を使います(行のグループ化)- 長い一覧をページネーションで分けるときは、
<For>を<Paginator>で囲みます。1,000 行を超えるときは、<ParameterPaginator>を使います - 一覧を文字で検索して絞り込むときは、
<TextInput>で入力欄を置き、whereにsearch(view.<名前>, [列, …])を書きます - 一覧を入力した数値で絞り込むときは、
<NumberInput>で入力欄を置き、whereにview.<名前> == null || r.price >= view.<名前>のように書きます。未入力のときは NULL です - 数値の範囲で絞り込むときは、
<RangeSlider>を置き、whereにinRange(列, view.<名前>)を書きます
<List>・<Table>・<Flow> など、項目を並べる要素の中に制御要素を書くときは、制御要素の子に項目(<ListItem>・<TableRow>・<FlowStep> など)を書きます。
行のグループ化
<Group> は、結果の行を by の列の値でグループ化したデータを作り、as の変数に入れます。グループを繰り返すには、<For> の in に配列({{ p.groups }} など)を指定します。地域ごとに見出しを付けた一覧や、店舗 × 月のクロス表などに使います。
html
<SqlView id="…" page="…" sql="…">
<Group as="p" by="region">
<Columns>
<For as="g" in="{{ p.groups }}">
<Card title="{{ g.row.region }}({{ size(g.rows) }} 店舗)">
<For as="r" in="{{ g.rows }}"><Text>{{ r.store }}:{{ r.sales }}</Text></For>
</Card>
</For>
</Columns>
</Group>
</SqlView><Group as="p" by="store, month" fill="month"> は、次のデータを作ります。
js
p = {
rows: [/* すべての行 */],
// store のグループ
groups: [
{
// グループの最初の行
row: { store: "A", month: "2025-01", sales: 100 /* , ほかの列 */ },
rows: [/* A のすべての行 */],
// その中の month のグループ
groups: [
{ row: { store: "A", month: "2025-01" /* , … */ }, rows: [/* … */] },
// fill で作った空のグループ
{ row: { store: "A", month: "2025-02", sales: null /* , … */ }, rows: [] },
// …
],
},
// …
],
// fill の列の値の一覧
axes: {
month: [
{ row: { month: "2025-01" /* , … */ }, rows: [/* すべての店舗の 2025-01 の行 */] },
// …
],
},
};| 項目 | 内容 |
|---|---|
rows | グループに含まれるすべての行 |
groups | 1 段内側の列で分けたグループ。<Group> の変数では、by の最初の列で分けます。by の最後の列のグループにはありません |
row | グループの最初の行。rows[0] と同じです。fill で作った空のグループでは、グループ化した列だけに値があり、ほかの列は NULL です。<Group> の変数そのもの(p)にはありません |
axes.<列> | fill の列の値ごとに、結果全体から集めたグループ。row(その値の最初の行。ほかの列も読めます)と rows を持ちます。<Group> の変数にだけあります |
- グループは、受け取った行(1,000 行まで)から作ります
- 同じ値の行は、結果の中で離れていても 1 つのグループになります。NULL も 1 つのグループになります
- グループは集計されません。
rowの列は、最初の行の値です。合計は、sum(g.rows, 'sales')で求めます
<For> と組み合わせるときは、次のようになります。
inには、{{ <変数>.rows }}・{{ <変数>.groups }}・{{ <変数>.axes.<列> }}の形で配列を指定します。<Group>の変数のほか、グループを繰り返す<For>の変数も使えます。演算や関数は書けませんinを書いた<For>は、<For>の中にも書けます。その場合、inには、すぐ外側の<For>の変数({{ g.rows }}・{{ g.groups }})だけを指定できますwhere・orderBy・index・limitは、inの配列に適用されます
並び順
fillのない列のグループは、結果で最初に出た順で並びます。SQL の ORDER BY か、<For>のorderByで並べ替えますfillの列のグループとaxesは、値の昇順に並びます(NULL は最後)。<Group>のfillDescに列を書くと、降順になります。<For>のwhere・orderBy・desc・limitは書けません。見出しとセルの列がずれるためです- 曜日のように値の順と表示の順が違うときは、番号の列でグループ化し、表示には別の列を使います
fillの列と<For>のorderByでは、文字列は閲覧者の言語によらず、日本語の照合順で並びます。数字の部分は数の大きさで比べます(2月は10月より前)。漢字は、読みの順になるとは限りません
クロス表
fill の列は、by の前の列のどのグループの中にも、結果に出たすべての値のグループをそろえます。行のない組み合わせは、空のグループになります。見出しの行は axes で作ります。
html
<SqlView id="…" page="…" sql="…">
<Group as="p" by="store, month" fill="month">
<Table>
<TableRow header>
<TableCell><Text>店舗</Text></TableCell>
<For as="m" in="{{ p.axes.month }}">
<TableCell align="end"><Text>{{ m.row.month }}</Text></TableCell>
</For>
</TableRow>
<For as="s" in="{{ p.groups }}">
<TableRow>
<TableCell><Text>{{ s.row.store }}</Text></TableCell>
<For as="c" in="{{ s.groups }}">
<TableCell align="end">
<If condition="{{ size(c.rows) == 0 }}"><Text color="muted">-</Text></If>
<Else><Text>{{ c.row.sales }}</Text></Else>
</TableCell>
</For>
</TableRow>
</For>
</Table>
</Group>
</SqlView>- 空のグループの
rowは、グループ化した列以外が NULL です。そのため、計算すると実行時エラーになります。例のように、size(c.rows) == 0で先に分けます - 値に応じた濃さでセルを塗るとき(ヒートマップ)は、
<TableCell>のbackgroundIntensityに、値を表全体の最大値で割った値を書きます。縦持ちの結果なので、表全体の最大値はmax(p.rows, 'sales')で求められます(backgroundIntensity="{{ size(c.rows) == 0 ? null : c.row.sales / max(p.rows, 'sales') }}") fillがそろえるのは、結果に出た値だけです。どの行にもない値(データのない月)の列は作られません。必ず出したい値は、SQL で行を作りますfillの列のグループ(空のグループを含む)は、合わせて 10,000 個までです(店舗の数 × 月の数)。超えると、<Group>の中は表示されず、実行時エラーになります。SQL で列の値を減らします
表示の切り替え
閲覧者がページで変えられるものは、次の 3 つです。
- 表示の状態:見た目だけを変えます。SQL は実行しません
- パラメータ:SQL に渡され、データを変えます
- クロスフィルタ:チャートの凡例や軸の選択を、ほかのチャートや表に連動させます。SQL は実行しません
目的ごとに使う要素は、次のとおりです。
| 目的 | 要素 | 変えるもの |
|---|---|---|
| 表示する内容や見た目を切り替える | <Select>・<Switch>・<Tabs>・<Collapse> | 表示の状態 |
| 一覧を文字で検索して絞り込む(1,000 行まで) | <TextInput> と式の search() | 表示の状態 |
| 一覧を入力した数値で絞り込む(1,000 行まで) | <NumberInput>・<Slider> | 表示の状態 |
| 一覧を数値の範囲で絞り込む(1,000 行まで) | <RangeSlider> と式の inRange() | 表示の状態 |
| 一覧をページに分けて表示する(1,000 行まで) | <Paginator> | 表示の状態 |
| 文の中のリンクでタブや開閉を切り替える | <ViewStateLink> | 表示の状態 |
| 入力欄で値を選んで絞り込む | <Parameter> | パラメータ |
| 推移や内訳のチャートの上で値を選んで絞り込む | <ParameterChart> | パラメータ |
| 一覧や文の中のリンクで値を設定する(ドリルダウン、期間のプリセット) | <ParameterLink> | パラメータ |
| 1,000 行を超える一覧を、ページごとに SQL で取得する | <ParameterPaginator> | パラメータ |
| チャート同士で凡例や軸の選択を連動させる | <CrossFilter> | クロスフィルタ |
チャートで選んで絞り込む方法は、パラメータとクロスフィルタの 2 つです。ほかのチャートや表の集計も変えるときは、パラメータを使います。SQL を実行し直さずに、表示中のチャートや表の絞り込みをそろえるだけなら、クロスフィルタを使います。違いは次のとおりです。
- パラメータ
- SQL を実行し直します
- パラメータを参照しているすべての
<Chart>・<SqlResult>・<SqlView>と、式のparam_<ID>に反映されます - 選んだ値は、ページ上部のパラメータフォームにも表示されます
- クロスフィルタ
- SQL を実行しません。実行済みの結果の中で、同じキーの
<CrossFilter>を書いたチャートと表の表示を絞ります <CrossFilter>を書いていないチャート、<SqlView>、式には反映されません- 選んだ状態は閲覧者ごとに独立しており、保存されません
- SQL を実行しません。実行済みの結果の中で、同じキーの
表示の状態
<Select>・<Switch>・<TextInput>・<NumberInput>・<Slider>・<RangeSlider>・<Tabs>・<Collapse> に as で名前を付けると、ページのどこからでも view.<名前> で状態を参照できます。状態は閲覧者ごとに独立しており、保存されません。
html
<Select as="metric" variant="segmented">
<SelectOption value="sales" title="売上" default />
<SelectOption value="orders" title="注文数" />
</Select>
<If condition="{{ view.metric == 'orders' }}">
<Chart id="…" page="…" chart="…" />
</If>
<Else>
<Chart id="…" page="…" chart="…" />
</Else>| 要素 | view.<名前> の値 |
|---|---|
<Select> | 選んでいる <SelectOption> の value |
<Switch> | オンか(真偽値) |
<TextInput> | 入力した文字 |
<NumberInput>・<Slider> | 入力した数値。未入力のときは NULL |
<RangeSlider> | 選んだ範囲。下限を [0]、上限を [1] で読みます。未選択のときは NULL |
<Tabs> | 選んでいる <Tab> の value |
<Collapse> | 開いているか(真偽値) |
- 同じ
asを書いた要素は、状態を共有します(<Tabs>を切り替える<Select>など) - 状態は、マークアップページごとに持ちます。別のページで同じ名前を付けても、状態は共有されません
- PDF とスクリーンショットは、既定の状態で表示されます。
cdm notebook render pageでは、--viewで状態を指定できます - 切り替える中身が 1 か所なら、
<Tabs>だけで十分です <For>の中には<Tabs>・<Collapse>を書けます。繰り返しの 1 回ごとに状態を持ち、asは書けません。<Select>・<Switch>・<TextInput>・<NumberInput>・<Slider>・<RangeSlider>は書けませんasを書かない場合、<SqlView>の中の要素の状態は、実行し直すたびに既定の状態に戻りますasで名前を付けた状態は、<ViewStateLink>・<ParameterLink>でも設定できます。設定したあとの移動先は、scrollToに書きます(リンクの移動先)
パラメータと実行
既定では、パラメータの値を変えてもページは実行されません。次の操作をしたときに実行されます。
autoRunを書いた<Parameter>で値が確定したとき(子の<ParameterChart>で選んだときを含む)<ParameterLink>をクリックしたとき<ParameterPaginator>で一覧のページを切り替えたとき
実行されるのは、値が変わったパラメータを参照している要素です。resetIfChanged や optionsSourceSqlResetIfDependentChanged の設定でリセットされたパラメータを参照している要素も、実行されます。ほかのパラメータに、まだ実行に反映していない変更があるときは、ページ全体が実行されます。
選ばれなかった <If> の分岐の要素も、値が変わったパラメータを参照していれば実行されます。そのため、パラメータが未設定のときにもエラーにならないように SQL を書きます。
一覧やチャートから選んだ値で詳しい表示に切り替えるページ(ドリルダウン)は、<ParameterLink> や <ParameterChart> でパラメータを設定し、その値で <If> を書き分けて作ります。作り方は、<ParameterLink> を参照してください。
クロスフィルタ
<Chart>・<SqlResult> の中に <CrossFilter> を書くと、グリッドページと同じく、凡例や軸の選択を連動させられます。<ParameterChart> と <SqlView> の中には書けません。キーごとの同期の内容は、クロスフィルタを参照してください。
大きさと並べ方
<Columns>は横、<Rows>は縦、<Grid>は格子に子を並べます。そのほかの要素の中では、子は縦に並びます- 幅は親で決まります。
<Columns>の子はgrowの比で幅を分け、grow="0"の子は中身の幅になります - 高さは
height="320px"のように px で書きます。指定しない場合は、中身に合わせて決まります(<Chart>・<SqlResult>は 360px) <Columns>の子の高さは、既定では最も高い子にそろいます- タブの切り替えや開閉で高さが変わります。高さを固定するときは
heightを書きます - モバイル表示では、
<Columns>・<Grid>の子は縦一列に並びます。表示を変えるときはenv.mobileで出し分けます
エラーの種類
マークアップページのエラーには、構文エラー・スキーマエラー・実行時エラーの 3 種類があります。
| 種類 | 内容 | cdm notebook validate | cdm notebook run |
|---|---|---|---|
| 構文エラー | コードだけで分かる誤り | 検出される | SQL を実行する前に失敗する |
| スキーマエラー | SQL の実行結果のスキーマ(列の名前と型)に合わないコード | 検出されない | ステータスが ERROR になる |
| 実行時エラー | SQL の実行結果やパラメータの値を当てはめて描画するときに、値を求められない式 | 検出されない | ステータスが WARNING になる |
構文エラー
構文エラーは、コードだけで分かる誤りです。書き方の誤りのほか、値の型や参照先の誤りも含みます。
- 書き方の誤り:閉じていないタグ、存在しない要素や属性、指定されていない必須の属性、書けない場所にある要素、重複した ID、構文に誤りのある式など
- 値の型や参照先の誤り:属性に書けない値、型の合わない比較や計算、存在しないパラメータ・ページ・SQL ブロックへの参照など
選ばれなかった分岐や <For> の中も含めて、ページのすべてのコードが検査されます。構文エラーが 1 つでもあると、cdm notebook push・cdm notebook run などは失敗します。
スキーマエラー
スキーマエラーは、SQL の実行結果の列の名前や型によって決まる誤りです。実行結果にない列の参照のほか、列の型に合わない比較や計算、配列など参照できない型の列の参照も含みます。
- 構文エラーと同じく、ページのすべてのコードが検査されます
- スキーマは SQL を実行するまで確定しないため、
cdm notebook validateでは検出されません。cdm notebook runでは、ステータスがERRORになります
実行時エラー
実行時エラーは、SQL の実行結果やパラメータの値を当てはめて描画するときに、値を求められない式があると発生します。たとえば、次のような式が該当します。
nullとの大小比較(row.x > 0で、xが NULL の場合)- 0 による除算
- SQL の実行結果が 0 行のときの
rowの参照(rowは 1 行目を表すため) <Group>のfillの列のグループが、上限(10,000 個)を超えるとき- SQL の実行結果が 1,000 行を超えるときの
sum()・avg()・min()・max()
実行時エラーが発生するかどうかは、データによって異なります。そのため、cdm notebook run では、<SqlView> の中の式の実行時エラーは、ERROR ではなく WARNING になります。
- 計算されるのは、描画される部分の式だけです。選ばれなかった
<If>・<ElseIf>・<Else>の中や、1 回も繰り返さない<For>の中の式は計算されませんcdm notebook runでWARNINGにならなくても、データの変化によって別の部分が描画されると、その部分の式は実行時エラーになる場合があります
- 実行時エラーになった式の値は、条件では偽、差し込みでは空、色などの属性では既定値として扱われます
- NULL になりうる列を比較するときは、先に
nullかどうかを判定します(row.x != null && row.x > 0)。NULL の代わりの値を決めるときは、coalesce()を使います(coalesce(row.x, 0) > 0)