式の仕様

式を利用することで、帳票に与えられたデータの取得や集計などを行うことができます。

FIELDというデータ列から値を取得するには、以下のように書きます。 先頭にドットを付ける必要があることに注意してください。

  .FIELD

FIELD列の集計値を得るには以下のように書きます。

  sum.FIELD

sumはグループ全体の集計値を得ます。

グループの途中で集計行を出力する場合で、 その時点までに出力された明細の集計値を得るには以下のように書きます。

  sum_at.FIELD

同じページに含まれる範囲での集計を行うには、以下のように書きます。

  sum_page.FIELD

集計は、現在所属しているグループの範囲で行われます。 1つ上のグループの範囲で集計を行う必要があれば、以下のように最後に@を付けます。

  sum.FIELD@

集計範囲を指定するには以下のように書きます。 scope_idは集計範囲としたいグループまたはレポートの識別子です。

  sum.FIELD@scope_id

重複したデータを除いて集計を行うには以下のように書きます。 自身の1つ下のレベルにある明細グループの単位で集計されます。

  sum.FIELD#

指定したグループの単位で重複を除いた集計を行いたい場合は次のように書きます。 unit_idは集計単位としたいグループの識別子です。

  sum.FIELD#unit_id

@指定と#指定を同時に行う場合は、@を先に書いてください。

  sum.FIELD@scope_id#
  sum.FIELD@scope_id#unit_id

sum_at/sum_pageには#指定を行うことはできません。

メソッド

式内で動的な値を記述するには、以下の形式に従います。

  [メソッド][.パラメータ][@集計範囲][#集計単位]

例えば、式"sum.FIELD"では、"sum"がメソッドで、パラメータは"FIELD"になります。 メソッドにはいくつかの種類があり、それぞれ固有の機能を持っています。

例えばpage_countというメソッドを用いるとページ数を得ることができます。 現在のページ数を得る場合はパラメータを必要としないので、 ドット以降の部分を省略します。

  page_count

page_countにtotalというパラメータを与えると、 レポート全体のページ数を得ることができます。

  page_count.total

式を書くことのできる場所は、以下の3つに分類することができます。

この分類ごとに、利用可能なメソッドは異なります。 例えばpage_countはページ分割がなされた後でのみ利用可能なので、 要素内の式では呼ぶことができますが、カスタム列からは呼ぶことができません。

デフォルトで用意されているメソッドおよび、それらがいつ利用可能かの一覧を以下に示します。

リテラル定数

以下のリテラル定数を式内に書くことができます。

文字列内では、以下のエスケープ文字が利用可能です。

オペレータ

カッコで囲んだ式はオペレータの実行として評価されます。 この形式を用いることで値の計算や条件分岐などを行うことができます。

  (+ 1 1)               => 2
  (* 2 (- 3 1))         => 4
  (if .FLAG 'OK' 'NG')  => FLAG列の値がtrueなら'OK'、falseなら'NG'
  (round5 .NUM -1)      => NUM列の値を小数点以下1位で四捨五入

カッコ内の最初の要素がオペレータで、それ以降は引数です。 引数には式をネストして書くことができます。 一般形式を以下に示します。

  (オペレータ 引数1 引数2 引数3...)

以下のオペレータが用意されています。

丸め処理の例を以下に示します。

  (round5 5.4)     => 5
  (round5 5.5)     => 6
  (round5 0.05 -1) => 0.1
  (round5 15 1)    => 20
  (round5e 1.5)    => 2
  (round5e 2.5)    => 2
  (round6 0.5)     => 0
  (round6 0.6)     => 1
  (rounddown  0.9) => 0
  (roundup 0.1)    => 1
  (roundup 0.01)   => 0
  (roundup2 0.1)   => 1
  (roundup2 0.01)  => 1

丸め処理は絶対値に基づいて行われます。

  (round5 -1.4)    => -1
  (round5 -1.5)    => -2
  (rounddown -1.1) => -1
  (roundup -1.1)   => -2

nvlオペレータを利用することで複数の条件分岐を以下のように書くことができます。

  (nvl (if (= .ANIMAL 'dog') 'イヌ') (if (= .ANIMAL 'cat') 'ネコ') 'その他')