Flex Gateway新着情報
Governance新着情報
Monitoring API Managerコンポーザーでデータを操作するには、式をビルドして関数を適用します。カスタム式エディターを使用して、関数と数学演算子を含む式を作成します。このエディターを使用して、単語を切り捨てたり、語句を大文字にしたり、日付を設定したりします。
フローの数式をビルドするときは、次の点に注意してください。
関数をネストして、関数の別の関数コールの入力パラメーターを使用できます。
コンポーザーで使用される Composer 関数は、 DataWeave を使用してビルドされます。
Composer 関数は、空白スペースを数式内の空白スペース文字として処理します。
カスタム式エディターは、次の string
数式と演算子をサポートしています。
関数名 | 説明 | 例 | パラメーター定義 | 入力データ型パラメーター | 出力データ型 |
---|---|---|---|---|---|
lower |
指定された文字列を小文字で返します。 |
|
なし |
text: String |
String (文字列) |
upper |
指定された文字列を大文字で返します。 |
|
なし |
text: String |
String (文字列) |
capitalize |
文字列内の各単語の先頭を大文字にします。さらに、単語間のアンダースコアを削除し、先頭が大文字の単語の前にスペースを挿入します。 |
|
なし |
text: String |
String (文字列) |
trim |
文字列の先頭と末尾に空白スペースがあれば、それを削除します。 |
|
なし |
text: String |
String (文字列) |
first |
文字列の先頭からの指定文字数の文字を返します。この数が文字列内の文字数以上の場合、この関数では文字列全体を返します。 |
|
なし |
text: String numCharacters: Number |
String (文字列) |
last (最後) |
テキスト文字列の末尾からの指定文字数の文字を返します。 |
|
なし |
text: String numCharacters: Number |
String (文字列) |
substitute |
リテラル検索文字列に一致するすべてのサブ文字列を指定された置換文字列に置き換えます。置換は、文字列の先頭から末尾に向かって行われます。たとえば、文字列 |
|
なし |
text: String target: String replacement: String |
String (文字列) |
fromStringToBoolean |
文字列入力値をブール値に変換します。 |
|
なし |
text: String |
Boolean (ブール) |
fromStringToDate |
文字列入力値を日付値に変換します。形式とロケールを受け入れます。形式パラメーターは、入力文字列の形式を表します。 デフォルトの形式は |
|
Format (形式): 形式パラメーターは、入力文字列の形式を表します。このパラメーターでは、ISO-8601 に基づいた Java 文字パターンを受け入れます。 Locale (ロケール): 使用する省略可能な ISO 3166 国コード ( |
text: String format: String locale: String |
Date (日付) |
fromStringToDateTime |
文字列入力値を日時値に変換します。
形式とロケールを受け入れます。形式パラメーターは、入力文字列の形式を表します。
デフォルトの形式は |
|
Format (形式): 形式パラメーターは、入力文字列の形式を表します。このパラメーターでは、ISO-8601 に基づいた Java 文字パターンを受け入れます。 Locale (ロケール): 使用する省略可能な ISO 3166 国コード ( |
text: String format: String |
DateTime (日時) |
fromStringToNumber |
文字列入力値を数値に変換します。 |
|
なし |
text: String |
Number (数値) |
emptyString |
空の文字列を返します。 emptyString 関数は、他の関数への入力パラメーターとしての使用など、空の文字列が必要な場合に使用できます。 |
|
|
String (文字列) |
|
substring |
指定された |
|
なし |
text: String from: Number until: Number |
String (文字列) |
string
項目では、演算子リストから選択した number
式を使用できます。ただし、式は括弧で囲む必要があります。たとえば、演算子リストから +
が選択されている場合、abc(9+9)
を入力できます。この文字列は abc18
として表示されます。
カスタム式エディターでは、演算子リストから選択された数学演算子 (+、-、*、または /) は、文字列として入力および解決された演算子とは異なります。たとえば、エントリ 9+9
は 18
ではなく文字列とみなされます。算術演算子を使用するには、演算子リストから選択するか、Enter キー、Tab キー、またはマウスと先行入力を使用して選択します。
カスタム式エディターは、次の number
数式と演算子をサポートしています。
関数名 | 説明 | 例 | パラメーター定義 | 入力データ型パラメーター | 出力データ型 |
---|---|---|---|---|---|
round |
数値を最も近い整数に丸めます。 |
|
なし |
number: Number |
Number (数値) |
ceil |
数値を最も近い整数に切り上げます。 |
|
なし |
number: Number |
Number (数値) |
floor |
数値を最も近い整数に切り捨てます。 |
|
なし |
number: Number |
Number (数値) |
abs |
数値の絶対値を返します。 |
|
なし |
number: Number |
Number (数値) |
fromNumberToString |
数値 (整数または小数) を文字列値に変換します。 |
|
なし |
number: Number |
String (文字列) |
fromNumberToDateTime |
数値入力値を日時値に変換します。ミリ秒または秒を単位として使用します。デフォルト単位は秒です。 |
|
Unit (単位): 変換に使用する時間の単位: 「milliseconds (ミリ秒)」または「seconds (秒)」。デフォルト単位は「seconds (秒)」です。 |
unit: String |
DateTime (日時) |
カスタム式エディターで、date
および dateTime
データピルは入力としてのみ使用できます。日付を手動で入力することはできません。
カスタム式エディターは、次の date
および dateTime
数式と演算子をサポートしています。
関数名 | 説明 | 例 | パラメーター定義 | 入力データ型パラメーター | 出力データ型 |
---|---|---|---|---|---|
today |
今日の日付を日付種別として返します。 |
|
なし |
なし |
Date (日付) |
now |
現在の日付と時刻で日時値を返します。 |
|
なし |
なし |
DateTime (日時) |
addDays |
指定された日数を増分または減分した日付値を作成して返します。 |
|
なし |
date: Date numDays: number |
Date (日付) |
addDays |
指定された日数を増分または減分した日時値を作成して返します。 |
|
なし |
dateTime: DateTime numDays: number |
DateTime (日時) |
addMonths |
指定された月数を増分または減分した日付値を作成して返します。 |
|
なし |
date: Date numMonths: number |
Date (日付) |
addMonths |
指定された月数を増分または減分した日時値を作成して返します。 |
|
なし |
dateTime: DateTime numMonths: number |
DateTime (日時) |
addYears |
指定された年数を増分または減分した日付値を作成して返します。 |
|
なし |
date: Date numYears: number |
Date (日付) |
addYears |
指定された年数を増分または減分した日時値を作成して返します。 |
|
なし |
dateTime: DateTime numYears: number |
DateTime (日時) |
addHours |
指定された時間数を増分または減分した日時値を作成して返します。 |
|
なし |
dateTime: DateTime numHours: number |
DateTime (日時) |
addMinutes |
指定された分数を増分または減分した日時値を作成して返します。 |
|
なし |
dateTime: DateTime numMinutes: number |
DateTime (日時) |
addSeconds |
指定された秒数を増分または減分した日時値を作成して返します。 |
|
なし |
dateTime: DateTime numSeconds: number |
DateTime (日時) |
beginningOfHour |
入力内の時刻値を指定された時間の開始に変更する新しい日時値を返します。入力内の分および秒は 00:00 に変更されます。 |
|
なし |
dateTime: DateTime |
DateTime (日時) |
beginningOfDay |
入力内の時刻値を指定された日の開始に変更する新しい日時値を返します。入力内の時間、分、秒は 00:00:00 に変更されます。 |
|
なし |
dateTime: DateTime |
DateTime (日時) |
beginningOfWeek |
入力の日の値を指定された週の初日の開始に変更する新しい日付値を返します。この関数では、日曜日を週の初日として扱います。 |
|
なし |
date: Date |
Date (日付) |
beginningOfWeek |
入力の日の値と時刻値を指定された週の初日の開始に変更する新しい日時値を返します。この関数では、日曜日を週の初日として扱います。 |
|
なし |
dateTime: DateTime |
DateTime (日時) |
beginningOfMonth |
入力の日の値を指定された月の初日に変更する新しい日付値を返します。 |
|
なし |
date: Date |
Date (日付) |
beginningOfMonth |
入力の日の値を指定された月の初日に変更する新しい日時値を返します。入力内の日時は |
|
なし |
dateTime: DateTime |
DateTime (日時) |
beginningOfYear |
入力の日の値を指定された年の初日に変更する新しい日付値を返します。 |
|
なし |
date: Date |
Date (日付) |
beginningOfYear |
入力の月と日の値を指定された年の初日に変更する新しい日時値を返します。時刻値も |
|
なし |
dateTime: DateTime |
DateTime (日時) |
daysBetween |
2 つの日付間の日数を返します。終了日の値が開始日の値よりも前の場合、この 2 つの日付間の日数に等しい負数が返されます。 |
|
なし |
from: Date to: Date |
Number (数値) |
daysBetween |
2 つの日時値間の日数を返します。終了日の値が開始日の値よりも前の場合、この 2 つの日時値間の日数に等しい負数が返されます。 |
|
なし |
from: DateTime to: DateTime |
Number (数値) |
month |
日付入力の月の数値を返します。 |
|
なし |
date: Date |
Number (数値) |
month |
日時入力の月の数値を返します。 |
|
なし |
dateTime: DateTime |
Number (数値) |
year |
日付入力の年の数値を返します。 |
|
なし |
date: Date |
Number (数値) |
year |
日時入力の年の数値を返します。 |
|
なし |
dateTime: DateTime |
Number (数値) |
fromDateToString |
日付入力値を文字列値に変換します。形式とロケールを受け入れます。形式パラメーターは、出力文字列の必須形式を表します。デフォルトの形式は |
|
Format (形式): 日付で使用する ISO-8601 形式。出力文字列の目的の形式を表します。たとえば、このパラメーターでは Java 8 の java.time.format に基づいた文字パターンを受け入れます。デフォルト形式は Locale (ロケール): 使用する省略可能な ISO 3166 国コード ( |
date: Date format: String locale: String |
String (文字列) |
fromDateTimeToString |
日時入力値を文字列値に変換します。形式とロケールを受け入れます。形式パラメーターは、出力文字列の目的の形式を表します。デフォルトの形式は |
|
Format (形式): 日時で使用する ISO-8601 形式。出力文字列の目的の形式を表します。たとえば、このパラメーターでは Java 8 の java.time.format に基づいた文字パターンを受け入れます。デフォルト形式は Locale (ロケール): 使用する省略可能な ISO 3166 国コード ( |
dateTime: DateTime format: String locale: String |
String (文字列) |
fromDateTimeToNumber |
日時入力値を数値に変換します。数値は、選択した単位に応じてミリ秒または秒になります。デフォルト単位は秒です。 |
|
Unit (単位): 変換に使用する時間の単位: 「milliseconds (ミリ秒)」または「seconds (秒)」。デフォルト単位は「seconds (秒)」です。 |
dateTime: DateTime unit: String |
Number (数値) |
fromDateToDateTime |
日付入力値を日時に変換します。これは、時刻の追加によって行われます。デフォルトの時刻は T00:00:00Z です。すべての手動入力は UTC で解釈されます。 |
|
なし |
date: Date time: String |
DateTime (日時) |
カスタム式エディターは、次の List
数式と演算子をサポートしています。
関数名 | 説明 | 例 | パラメーター定義 | 入力データ型パラメーター | 出力データ型 |
---|---|---|---|---|---|
joinBy |
リストを 1 つの文字列値にマージし、指定された文字列をリストの各項目間の区切り文字として使用します。 |
|
リスト区切り文字
|
リスト: List<String> 区切り文字: String |
String |
splitBy |
入力文字列の一部に一致する区切り文字列に基づいて、文字列を文字列のリストに分割します。 これにより、一致する文字列は、返されるリストから除外されます。区切り文字には、入力内の任意の文字を一致させることができます。 |
|
テキスト区切り文字 |
text: String 区切り文字: String |
List<String> |
コンポーザー項目が値として受け入れることができる値は、データ型です。コンポーザーでは、次のデータ型を使用できます。
データ型 | 定義 |
---|---|
Boolean (ブール) |
|
Date (日付) |
年、月、日を |
DateTime (日時) |
グリニッジ標準時 (GMT) を基準としたタイムゾーン内の日時を保存します。タイムゾーンには、時刻値に記号 |
List<Object> |
[Get Records (レコードの取得)] アクションの出力など、オブジェクトのリストを返します。 |
List<Primitive> |
プリミティブデータ型が含まれるリストを返します。使用できる項目のデータ型は、 |
Number (数値) |
1.40129846432481707e-45 ~ 3.40282346638528860e+38 の範囲の浮動小数点数または整数のいずれかを保存します。 |
Object (オブジェクト) |
他のデータ型をプロパティ ( |
String (文字列) |
テキスト、 |
カスタム式エディターにアクセスする手順は、次のとおりです。
[Composer Flows (コンポーザーフロー)] タブから、フローを開きます。
[編集] をクリックします。
アクション項目、クエリビルダーの値、または [If/Else Block (If/Else ブロック)] コントロールの値で、ドロップダウンメニューから [Custom Expression fx (カスタム式 fx)] を選択します。
カスタム式エディターが表示されます。
カスタム式を追加するときは、[Custom Expression Editor (カスタム式エディター)] ウィンドウの要素の上にカーソルを置き、役立つ提案やアプリケーション内サポートを含むコンテキストポップオーバーをトリガーします。
アクションにカスタム式を追加する手順は、次のとおりです。
カスタム式エディターの左ペインで、次のいずれかのタブをクリックします。
Function (関数): 関数を表示または検索
Data (データ): 項目またはデータピルを表示または検索
Operator (演算子): 演算子を表示または検索
左ペインから、カスタム式の使用可能な関数、項目、データピル、または演算子を選択します。
右ペインの [<項目名>] ボックスに選択内容が表示されます。カスタム式の構文は自動的に検証されます。
[<項目名>] ボックスの式を別の項目で再利用する場合は、それをコピーします。
カスタム式を作成して検証したら、[Apply (適用)] をクリックします。
[Save (保存)] をクリックします。
カスタム式が項目に追加されます。
アクション内の既存のカスタム式を編集する手順は、次のとおりです。
[Composer Flows (コンポーザーフロー)] タブから、フローを開きます。
[Edit (編集)] をクリックします。
カスタム式を含むアクション項目で、鉛筆アイコンをクリックします。
カスタム式エディターが表示されます。
カスタム式エディターの右ペインにある [<項目名>] ボックスで、既存のカスタム式を選択して削除するか、左ペインから項目を追加する場所にカーソルを置きます。
左ペインで、使用可能な関数、項目、データピル、または演算子から選択します。
右ペインの [<項目名>] ボックスに選択内容が表示されます。編集したカスタム式の構文は自動的に検証されます。
カスタム式を編集して検証したら、[Apply (適用)] をクリックします。
[Save (保存)] をクリックします。
カスタム式が編集されました。
アクション内の既存のカスタム式を削除する手順は、次のとおりです。
[Composer Flows (コンポーザーフロー)] タブから、フローを開きます。
[Edit (編集)] をクリックします。
カスタム式を含むアクション項目で、[X] アイコンをクリックします。
カスタム式が項目から削除されます。
実装でこの項目に値を含める必要がある場合は、新しいカスタム式を追加するか、ドロップダウンメニューから値を選択します。
[Flow Details (フローの詳細)] ページで、[Save (保存)] をクリックします。
カスタム式が削除されます。環境でカスタム式項目に値が必要な場合は、追加または選択内容が保存されます。