ver.2サポートサイト

条件式や計算式の記法

演算子や関数を直接記述することで、レコードの検索条件を指定したり、フィールドの格納値を自動で生成することができます。

以下の機能では、条件式を記述することでレコードの検索条件を指定できます。

・APIのクエリパラメータwhere

・アプリ利用画面およびアプリ管理画面の高度な条件設定

・アプリ管理画面のDBトリガレコードアクションの発動条件

以下の機能では、フィールドへ格納する値を自動生成することができます。

・アプリ管理画面のDBトリガレコードアクションの処理マッピング

参照フィールドの指定方法、ユーザフィールドの指定方法、ログインフィルタにおけるフィールド値関係抽出の指定方法 については各見出しをご参照ください。

フィールドの識別子またはフィールドタイプの書式

フィールドの識別子やフィールドタイプの値を式に使用する場合、それぞれ以下の表に従って記載する必要があります。

※一部のフィールドタイプはSPIRAL ver.2の独自関数を使用し、値をフィールドタイプの形式に変換する必要があります。

演算子の書式

演算子は以下を指定できます。

条件式の優先順位

１．括弧

複数の演算子を組み合わせる条件式の場合、括弧で括られた条件が優先して扱われます。
括弧がない場合は、演算子間の優先順位に従います。

２．演算子間の優先順位

演算子の優先順位は以下となります。優先順位が同列の場合は左側に記述された条件から処理されます。

（例）【営業部か開発部で、30歳以上】のレコードを検索する場合

【○】正しい条件式
(@department = 'sales' OR @department = 'development') AND @age >= 30
　※ 括弧が優先され、【[営業部か開発部]で30歳以上】を検索します

【✕】誤った条件式
　@department = 'sales' OR @department = 'development' AND @age >= 30
　※ 演算子の優先順位に従い、ORよりもANDが優先され、【営業部か[開発部で30歳以上]】を検索します。

高度な条件設定の条件式の上限

アプリ利用画面およびアプリ管理画面の高度な条件設定には、条件式の長さに制限があります。

アプリ利用画面のレコード詳細検索は3000bytesまで、その他の機能では4096bytesまでが上限です。

SPIRAL ver.2の独自関数

以下の関数を使用することで、細かな条件でレコード抽出を行うことができます。

RANDOM関数の除外文字の指定方法

　・第2引数に[]で除外文字を記述します（1文字だけでも[]でくくる必要があります）
　・複数ある場合、カンマ区切りで指定します。
　・下記の3種類のみ、まとめて指定可能です。
　　　A-Z（大文字アルファベット）
　　　a-z （小文字アルファベット）
　　　0-9（数字）
　・[B-D],[1-9]のような指定はできません。

　・「,（カンマ）」を除外する場合、エスケープ文字「\\」と共に記述します。

　　　例）[A-Z,1,\\,,@]

関数を使ったレコード検索例

日時が現在よりも前のレコードを検索
@dateTime < NOW()

公開開始日が今日以前を検索
@date <= DATE(NOW())

公開終了日が今日以降を検索
@enddate >= DATE(NOW())

文字数が100字以上のレコードを検索
LENGTH(@text) >= 100

日付が2014年5月1日のレコードを検索
@date = DATE('2014-05-01')

月日が5月1日のレコードを検索
@monthDay = MONTH_DAY('05-01')

月が四月のレコードを検索
MONTH(@date) = 4

予約日がイベントの3日以上前のものを検索
@reserveDate <= @eventDate - INTERVAL('3 days')

セミナー開催日が今日から1ヶ月以上前を検索
@date <= DATE(NOW()) - INTERVAL('1 month')

セミナー開催日が今日から1ヶ月前以降を検索
@date >= DATE(NOW()) - INTERVAL('1 month')

誕生日の月日が今日の月日から30日前以降を検索
@birthday >= DATE(NOW()) - INTERVAL('30 days')

誕生日の月日が今日の月日から30日後以前を検索
@birthday <= DATE(NOW()) + INTERVAL('30 days')

誕生日の月日が、今日から1ヶ月前以降、かつ、誕生日の月日が、今日から1ヶ月後以前を検索
@birthday >= DATE(NOW()) - INTERVAL('1 month') AND @birthday <= DATE(NOW()) + INTERVAL('1 month')

誕生日の月が今日の月と同じものを検索
MONTH(@birthday) = MONTH(NOW())

最終更新日時が今日から過去7日間のものを検索
@_updatedAt >= DATE(NOW()) - INTERVAL('7 days') AND @_updatedAt <= DATE(NOW())

整数値が100のレコードを検索
@integer = INTEGER('100')
この関数を使わなくても同様の検索はできます。：@integer = 100

電話番号が080-1111-1111のものを検索
@phone = PHONE('080-1111-1111')

関数を使った処理マッピング例

複数参照の参照フィールドのマッピングをする為の配列に変換
MULTI_REF_ARRAY(1,2,3)

接頭語「MA」と、レコードIDを元にゼロで左埋めした10桁の値を文字列連結した値を生成
'MA' || LPAD(@master._id,10,'0')

使用する数字範囲を指定して、数字のみでランダム値を生成
RANDOM_RANGE(1,10)

桁数を指定して、数字のみでランダム値を生成
RANDOM_NUM(18)

桁数を指定して、アルファベットのみでランダム値を生成
RANDOM_ALP(6)

桁数を指定して、数字とアルファベットでランダム値を生成
RANDOM_NUM_ALP(16)

桁数を指定して、数字とアルファベットと記号でランダム値を生成
RANDOM_NUM_ALP_SYM(16)

参照フィールドの指定方法

参照フィールドを条件式に使用する場合、それぞれ以下の内容に従って記載する必要があります。

参照フィールドを使った検索例

1レコード参照で、指定した参照先レコードと等しい
@reference = '1'
複数レコード参照で、指定した参照先レコードのいずれかを含む
@reference ANYCONTAINS('2','3')
※{@参照フィールド識別名}の形式で参照フィールドの参照先レコードに対して条件を指定できます。

参照先DB内のセレクトフィールドのラベル値のいずれかを含む
@reference.select ANYCONTAINS('1','2','3')
※{@参照フィールド識別名.参照先DBフィールド識別名}の形式で参照先DB内に含まれるフィールド値に対して条件を指定できます。
  使用できる条件は、参照先DB内に含まれるフィールドのフィールドタイプによって変わります。

ユーザフィールドの指定方法

高度な条件設定における指定方法

ユーザフィールドを条件式に使用する場合、以下の内容に従って記載する必要があります。

※ユーザフィールドの条件式は アプリ利用画面＞詳細検索＞高度な条件設定 で指定できます。

ユーザフィールドの識別名

ユーザフィールドの関数

※既存の関数も型に合わせて使用できます。

ユーザフィールドを使った検索例

ユーザIDが「111」と「222」を抽出
@fieldName ANYCONTAINS ('111', '222')

自分自身を抽出
IS_ME(@fieldName) = true

メインメールアドレスのドメインが「spiral-platform.com」と「sample.example.com」を抽出
@fieldName.email LIKE '%spiral-platform.com' OR @fieldName.email LIKE '%@sample.example.com'

有効ユーザを抽出
@fieldName.enabled = true

APIにおける指定方法

APIでユーザフィールドを使用する場合、以下の内容に従って記載する必要があります。

レコードを登録、変更API の入出力形式はフィールドタイプリファレンスを参照ください。

レコード取得APIのwhereパラメータで使用可能な演算子

※「いずれかに等しい」「いずれも等しくない」の演算子を使用している場合は30ユーザまで指定できます。
※表に記載されていない演算子を指定した場合、400エラーを返します。

レコード一覧取得API（1.1）のwhereパラメータでanycontains演算子を使用する場合の例

v1/apps/{app}/dbs/{db}/records?where=@fieldName ANYCONTAINS('1','2','3',...'29','30')

ログインフィルタにおけるフィールド値関係抽出の指定方法

高度な条件設定における指定方法

ログインフィルタのフィールド値関係抽出で高度な条件設定を使用して認証エリアDBフィールドを指定する場合、以下の形式で指定してください。
※ ログインフィルタで使用可能なフィールドタイプなどの詳細は レコード公開範囲 をご参照ください。

AUTH_RECORD('fieldName')

レコードリストを作成した申請DBと認証エリアを作成した社員DBにおいて、等級フィールド（class）と所属フラグフィールド（member）がそれぞれ一致している、

または担当者フィールド(representative)が一致しているレコードを検索する場合の例

( @class = AUTH_RECORD('class') AND @member = AUTH_RECORD('member') ) OR @representative = AUTH_RECORD('representative')