Soracom

[アクションの実行条件] や一部の入力欄では、Flux アプリの中を流れるデータを参照したり、演算したりできます。

[アクションの実行条件] の入力例

[アクションの実行条件] では、入力された式が評価され、その結果が true であればアクションが実行されます。

入力例 (1-1)

チャネルに送信された MESSAGE が {"temperature": 42} で、かつ Flux アプリの現在時刻が 2024-07-17T00:00:00Z を過ぎている場合に、true と評価されます。

(payload.temperature - 2.12) >= 32.8 && now() >= datetimeFromISOString("2024-07-17T00:00:00Z")

入力例 (1-2)

イベントソースから送信された MESSAGE が {"clickTypeName": "SINGLE"}、またはチャネルに送信された CONTEXT に {"protocol": "http"} が含まれる場合に、true と評価されます。

startsWith(toUpperCase(event.payload.clickTypeName), "SINGLE") || context.protocol == "http"

そのほかの入力欄での入力例

[アクションの実行条件] 以外の入力欄では、${ と } で囲む形式で入力します (例: ${event.payload.presignedUrls.get})。入力した式は、文字列に置き換えられます。

入力例 (2-1)

イベントソースから送信された MESSAGE の {"presignedUrls": {"get": "xxxxxx"}} の xxxxxx を取得します。

<${event.payload.presignedUrls.get}|画像>

入力例 (2-2)

現在のチャネルに送信された MESSAGE (前のチャネルの出力データ) の {"output": {"people": 1, "people_with_blue_shirts": 0}} の 1 と 0 を取得します。

人が ${payload.output.people} 人います。そのうち、青いシャツの人が ${payload.output.people_with_blue_shirts} 人います！！

入力例 (2-3)

現在のチャネルに送信された MESSAGE (前のチャネルの出力データ) の {"weather": ["sunny", "cloudy", "rain"]} から weather の配列の要素の数を取得します。

${len(payload.weather)}

入力できる変数、演算子、関数について

変数

Flux アプリのアクションでは、Flux アプリの中を流れるデータを参照できます。たとえば、${payload} のように書くと、チャネルに送信された MESSAGE を参照できます。また、MESSAGE が JSON オブジェクトの場合は、${payload.xxxxx} のように書くと、JSON オブジェクトのプロパティ xxxxx の値を参照できます。

利用できる変数は以下のとおりです。

演算子

${payload.temp * 100} のように書くと、payload.temp と 100 の積 (payload.temp を 100 倍した値) を利用できます。

関数

値の評価

データ変換

時間処理

例:

${datetime("2025-02-05T00:00:00Z")} // 日付を表す文字列の例
${getUTCYear(1738713600000)} // UNIX 時間 (ミリ秒) の例

数学関数