サポートされているマッピング関数
ADD
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
ADD |
指定された数値を既存の数値に追加します。 | ADD(value) |
追加する数値。 | 2 つの数値の和。 |
例: 2 つの整数値を合計する
サンプルデータ: $var1$ = 15
使用方法: $var1$.ADD(5)
出力: 20
AND
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
AND |
指定されたブール値の論理 AND 演算を行います。 | AND(value) |
ブール値。 | ブール値。 |
例: ブール式の AND 値を求める
サンプルデータ: $var1$ = TRUE
使用方法: $var1$.AND(TRUE)
出力: TRUE
APPEND_ALL
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
APPEND_ALL |
指定された値をすべて配列に追加します。 | APPEND_ALL(value1, value2, ...) |
追加する値。 追加する値のデータ型は配列のデータ型と一致する必要があります。たとえば |
追加された値を含む配列。 |
例 1: 整数配列に値を追加する
サンプルデータ: $var1$ = {3,6,8,1}
使用方法: $var1$.APPEND_ALL(7,9,15)
出力: {3,6,8,1,7,9,15}
例 2: ブール値配列に値を追加する
サンプルデータ: $var1$ = {True,False,True}
使用方法: $var1$.APPEND_ALL(False,True)
False
と True
を var1 に追加します。出力: {True,False,True,False,True}
例 3: 文字列配列に値を追加する
サンプルデータ: $var1$ = {"Hello","Apigee"}
使用方法: $var1$.APPEND_ALL("Integrations","Test")
Integrations
と Test
という単語を var1 に追加します。出力: {"Hello","Apigee","Integrations","Test"}
APPEND_ELEMENT
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
APPEND_ELEMENT |
JSON 配列に要素を 1 つ追加します。 | APPEND_ELEMENT(value) |
追加する値。 | 追加された要素を含む JSON 配列。 |
例: JSON 配列に要素を 1 つ追加する
サンプルデータ: $var1$ = ["first", "second", "third", "fourth"]
使用方法: $var1$.APPEND_ELEMENT("fifth")
fifth
を var1
に追加します。出力: ["first", "second", "third", "fourth", "fifth"]
APPEND
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
APPEND |
指定された値を配列に追加します。 | APPEND(value) |
追加する値。 追加する値のデータ型は配列のデータ型と一致する必要があります。たとえば |
追加された値を含む配列。 |
例 1: 整数配列に値を追加する
サンプルデータ: $var1$ = {3,6,8,1}
使用方法: $var1$.APPEND(7)
出力: {3,6,8,1,7}
例 2: ブール値配列に値を追加する
サンプルデータ: $var1$ = {True,False,True}
使用方法: $var1$.APPEND(True)
出力: {True,False,True,True}
例 3: 文字列配列に値を 1 つ追加する
サンプルデータ: $var1$ = {"Hello","Apigee"}
使用方法: $var1$.APPEND("Integrations")
Integrations
という単語を var1 に追加します。出力: {"Hello","Apigee","Integrations"}
AVG
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
AVG |
配列内のすべての値の平均値を計算します。 | AVG() |
なし | 配列内のすべての値の平均。戻り値の型は Double です。 |
例 1: 整数配列内のすべての値の平均値を計算する
サンプルデータ: $var1$ = {2,4,9,3}
使用方法: $var1$.AVG()
出力: 4.5
例 2: double 配列に含まれるすべての値の平均値を計算する
サンプルデータ: $var1$ = {2.0,6.1,3.9}
使用方法: $var1$.AVG()
出力: 4.0
CEIL
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
CEIL |
指定された入力以上の最小の整数を計算します。 | CEIL() |
なし | 整数。 |
例: 数値の上限を確認する
サンプルデータ: $var1$ = {3.4}
使用方法: $var1$.CEIL()
出力: 4
CONCAT
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
CONCAT |
指定された文字を既存の文字列に連結します。 | CONCAT(value) |
連結する文字の文字列。 | 連結後の文字列。 |
例: 1 つの文字列を既存の文字列に連結する
サンプルデータ: $var1$ = "HelloApigee"
使用方法: $var1$.CONCAT("Integrations")
Integrations
を var1 に連結します。出力: HelloApigeeIntegrations
CONTAINS
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
CONTAINS |
指定した文字列または文字列配列内での指定した値の出現数を確認します。 | CONTAINS(value) |
検索する値。 | ブール値。一致が見つかった場合は TRUE を返し、見つからなかった場合は FALSE を返します。 |
例: 文字列内で連続する文字の有無を確認する
サンプルデータ: $var1$ = "Hello Apigee Integrations"
使用方法: $var1$.CONTAINS("xyz")
xyz
の有無を確認します。出力: FALSE
DECODE_BASE64_STRING
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
DECODE_BASE64_STRING |
base64 文字列を UTF-8 文字セットにデコードします。 | DECODE_BASE64_STRING() |
なし | デコードされた UTF-8 文字列。 |
例: base64 文字列をデコードする
サンプルデータ: $var1$ = "SGVsbG8gSW50ZWdyYXRpb24h"
使用方法: $var1$.DECODE_BASE64_STRING()
出力: Hello Integration!
DIVIDE
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
DIVIDE |
既存の数値を指定された数値で除算します。 | DIVIDE(value) |
割る数値(除数) | 除算の商。 |
例: 整数を別の整数で除算する
サンプルデータ: $var1$ = 16
使用方法: $var1$.DIVIDE(3)
出力: 5
EQUALS
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
EQUALS |
指定した値と既存の値を比較します。 | EQUALS(value) |
比較する値。 | ブール値。指定された値が既存の値と一致する場合は TRUE を返し、一致しない場合は FALSE を返します。 |
例 1: 2 つの文字列を比較する
サンプルデータ: $var1$ = "Apigee Integrations"
使用方法: $var1$.EQUALS("Apigee Integrations")
出力: TRUE
例 2: 2 つの整数を比較する
サンプルデータ: $var1$ = 34
使用方法: $var1$.EQUALS(23)
出力: FALSE
EQUALS_IGNORE_CASE
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
EQUALS_IGNORE_CASE |
指定した値と既存の値を比較します。 | EQUALS_IGNORE_CASE(value) |
比較する値。 | ブール値。指定された値が既存の値と一致する場合は TRUE、一致しない場合は FALSE を返します(大文字と小文字は区別しません)。 |
例: 2 つの文字列を比較する
サンプルデータ: $var1$ = "Apigee Integrations"
使用方法: $var1$.EQUALS_IGNORE_CASE("apigee integrations")
apigee integrations
と等しいかどうかを確認します。出力: TRUE
EPOCH_TO_HUMAN_READABLE_TIME
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
EPOCH_TO_HUMAN_READABLE_TIME |
Unix エポック時間(ミリ秒)を人が読める形式の時間形式に変換します。 | EPOCH_TO_HUMAN_READABLE_TIME (value, value) |
この関数には、以下の引数が渡されます。
|
人が読める形式に変換されたタイムスタンプ。 |
例: Unix エポック時間(ミリ秒)を人が読める形式に変換する
サンプルデータ: $var1$ = 1667494335011
使用方法 1: $var1$.EPOCH_TO_HUMAN_READABLE_TIME("EEE, d MMM yyyy HH:mm:ss z","UTC")
var1 を UTC タイムゾーンの EEE, d MMM yyyy HH:mm:ss z)形式で人が読めるタイムスタンプに変換します。
出力: Thu, 3 Nov 2022 16:52:15 UTC
使用方法 2: $var1$.EPOCH_TO_HUMAN_READABLE_TIME("EEE, yy-MM-dd HH:mm:ss,SSS","GMT")
var1 を GMT タイムゾーンの EEE, yy-MM-dd HH:mm:ss,SSS 形式で人が読めるタイムスタンプに変換します。
出力: Thu, 22-11-03 16:52:15,011
使用方法 3: $var1$.EPOCH_TO_HUMAN_READABLE_TIME("EEE, yy-MM-dd HH:mm:ss,SSS ZZZZ","America/Los_Angeles")
var1 を米国 / ロサンゼルス タイムゾーンの EEE, yy-MM-dd HH:mm:ss,SSS ZZZZ 形式で人が読めるタイムスタンプに変換します。
出力: Thu, 22-11-03 09:52:15,011 GMT-07:00
EXPONENT
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
EXPONENT |
既存の数のべき乗を計算します。 | EXPONENT(value) |
指数値。 | 指定した指数でべき乗した数値。 |
例: 整数値を 3 でべき乗した値を求める
サンプルデータ: $var1$ = 5
使用方法: $var1$.EXPONENT(3)
出力: 125
FILTER
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
FILTER |
指定したフィルタ条件を満たす配列要素を除外します。 フィルタ条件は、TRUE または FALSE に評価される必要があります。 フィルタ条件には、現在の配列イテレーション要素に適用される 1 つ以上の変換関数が含まれます。 |
FILTER(~objn -> Variable or Value)
ここで、~objn は、変換関数を適用する現在の配列要素を示します。デフォルトでは、n の値は 1 から始まります。
スキーマのある JSON 配列の場合、現在の配列要素の後にドット(.)表記を使用して、その配列要素のネストされたプロパティに直接アクセスできます。例: | TRUE または FALSE に評価されるフィルタ条件。 | フィルタ条件に一致する要素の配列。 |
例 1: 文字列配列をフィルタする
サンプルデータ:
$var1$ = {
"sara@example.com",
"bola@example.com",
"222larabrown@gmail.com",
"dana@examplepetstore.com",
"cloudysanfrancisco@gmail.com"}
使用方法: $var1$.FILTER(~obj1-> ~obj1.CONTAINS("@gmail.com"))
var1 で @gmail.com を含む文字列要素をフィルタします。
出力:
{"222larabrown@gmail.com","cloudysanfrancisco@gmail.com"}
例 2: JSON 配列をフィルタする
サンプルデータ:
$var1$ = { "citynames": [ { "city": "Abbeville", "state": "Louisiana" }, { "city": "Aberdeen", "state": "Maryland" }, { "city": "Benicia", "state": "California" }, { "city": "Chehalis", "state": "Washington" }, { "city": "Aberdeen", "state": "Washington" }, { "city": "Aberdeen", "state": "Mississippi" }, { "city": "Cheektowaga", "state": "New York" } ] }
使用方法:
var1.citynames .FILTER(~obj1-> ~obj1 .GET_PROPERTY("city") .EQUALS("Aberdeen") )
var1 に都市が Aberdeen が含まれている要素をフィルタします。
出力:
[{ "city": "Aberdeen", "state": "Maryland" }, { "city": "Aberdeen", "state": "Washington" }, { "city": "Aberdeen", "state": "Mississippi" }]
例 3: ネストされた JSON 配列をフィルタする
サンプルデータ:
$var1$ = { "products": [ { "PA": "Integrations", "users": [ { "name": "Ariel", "role": [ "editor", "approver" ] }, { "name": "Dana", "role": [ "admin", "deployer" ] }, { "name": "Lee", "role": [ "viewer" ] } ] }, { "PA": "Apigee", "users": [ { "name": "Mahan", "role": [ "editor", "admin", "deployer" ] }, { "name": "Quinn", "role": [ "invoker" ] } ] }, { "PA": "Connectors", "users": [ { "name": "Kiran", "role": [ "invoker", "admin", "deployer" ] }, { "name": "Sasha", "role": [ "admin" ] } ] } ] }
使用方法:
var1.products .FOR_EACH(~obj1 -> ~obj1 .SET_PROPERTY( ~obj1 .GET_PROPERTY("users") .FILTER(~obj2 -> ~obj2 .GET_PROPERTY("role") .TO_STRING() .CONTAINS("admin") ) , "users" ) )
var1 の users に admin が含まれている要素をフィルタします。
出力:
[{ "PA": "Integrations", "users": [{ "name": "Dana", "role": ["admin", "deployer"] }] }, { "PA": "Apigee", "users": [{ "name": "Mahan", "role": ["editor", "admin", "deployer"] }] }, { "PA": "Connectors", "users": [{ "name": "Kiran", "role": ["invoker", "admin", "deployer"] }, { "name": "Sasha", "role": ["admin"] }] }]
FLATTEN
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
FLATTEN |
JSON 配列を繰り返しフラット化し、新しい 1 次元の配列を作成します。 | FLATTEN() |
なし | フラット化された JSON 配列。 |
例: ネストされた JSON 配列をフラット化する
サンプルデータ: $var1$ = [[1, 2], [3, 4]]
使用方法: $var1$.FLATTEN()
出力: [1, 2, 3 ,4]
FLOOR
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
FLOOR |
指定された入力以下の最大の整数を計算します。 | FLOOR() |
なし | 整数。 |
例:
サンプルデータ: $var1$ = {27.6}
使用方法: $var1$.FLOOR()
出力: 27
FOR_EACH
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
FOR_EACH |
配列内の要素ごとに 1 つ以上の変換関数を適用します。 | FOR_EACH(~objn -> Variable or Value)
ここで、~objn は、変換関数を適用する現在の配列イテレーション要素を示します。デフォルトでは、n の値は 1 から始まります。 スキーマのある JSON 配列の場合、現在の配列要素の後にドット(.)表記を使用して、その配列要素のネストされたプロパティに直接アクセスできます。例をご覧ください。 |
変換関数。 | 要素の配列。 |
例 1: 値を文字列配列のすべての要素に連結する
サンプルデータ: $var1$ = {"Alex","Bola","Charlie","Dana","Hao"}
使用方法: $var1$.FOR_EACH(~obj1-> ~obj1.CONCAT("@gmail.com"))
値 @gmail.com を var1 に連結します。
出力:
{
"Alex@gmail.com",
"Bola@gmail.com",
"Charlie@gmail.com",
"Dana@gmail.com",
"Hao@gmail.com"
}
例 2: スキーマのない JSON 配列で、すべての JSON オブジェクトにプロパティを追加する
サンプルデータ:
$var1$ = { "employeeDetails": [ { "name": "Alex" }, { "name": "Bola" }, { "name": "Charlie" } ] }
使用方法: $var1$.employeeDetails.FOR_EACH(~obj1-> ~obj1.SET_PROPERTY("Google","company"))
プロパティ company:Google を var1 に追加します。
出力:
[ { "name": "Alex", "company": "Google" }, { "name": "Bola", "company": "Google" }, { "name": "Charlie", "company": "Google" } ]
例 3: スキーマのない JSON 配列で、ネストされたすべての JSON オブジェクトにプロパティを追加する
サンプルデータ:
$var1$ = { "employeeDetails": [ { "name": "Alex", "details": [ { "age": "27", "address": "1800 Amphibious Blvd. Mountain View, CA 94045" } ] }, { "name": "Bob", "details": [ { "age": "25", "address": "8 Rue du Nom Fictif 341 Paris" } ] } ], "deptDetails": [ { "id1": "HR" }, { "id2": "Finance" }, { "id3": "Sales" } ] }
使用方法: $var1$.employeeDetails.FOR_EACH(~obj1-> ~obj1.GET_PROPERTY("details").FOR_EACH(~obj2-> ~obj2.SET_PROPERTY("dd/mm/yyyy", "dob")))
プレースホルダ プロパティ dob: "dd/mm/yyyy" を var1 の details に追加します。
出力:
[ [ { "age": "27", "address": "1800 Amphibious Blvd. Mountain View, CA 94045", "dob": "dd/mm/yyyy" } ], [ { "age": "25", "address": "8 Rue du Nom Fictif 341 Paris", "dob": "dd/mm/yyyy" } ] ]
例 4: スキーマのある JSON 配列で、JSON オブジェクトのネストされたプロパティを連結する
サンプルデータ:
$var1$ = {"citynames": [ { "city": "Abbeville", "info": { "pincode": 29620, "state": "South Carolina", "location" : { "lat" : "50.1055 N", "lon": "1.8368 E" } } }, { "city": "Aberdeen", "info": { "pincode": AB10, "state": "Scotland", "location" : { "lat" : "57.1499 N", "lon": "2.0938 W" } } }, { "city": "Benicia", "info": { "pincode": 94510, "state": "California", "location" : { "lat" : "38.0494 N", "lon": "122.1586 W" } } } ] }
使用方法: $var1$.citynames.FOR_EACH(~obj1-> ~obj1.city.CONCAT(",").CONCAT(~obj1.info.location.lat).CONCAT(",").CONCAT(~obj1.info.location.lon))
var1 で区切り文字(,)を使用して、city のネストされたプロパティを連結します。
出力:
[ "Abbeville,50.1055 N,1.8368 E", "Aberdeen,57.1499 N,2.0938 W", "Benicia,38.0494 N,122.1586 W" ]
例 5: テンプレート JSON 内の JSON 配列オブジェクト参照を解決する
サンプルデータ:
$var2$ = { "cityName": "$~obj1.city$", "latitude": "$~obj1.info.location.lat$", "longitude": "$~obj1.info.location.lon$" }
$var1$ = {"citynames": [ { "city": "Abbeville", "info": { "pincode": 29620, "state": "South Carolina", "location" : { "lat" : "50.1055 N", "lon": "1.8368 E" } } }, { "city": "Aberdeen", "info": { "pincode": AB10, "state": "Scotland", "location" : { "lat" : "57.1499 N", "lon": "2.0938 W" } } }, { "city": "Benicia", "info": { "pincode": 94510, "state": "California", "location" : { "lat" : "38.0494 N", "lon": "122.1586 W" } } } ] }
使用方法: $var1$.citynames.FOR_EACH(~obj1-> $var2$.RESOLVETEMPLATE())
var2 の ~obj1
の参照を解決します。ここで、~obj1
は var1 の現在のイテレーション要素です。
出力:
[ { "cityName": "Abbeville", "latitude": "50.1055 N", "longitude": "1.8368 E", } { "cityName": "Aberdeen", "latitude": "57.1499 N", "longitude": "2.0938 W", } { "cityName": "Benicia", "latitude": "38.0494 N", "longitude": "122.1586 W", } ]
GET_ELEMENT
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GET_ELEMENT |
インデックスで指定された JSON 配列の要素を返します。配列内では、最初の値はインデックス 0 で参照できます。最後の値はインデックス n-1 で参照できます。ここで、n は配列のサイズです。 | GET_ELEMENT(value) |
要素のインデックス値。 | 要素の値。 |
例: JSON 配列の要素の値を取得する
サンプルデータ: $var1$ = ["first", "second", "third", "fourth"]
使用方法: $var1$.GET_ELEMENT(2)
2
の要素を取得します。出力: third
GET_PROPERTY
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GET_PROPERTY |
JSON オブジェクトで指定されたプロパティの値を返します。 | GET_PROPERTY(value) |
プロパティ名。 | プロパティの値。 |
例: JSON オブジェクトのプロパティの値を取得する
サンプルデータ: $var1$ = {"productId": 23,"productName": "radio"}
使用方法: $var1$.GET_PROPERTY("productId")
productId
の値を取得します。出力: 23
GET
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GET |
指定されたインデックスで配列内の値を返します。配列内では、最初の値はインデックス 0 で参照でき、最後の値はインデックス n-1 で参照できます。ここで、n は配列のサイズです。 | GET(value) |
整数型のインデックス値。 | 配列の指定されたインデックスの値。戻り値の型は、配列のデータ型によって異なります。たとえば、整数配列の場合、この関数は整数値を返します。 |
例 1: 整数配列のインデックスで値を取得する
サンプルデータ: $var1$ = {11,6,7,2,15,8}
使用方法: $var1$.GET(3)
出力: 2
例 2: 文字列配列のインデックスで値を取得する
サンプルデータ: $var1$ =
{"Hello", "Test", "Apigee", "Integrations", "API Trigger", "Cloud"}
使用方法: $var1$.GET(5)
出力: Cloud
GREATER_THAN_EQUAL_TO
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GREATER_THAN_EQUAL_TO |
整数が指定された値以上かどうか確認します。 | GREATER_THAN_EQUAL_TO(value) |
比べる整数値。 | ブール値。整数が指定された値以上の場合は TRUE を返し、そうでない場合は FALSE を返します。 |
例: 整数が指定した値以上かどうか確認する
サンプルデータ: $var1$ = 35
使用方法: $var1$.GREATER_THAN_EQUAL_TO(15)
出力: TRUE
GREATER_THAN
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GREATER_THAN |
既存の数値が、指定された数値より大きいかどうかを確認します。 | GREATER_THAN(value) |
確認する数値。 | ブール値。既存の数値が指定値より大きい場合は TRUE を返し、そうでない場合は FALSE を返します。 |
例: 整数が指定された値より大きいかどうかを確認する
サンプルデータ: $var1$ = 25
使用方法: $var1$.GREATER_THAN(27)
出力: FALSE
LENGTH
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
LENGTH |
文字列の長さを計算します。文字列の長さは文字列の文字数です。 | LENGTH() |
なし | 文字列の長さ。 |
例: 文字列の長さを求める
サンプルデータ: $var1$ = "Hello Apigee Test"
使用方法: $var1$.LENGTH()
出力: 17
LESS_THAN_EQUAL_TO
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
LESS_THAN_EQUAL_TO |
整数が指定された値以下であるかどうかを確認します。 | LESS_THAN_EQUAL_TO(value) |
比べる整数値。 | ブール値。整数が指定された値以下の場合は TRUE を返し、そうでない場合は FALSE を返します。 |
例: 整数が指定した値以下であるかどうかを確認する
サンプルデータ: $var1$ = 35
使用方法: $var1$.LESS_THAN_EQUAL_TO(15)
出力: FALSE
LESS_THAN
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
LESS_THAN |
既存の数値が、指定された数値より小さいかどうかを確認します。 | LESS_THAN(value) |
確認する数値。 | ブール値。既存の数値が指定された数値より小さい場合は TRUE を返し、そうでない場合は FALSE を返します。 |
例: 整数が指定された値より小さいかどうかを確認する
サンプルデータ: $var1$ = 25
使用方法: $var1$.LESS_THAN(27)
27
より小さいかどうかを確認します。出力: TRUE
MAX
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
MAX |
配列内の最大値を見つけます。 | MAX() |
なし | 配列内の最大値。 |
例 1: 整数配列内の最大値を取得する
サンプルデータ: $var1$ = {5,8,2,1}
使用方法: $var1$.MAX()
出力: 8
例 2: double 配列内の最大値を取得する
サンプルデータ: $var1$ = {2.5,6.1,4.9}
使用方法: $var1$.MAX()
出力: 6.1
MERGE
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
MERGE |
2 つの JSON 変数(オブジェクトまたは配列)を結合します。両方の変数に同じ値が存在する場合、この関数により重複した値が削除されます。 | MERGE(value) |
結合する JSON 値。 | JSON オブジェクトまたは配列。 |
例: 2 つの JSON オブジェクトを結合する
サンプルデータ: $var1$ = {"productId": 23}
使用方法: $var1$.MERGE({"productName":"radio"})
{"productName":"radio"}
を var1 に結合します。出力: {"productId": 23,"productName": "radio"}
例: 2 つの JSON 配列を結合する
サンプルデータ: $var1$ = ["first", "second", "third"]
使用方法: $var1$.MERGE([4,5])
[4,5]
を var1 に結合します。出力: ["first", "second", "third",4,5]
MIN
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
MIN |
配列内の最小値を見つけます。 | MIN() |
なし | 配列内の最小値。 |
例 1: 整数配列内の最小値を見つける
サンプルデータ: $var1$ = {5,8,2,1}
使用方法: $var1$.MIN()
出力: 1
例 2: double 配列内の最小値を見つける
サンプルデータ: $var1$ = {2.5,6.1,4.9}
使用方法: $var1$.MIN()
出力: 2.5
MOD
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
MOD |
2 つの値を除算し、除算の余りを返します。 | MOD(value) |
除数値。 | 除算の余り。 |
例: 除算の余りを求める
サンプルデータ: $var1$ = 90
使用方法: $var1$.MOD(3)
3
で割ります。出力: 0
MULTIPLY
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
MULTIPLY |
既存の数値に指定された数値を乗算します。 | MULTIPLY(value) |
掛ける数値。 | 2 つの数値の積。 |
例: 2 つの整数の積を求める
サンプルデータ: $var1$ = 10
使用方法: $var1$.MULTIPLY(3)
出力: 30
NAND
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
NAND |
指定されたブール値の論理 NAND 演算を行います。 | NAND(value) |
ブール値。 | ブール値。 |
例: ブール式の NAND 値を求める
サンプルデータ: $var1$ = TRUE
使用方法: $var1$.NAND(TRUE)
出力: FALSE
NOR
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
NOR |
指定されたブール値の論理 NOR 演算を行います。 | NOR(value) |
ブール値。 | ブール値。 |
例: ブール式の NOR 値を求める
サンプルデータ: $var1$ = FALSE
使用方法: $var1$.NOR(FALSE)
出力: TRUE
NOT
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
NOT |
ブール値の逆の値を返します。 | NOT() |
なし | ブール値。 |
例: ブール値の逆の値を求める
サンプルデータ: $var1$ = FALSE
使用方法: $var1$.NOT()
出力: TRUE
OR
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
OR |
指定されたブール値の論理 OR 演算を行います。 | OR(value) |
ブール値。 | ブール値。 |
例: ブール式の OR 値を求める
サンプルデータ: $var1$ = FALSE
使用方法: $var1$.OR(TRUE)
出力: TRUE
REMOVE
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
REMOVE |
指定された値を配列から削除します。 | REMOVE(value) |
削除する値。 | 指定された値を削除した後の配列。 |
例: 文字列配列から文字列を 1 つ削除する
サンプルデータ: $var1$ = {"Hello","Apigee","Integrations"}
使用方法: $var1$.REMOVE("Integrations")
Integrations
を削除します。出力: {"Hello","Apigee"}
REMOVE_AT
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
REMOVE_AT |
配列の指定されたインデックスにある要素を削除します。 | REMOVE_AT(value) |
配列のインデックス値。 | 指定された要素を削除した後の配列。 |
例: 文字列配列から要素 1 つを削除する
サンプルデータ: $var1$ = {"Hello","Apigee","Integrations"}
使用方法: $var1$.REMOVE_AT(1)
出力: {"Hello","Integrations"}
REMOVE_PROPERTY
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
REMOVE_PROPERTY |
JSON オブジェクトからプロパティを削除します。 | REMOVE_PROPERTY(value) |
プロパティ名。 | 指定されたプロパティと対応する値を削除した後の JSON オブジェクト。 |
例: JSON オブジェクトからプロパティを削除する
サンプルデータ:
$var1$ = { "name": "Alex", "address": { "street": "1800 Amphibious Blvd", "city": "Mountain View", "state": "CA", "pincode": "94045" } }
使用方法: $var1$.REMOVE_PROPERTY("address.street")
JSON から address.street プロパティを削除します。
出力:
{ "name": "Alex", "address": { "city": "Mountain View", "state": "CA", "pincode": "94045" } }
REPLACE_ALL
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
REPLACE_ALL |
文字列内の生成された部分文字列をすべて置き換えます。 | REPLACE_ALL(value, value) |
この関数には、以下の引数が渡されます。
|
置換された値で更新された文字列。 |
例: 部分文字列のオカレンスをすべて新しい値に置き換える
サンプルデータ: $var1$ = "HelloApigee"
使用方法: $var1$.REPLACE_ALL("Apigee", "Google")
出力: HelloGoogle
RESOLVE_TEMPLATE
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
RESOLVE_TEMPLATE |
$variable$ 参照を含むテンプレート文字列内の参照を解決します。 | RESOLVE_TEMPLATE() |
なし | 参照変数の値で解決されたテンプレート。 |
例: $variable$ 参照を含むテンプレート JSON 内の JSON 参照を解決する
サンプルデータ:
$var1$ = { "name": "Alex", "address": "$var2$", "age": "25" }
$var2$ = { "street": "1800 Amphibious Blvd", "city": "Mountain View", "state": "CA", "pincode": "94045" }
使用方法: $var1$.RESOLVE_TEMPLATE()
var1 の var2 変数参照を解決します。
出力:
{ "name": "Alex", "address": { "street": "1800 Amphibious Blvd", "city": "Mountain View", "state": "CA", "pincode": "94045" }, "age": "25" }
例: $variable$ 参照を含むテンプレート文字列内の文字列参照を解決する
サンプルデータ:
$var1$ = Hello $var2$
$var2$ = World
使用方法: $var1$.RESOLVE_TEMPLATE()
var1 の var2 変数参照を解決します。
出力: Hello World
ROUND
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
ROUND |
数値を最も近い整数に四捨五入します。 | ROUND() |
なし | 整数。 |
例: 数値を最も近い整数に四捨五入する
サンプルデータ: $var1$ = 15.6
使用方法: $var1$.ROUND()
出力: 16
SET
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 | |
---|---|---|---|---|---|
SET |
文字列配列の指定されたインデックスにある値を更新します。 | SET(value,value) |
この関数には、以下の引数が渡されます。
|
更新後の文字列配列。 |
例: インデックスにある文字列配列の値を更新する
サンプルデータ: $var1$ = {"Hello","World","Integrations"}
使用方法: $var1$.SET(2,"Apigee")
出力: {"Hello","World","Apigee"}
SET_PROPERTY
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
SET_PROPERTY |
JSON オブジェクトのプロパティを追加または更新します。 | SET_PROPERTY(value) |
プロパティ名と値。 | プロパティが新たに追加または更新された JSON オブジェクト。 |
例: JSON オブジェクトにプロパティを 1 つ追加する
サンプルデータ: $var1$ = {"productId":23}
使用方法: $var1$.SET_PROPERTY("radio","productName")
出力: {"productId":23,"productName":"radio"}
例: ネストされたプロパティを JSON オブジェクトに追加する
サンプルデータ: $var1$ = {"productId":23}
使用方法: $var1$.SET_PROPERTY({"productName","radio"},"productDetails")
出力: {"productId":23,"productDetails":{"productName":"radio"}}
例: JSON オブジェクトのプロパティを更新する
サンプルデータ: $var1$ = {"productId":23}
使用方法: $var1$.SET_PROPERTY("34","productId")
productId
プロパティを更新します。出力: {"productId":34}
SIZE
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
SIZE |
配列内の要素の数をカウントします。 | SIZE() |
なし | 配列内の要素の総数 |
例 1: 文字列配列のサイズを求める
サンプルデータ: $var1$ = {"Hello", "Apigee", "Integrations"}
使用方法: $var1$.SIZE()
出力: 3
例 2: 整数配列のサイズを求める
サンプルデータ: $var1$ = {5,8,2,1,7}
使用方法: $var1$.SIZE()
出力: 5
SPLIT
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
SPLIT |
指定した区切り文字に基づいて文字列を分割する。 | SPLIT(value) |
文字列の分割に使用する 1 つの文字または一連の文字。 | 文字列配列。 |
例 1: 空白文字で文字列を分割する
サンプルデータ: $var1$ = "Hello Apigee Integrations"
使用方法: $var1$.SPLIT(" ")
出力: {"Hello","Apigee","Integrations"}
例 2: カンマ文字で文字列を分割する
サンプルデータ: $var1$ = "Test,Integrations"
使用方法: $var1$.SPLIT(",")
出力: {"Test","Integrations"}
SUBSTRING
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
SUBSTRING |
現在の文字列のうち、開始インデックス(開始インデックス値を含む)から終了インデックス(終了インデックス値を含まない)までの部分文字列を返します。 | SUBSTRING(value, value) |
この関数には、以下の引数が渡されます。
|
開始インデックスと終了インデックスの間の文字列。 |
例: 現在の文字列の開始インデックス番号にある文字から終了インデックス番号の前にある文字までの部分文字列を返す
サンプルデータ: $var1$ = "HelloApigee"
使用方法: $var1$.SUBSTRING(1, 5)
出力: ello
SUBTRACT
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
SUBTRACT |
既存の数値から指定された数値を減算します。 | SUBTRACT(value) |
減算する数値。 | 2 つの数値の差。 |
例: 整数値を減算する
サンプルデータ: $var1$ = 10
使用方法: $var1$.SUBTRACT(15)
出力: -5
SUM
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
SUM |
配列内のすべての値を合計します。 | SUM() |
なし | 配列内のすべての数値の合計。戻り値の型は配列の型によって異なります。たとえば、Double 型の配列の場合、戻り値の型は double の値です。 |
例: 整数配列のすべての値を合計する
サンプルデータ: $var1$ = {5,8,2,1}
使用方法: $var1$.SUM()
出力: 16
TO_BASE_64
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_BASE_64 |
UTF-8 文字セットを使用して文字列を base64 形式でエンコードします。 | TO_BASE_64() |
なし | base64 でエンコードされた文字列。 |
例: 文字列を base64 形式でエンコードする
サンプルデータ: $var1$ = "Hello World!"
使用方法: $var1$.TO_BASE_64()
出力: SGVsbG8gV29ybGQh
TO_BOOLEAN_ARRAY
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_BOOLEAN_ARRAY |
JSON 配列をブール値配列に変換します。 | TO_BOOLEAN_ARRAY() |
なし | ブール値配列。 |
例: JSON 配列をブール値配列に変換する
サンプルデータ: $var1$ = ["true", "false", "false"]
使用方法: $var1$.TO_BOOLEAN_ARRAY()
出力: {true, false, false}
TO_BOOLEAN
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_BOOLEAN |
文字列のデータ型をブール値に変換します。 | TO_BOOLEAN() |
なし | ブール値。文字列が「true」または「false」の場合、この関数は対応するブール値を返します。 |
例 1: 文字列のブール値を取得する
サンプルデータ: $var1$ = "true"
使用方法: $var1$.TO_BOOLEAN()
出力: TRUE
例 2: 文字列のブール値を取得する
サンプルデータ: $var1$ = "FALSE"
使用方法: $var1$.TO_BOOLEAN()
出力: FALSE
TO_DOUBLE_ARRAY
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_DOUBLE_ARRAY |
JSON 配列を double 配列に変換します。 | TO_DOUBLE_ARRAY() |
なし | double 配列。 |
例: JSON 配列を double 配列に変換する
サンプルデータ: $var1$ = [1.3, 4.8, 7.9]
使用方法: $var1$.TO_DOUBLE_ARRAY()
出力: {1.3, 4.8, 7.9}
TO_DOUBLE
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_DOUBLE |
文字列または整数を double に変換します。 | TO_DOUBLE() |
なし | double。 |
例 1: 文字列を double に変換する
サンプルデータ: $var1$ = "2.5"
使用方法: $var1$.TO_DOUBLE()
出力: 2.5
例 2: 整数を double に変換する
サンプルデータ: $var1$ = 22
使用方法: $var1$.TO_DOUBLE()
出力: 22.0
TO_INT_ARRAY
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_INT_ARRAY |
JSON 配列を整数配列に変換します。 | TO_INT_ARRAY() |
なし | 整数配列。 |
例: JSON 配列を整数配列に変換する
サンプルデータ: $var1$ = [3, 8, 9]
使用方法: $var1$.TO_INT_ARRAY()
出力: {3, 8, 9}
TO_INT
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_INT |
文字列を整数値に変換します。 | TO_INT() |
なし | 整数。 |
例: 文字列を整数値に変換する
サンプルデータ: $var1$ = "35"
使用方法: $var1$.TO_INT()
出力: 35
TO_JSON
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_JSON |
現在の値を JSON オブジェクトに変換します。 | TO_JSON() |
なし | JSON オブジェクト。 |
例: 文字列を JSON に変換する
サンプルデータ: $var1$ = "{product: "cake", id: 21, price: 5}"
使用方法: $var1$.TO_JSON()
出力: {product: "cake", id: 21, price: 5}
TO_LOWERCASE
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_LOWERCASE |
文字列内のすべての文字を小文字に変換します。 | TO_LOWERCASE() |
なし | すべて小文字の文字列。 |
例: 文字列を小文字に変換する
サンプルデータ: $var1$ = "Integrations TEST"
使用方法: $var1$.TO_LOWERCASE()
出力: integrations test
TO_SET
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_SET |
配列内で重複した値を削除します。 | TO_SET() |
なし | 重複する値のない配列。 |
例 1: 文字列配列の異なる文字列だけを取得する
サンプルデータ: $var1$ = {"Hello","World","Apigee","World"}
使用方法: $var1$.TO_SET()
出力: {"Hello","World","Apigee"}
例 2: 整数配列で重複する値を削除する
サンプルデータ: $var1$ = (2,6,9,12,6,8,10,6,12)
使用方法: $var1$.TO_SET()
出力: 2,6,9,12,8,10
TO_STRING_ARRAY
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_STRING_ARRAY |
JSON 配列を文字列配列に変換します。 | TO_STRING_ARRAY() |
なし | 文字列配列。 |
例: JSON 配列を文字列配列に変換する
サンプルデータ: $var1$ = [[1, 2], [3, 4]]
使用方法: $var1$.TO_STRING_ARRAY()
出力: ["[1, 2]", "[3, 4]"]
TO_STRING
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_STRING |
数値または JSON を文字列に変換します。 | TO_STRING() |
なし | 文字列。 |
例: 整数を文字列に変換する
サンプルデータ: $var1$ = 235
使用方法: $var1$.TO_STRING()
出力: 235
例: JSON を文字列に変換する
サンプルデータ:
$var1$ = { "dbIntegers": [1.0, 2.0, 3.0, 4.0], "dbString": "test" }
使用方法: $var1$.TO_STRING()
出力:
{ "dbIntegers": [ 1, 2, 3, 4 ], "dbString": "test" }
TO_UPPERCASE
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
TO_UPPERCASE |
文字列内のすべての文字を大文字に変換します。 | TO_UPPERCASE() |
なし | すべて大文字の文字列。 |
例: 文字列を大文字に変換する
サンプルデータ: $var1$ = "Integrations Test"
使用方法: $var1$.TO_UPPERCASE()
出力: INTEGRATIONS TEST
XNOR
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
XNOR |
指定されたブール値の論理 XNOR 演算を行います。 | XNOR(value) |
ブール値。 | ブール値。 |
例: ブール式の XNOR 値を求める
サンプルデータ: $var1$ = FALSE
使用方法: $var1$.XNOR(TRUE)
出力: FALSE
XOR
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
XOR |
指定されたブール値の論理 XOR 演算を行います。 | XOR(value) |
ブール値。 | ブール値。 |
例: ブール式の XOR 値を求める
サンプルデータ: $var1$ = TRUE
使用方法: $var1$.XOR(FALSE)
出力: TRUE
サポートされている基本関数
GENERATE_UUID
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GENERATE_UUID |
ランダムな UUID を生成します。 | GENERATE_UUID() |
なし | 文字列 |
例: UUID を生成する
使用方法: GENERATE_UUID()
出力: 57547434-b572-4aaa-8da6-e6768850baa3
GET_EXECUTION_ID
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GET_EXECUTION_ID |
現在の統合の実行 ID を返します。 | GET_EXECUTION_ID() |
なし | 文字列 |
例: 現在の統合実行の実行 ID を取得する
使用方法: GET_EXECUTION_ID()
出力: 83fb009a-0152-433d-a3b6-e38118335308
GET_INTEGRATION_NAME
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GET_INTEGRATION_NAME |
現在の統合の名前を返します。 | GET_INTEGRATION_NAME() |
なし | 文字列 |
例: 現在の統合の名前を取得する
使用方法: GET_INTEGRATION_NAME()
出力: demo_integration
GET_INTEGRATION_REGION
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GET_INTEGRATION_REGION |
現在の統合のリージョンを返します。 | GET_INTEGRATION_REGION() |
なし | 文字列 |
例: 現在の統合のリージョンを取得する
使用方法: GET_INTEGRATION_REGION()
出力: us-east1
GET_PROJECT_ID
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
GET_PROJECT_ID |
現在の統合の Google Cloud プロジェクト ID を返します。 | GET_PROJECT_ID() |
なし | 文字列 |
例: 現在の統合の Google Cloud プロジェクト ID を取得する
使用方法: GET_PROJECT_ID()
出力: demo-gcp-ip
INT_LIST
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
INT_LIST |
指定された範囲内の整数リストを返します。返されるリストに、開始値は含まれますが、終了値は含まれません。 | INT_LIST(value, value) |
この関数には、以下の引数が渡されます。
|
整数配列 |
例: 12~20 の整数配列を生成する
使用方法: INT_LIST(“12”, “20”)
12~20 の整数のリストを返します。
出力: 12, 13, 14, 15, 16, 17, 18, 19
NOW_IN_MILLIS
関数
関数名 | 説明 | 使用方法 | 入力パラメータ | 戻り値 |
---|---|---|---|---|
NOW_IN_MILLIS |
Unix エポックから現在までの経過時間をミリ秒単位で返します。 | NOW_IN_MILLIS() |
なし | Unix エポック時間(ミリ秒) |
例: 現在の Unix エポック時間をミリ秒単位で取得し、人が読める形式に変換する
使用方法: NOW_IN_MILLIS().EPOCH_TO_HUMAN_READABLE_TIME("d MMM yyyy HH:mm:ss:SSS z","GMT")
Unix エポック 1657783580839
を人が読める形式に変換します。
出力: 14 Jul 2022 07:26:20:839 GMT