ユーティリティ変換関数

ユーティリティ変換関数を使用して、アレイから複合オブジェクトを返すか、特定のキーに関連付けられた値を返します。

ユーティリティ変換関数には、アレイ、名前と値のペア、文字列、整数、または選択肢の入力データピルが必要です。ユーティリティ変換関数を適用するときは、正しい入力データピルタイプを使用してください。ユーティリティ変換関数が不適切なデータタイプに適用されると、データは実行時に変換されず、代わりに入力値が返されます。フローランタイム値を確認する方法の詳細については、「フローをテストする」を参照してください。

アレイの最初のアイテムを取得

入力アレイの最初のアイテムを複合オブジェクトとして返します。

入力データピル	出力データピル
アレイ	Complex Object：入力アレイで最初に見つかったアイテム

アレイのアイテムを取得

入力アレイから複合オブジェクトを返します。返す入力アレイに Nth Item の値を入力します。Nth Item は、0 から始まるアレイインデックスを表します。

入力データピル	パラメーター	出力データピル
アレイ	Nth Item：ターゲットオブジェクトのインデックスを入力アレイに入力します。アレイインデックスは 0 から始まります。	複合オブジェクト

名前/値からアイテムを取得

名前と値のペアのマップから一致するキーに関連付けられている値を返します。

入力データピル	パラメーター	出力データピル
名前/値ペア	Key：対応する値を検索するために使用されるキーの名前 Default：一致するキーがない場合に返される値	一致するキーに関連付けられた文字列

注:

[名前/値からアイテムを取得] 変換関数を適用するときは、ランタイム値が表示値ではなくシステム値である可能性があることを考慮してください。たとえば、インシデントテーブルの [優先度] フィールドをリモートテーブルの同じフィールドにマッピングする場合、返されるランタイム値は「2 - 高」ではなく「2」になります。

図 : 1. 例

• 入力："username":"abel.tuter"
• キー：username
• デフォルト：example.username
• 出力：abel.tuter

この例では、アクションによってサードパーティシステムへの REST 呼び出しが行われ、GET チケットデータが名前と値のペアのマップとして取得されます。チケット ID は、このアクションの出力として提供されます。[名前/値からアイテムを取得] 変換関数は、ticket_id キーに関連付けられている値か、[Ticket ID が見つからない (Ticket ID not found)] のいずれかを返します。

アレイの最後のアイテムを取得

入力アレイの最後のアイテムを複合オブジェクトとして返します。

入力データピル	出力データピル
アレイ	Complex Object：入力アレイで最後に見つかったアイテム

空の場合

入力が空白の場合は true を返します。空の文字列の場合、文字列入力は空白です。整数入力がゼロの場合は空白です。false の場合、ブール値の入力は空白です。

入力データピル	出力
任意	true または false を返します

図 : 2. 例

• 入力：0 の整数データピル
• 出力：true

false の場合

入力が false の場合は true を返します。空の文字列の場合、文字列は false です。ゼロの場合、整数は false す。false の場合、ブール値の入力は false です。

入力データピル	出力データピル
任意	true または false を返します

図 : 3. 例

• 入力：13 の整数データピル
• 出力：false

空白でない場合

入力が空白でない場合は true を返します。空の文字列でない場合、文字列は空白ではありません。ゼロ以外の場合、整数は空白ではありません。true の場合、ブール値の入力は空白ではありません。

入力データピル	出力データピル
任意	true または false を返します

図 : 4. 例

• 入力：13 の整数データピル
• 出力：true

null の場合

入力値が null の場合は true を返します。入力が初期化されていない場合、または null オブジェクトまたは参照である場合、入力は null です。

入力データピル	出力
任意	true または false を返します

図 : 5. 例

• 入力：725 の整数データピル
• 出力：false

true の場合

入力が true の場合は true を返します。空の文字列でない場合、文字列は true です。ゼロ以外の場合、整数は true です。true の場合、ブール値の入力は true です。

入力データピル	出力データピル
任意	true または false を返します

図 : 6. 例

• 入力：13 の整数データピル
• 出力：true

キー値マップ (Key Value Map)

一致するキーに関連付けられた値を返します。一致しない場合はデフォルト値を返します。

入力データピル	パラメーター	出力データピル
文字列または整数	Name：対応する値を検索するために使用されるキー Value：特定のキーに一致する値 Default：一致する名前がない場合に返される値	一致するキーに関連付けられた文字列

図 : 7. 例

この例では、ログアクションがレコードの優先度をメッセージとして保存します。[名前/値] セクションでは、各優先度が対応する文字列値にマップされます。フローが実行されると、レコードの優先度番号が文字列に変換され、その文字列がメッセージに記録されます。

ソート

指定したアレイを昇順または降順でソートします。

入力データピル	パラメーター	出力データピル
Array.String、Array.Integer、Array.Boolean、または Array.Datetime. ：未ソートアレイ	Sort Order：昇順または降順	アレイ：ソート済みアレイ

注:

ソート関数では、array.strings に対して大文字と小文字が区別されます。

図 : 8. 例

• 入力：[7, 2, 3, 1, 7, 9]
• パラメーター：昇順
• 出力：[1, 2, 3, 7, 7, 9]

一意

指定されたアレイから重複する要素を削除します。

入力データピル	出力データピル
Array.String、Array.Integer、Array.Boolean、または Array.Datetime.	アレイ：重複した要素が削除された後

図 : 9. 例

• 入力：[7, 2, 3, 2, 7, 9]
• 出力：[7, 2, 3, 9]

参加

指定されたアレイの個々の要素を指定された区切り文字で連結し、連結された文字列を返します。

入力データピル	パラメーター	出力データピル
Array.String、Array.Integer、Array.Boolean、または Array.Datetime.	区切り文字：連結後に個々の要素を区切る文字。	文字列：区切り文字が追加された後の文字列。

図 : 10. 例

• 入力：[1, 2, 3]
• パラメーター：<
• 出力：1<2<3