ナビゲーション付きでトピックを開く

式に関する注意事項

値

すべての式で、いくつかの種類の値が使用されます。これらの値は、式に追加して式の一部として使用するか、または「Expression」プロセッサの入力である属性（1つまたは複数）から読み取ることができます。

式の値は、文字列、数値、文字列または数値の配列です。数値はIEEE倍精度形式で格納され、最大値は約1.8 x 10308です。式で日付値が使用される場合、これらの値は同等のJavaタイムスタンプ（1970年1月1日00:00からのミリ秒数）で表されます。

式

式は、演算子で結合された各項目で構成されます。サポートされている項目は次のとおりです。詳細はその項目をクリックしてください。

• 数値

  数値は、単純な整数として表すか、またはより複雑な数値は、浮動小数点システムを使用して、オプションの指数を付けて記述できます。

  例:

  1000

  2.1212

  0.1

  1.2321e-20

  1e10

• Null

  特別な名称であるnullは、未定義の値を表します。

• 文字列定数

  文字列定数は、'または"引用符で囲まれます。Java形式の円記号（\）エスケープは、次のように、特殊文字用に文字列内で使用できます。

  エスケープ	意味
  \nまたは\nnまたは\nnn	8進コードN付きの文字
  \n	行送り（コード10）
  \r	改行（コード13）
  \a	ベル文字（コード7）
  \t	タブ（コード9）
  \b	バックスペース（コード8）
  \f	改ページ（コード12）
  \v	垂直タブ（コード11）

  例:

  "the cat slept on the mat"

  "this is a line feed: \n"

  'this is also a string'

• 属性名

  式で使用される名称には、文字、数字、$、_または.が含まれる必要があり、数字で始まらない必要があります。他の文字を含む名称を使用する必要がある場合は、特殊構文@'名称'または@"名称"を使用して式に入力できます。たとえば、名称にスペースが含まれている場合は、次のように入力する必要があります。

  @"スペースを含む名称"

• 配列値

  配列値は、中カッコ{ }で囲まれた値リストとして入力できます。

  例:

  {1, 2, 3}

  {a+2, b-5}

• 配列選択

  配列要素は、大カッコ[ ]の添え字式を使用して選択できます。最初の要素は添え字1です。配列スライスを使用してサブ配列を選択でき、この場合のスライスはコロンで示されます（[lwb:upb]）。

  例:

  arr[1]

  arr[x+1]

  z[2:3+m]

  {1,2,3}[2]

次の演算子を優先度の降順に使用できます。

比較演算子は、比較が成功した場合は1、成功しなかった場合は0になります。

優先度の高い演算子は、優先度の低い演算子より強く結合されます。次に例を示します。

a = b + c * d ^ e

これは次と同じです。

a = (b + (c * (d ^ e)))

関数

次の関数が式言語でサポートされています。

式のコンテキスト

式は、EDQ内の様々なコンテキストで使用されます。各コンテキストで異なるセットの名称が使用可能です。次に、抜粋したコンテキストをいくつか示します。

1. 「Expression」および「Expression Filter」プロセッサ

式で使用される各名称は、プロセッサに対する入力として選択した属性とマッチする必要があります。マッチ処理では大/小文字が区別されます。属性名に接尾辞（つまり、属性名のピリオドの後の部分）が含まれている場合、接尾辞は無視されます。  

属性名が、たとえばスペースが含まれているために有効な式名ではない場合は、@"名称"構文を使用して入力する必要があります。たとえば、属性がaddress line 1 (street)の場合は、次のように入力する必要があります。

@"address line 1 (street)"

2. カリキュレータ・プロセッサ

多数の標準プロセッサがcom.datanomic.director.runtime.widgets.common.Calculatorクラスを使用して実装されます。これは、プロセッサ・パラメータから（XMLから）式を取得し、入力属性を使用してその式を評価します。

式パラメータをプロセッサの各出力に対して定義する必要があります。IDがNの出力のパラメータ名はexpr.Nです。出力が1つのみの場合は、より簡単な名称であるexprをかわりに使用できます。

式内で、入力属性はiNで表され、このNはXMLからの入力IDです。入力を複数の属性と関連付けることができる場合、その名称は集計コンテキストのみで使用できます。

出力はID順に評価され、初期の出力はoNで表され、このNはXMLからの出力IDです。

さらに、出力式の1箇所以外で使用できる値を格納するために作業式を定義できます。これらの作業式は、すべての出力式より前に評価されます。作業式のパラメータ名は、expr.t1、expr.t2などです。

プロセッサのオプションも、オプションの名称を使用するのみでカリキュレータ式で使用できます。

例

• 「Upper Case」プロセッサの式は、次のように定義されます。

        <parameters>

          <parameter name="expr">upper(i1)</parameter>

        </parameters>

• 「Concatenate」プロセッサの式は、次のように定義されます。

        <parameters>

          <parameter name="expr">concat2(separator, i1)</parameter>

        </parameters>

「separator」プロパティの使用方法に注意してください。

• 「Trim Characters」プロセッサの式は、次のように定義されます。

        <parameters>

          <parameter name="expr.o1">side == 'l' ? trimleft(i1, start, length) : trimright(i1, start, length)</parameter>

        </parameters>

• 「Select Array Element」プロセッサの式は、次のように定義されます。

        <parameters>

          <parameter name="expr.t1">fromend ?(length(i1) - index) + 1 : index</parameter>

          <parameter name="expr.o1">i1[t1]</parameter>

        </parameters>

• 「Regex Replace」プロセッサの式は、次のように定義されます。

       <parameters>

         <parameter name="expr.o1">regexreplace(i1, regex, replace)</parameter>

         <parameter name="expr.o2">o1 != i1 ?'Y' : 'N'</parameter>

       </parameters>

この場合、最初の式で置換が実行され、2番目の式で「success」フラグが計算されます。

拡張機能

条件式

条件式は次の構文を使用して指定できます。

a ? b : c

結果は、aがtrueの場合はb、それ以外の場合はcです。

イテレータ式

イテレータ式は、SumまたはConcatenateなどの集計関数で使用するための特別な機能です。  

構文は次のとおりです。

{a : expr}

ここで、aは配列または複数属性の名称（任意の数の実際の属性が割り当てられている1つの入力属性）であり、exprはaを含む式です。式は名称内の後続の各値で置換されたaを使用して評価され、結果は集計関数に提供されます。  

これを説明する最良の方法として、例をいくつか示します。

例1

sum({ a : a ^ 2 })

これは、a内のすべての要素の二乗を合計します。

例2

sum( { a :  a < 0 ? 1 : 0 })

これは、a内の負であるすべての要素をカウントします。

例3

sum({ i1 : nodatacheck(i1) = '-'}) > 0 ?'Y' : 'N'

移入されたi1（入力属性1）の要素をカウントし、データが含まれている場合はY、すべてが非データの場合はNになります。