update

DataWeave 2.2 は Mule 4.2 と互換性があり、Mule 4.2 にバンドルされています。このバージョンの Mule は、拡張サポートが終了する 2023 年 5 月 2 日にそのすべてのサポートが終了しました。

このバージョンの Mule を使用する CloudHub には新しいアプリケーションをデプロイできなくなります。許可されるのはアプリケーションへのインプレース更新のみになります。

標準サポートが適用されている最新バージョンの Mule 4 にアップグレードすることをお勧めします。これにより、最新の修正とセキュリティ機能強化を備えたアプリケーションが実行されます。

update(Object, String): Any

この update 関数は、指定された文字列値でオブジェクトの項目を更新します。

この関数は、指定された項目と値を含む新しいオブジェクトを返します。

パラメーター

名前説明

名前	説明
`objectValue`	更新するオブジェクト。
`fieldName`	項目の名前を提供する文字列。

objectValue

更新するオブジェクト。

fieldName

項目の名前を提供する文字列。

例

次の例では、指定された値でオブジェクト {name: "Mariano"} の name 項目を更新します。

ソース

%dw 2.0
import * from dw::util::Values
output application/json
---
{name: "Mariano"} update "name" with "Data Weave"

出力

{
  "name": "Data Weave"
}

update(Object, PathElement): Any

この update 関数は、指定された PathElement 値でオブジェクト項目を更新します。

この関数は、指定された項目と値を含む新しいオブジェクトを返します。

パラメーター

名前説明

名前	説明
`objectValue`	更新するオブジェクト。
`fieldName`	項目名を指定する `PathElement`。

objectValue

更新するオブジェクト。

fieldName

項目名を指定する PathElement。

例

次の例では、オブジェクト {name: "Mariano"} の name 項目の値を更新します。これは field("name") を使用して PathElement を返し、それを update に渡します。with "Data Weave" を使用して name の値 (Data Weave) を指定します。

ソース

%dw 2.0
import * from dw::util::Values
output application/json
---
{name: "Mariano"} update field("name") with "Data Weave"

出力

{
  "name": "Data Weave"
}

update(Array, Number): Any

指定された値で配列インデックスを更新します。

この update 関数は、指定されたインデックスの値を変更する新しい配列を返します。

パラメーター

名前	説明
objectValue	更新する配列。
indexToUpdate	更新する配列のインデックス。インデックスは数値である必要があります。

名前

説明

objectValue

更新する配列。

indexToUpdate

更新する配列のインデックス。インデックスは数値である必要があります。

例

次の例では、入力配列 [1,2,3] 内の値 2 (インデックスは 1) を 5 に置き換えます。

ソース

%dw 2.0
import * from dw::util::Values
output application/json
---
[1,2,3] update 1 with 5

出力

update(Array, String): Any

この update 関数は、指定された文字列値で、指定された配列内のすべてのオブジェクトを更新します。

パラメーター

名前説明

名前	説明
`objectValue`	更新するオブジェクトの配列。
`indexToUpdate`	更新する項目の名前を提供する文字列。

objectValue

更新するオブジェクトの配列。

indexToUpdate

更新する項目の名前を提供する文字列。

例

次の例では、オブジェクトの配列内の role 項目の値を更新します。

ソース

%dw 2.0
import * from dw::util::Values
output application/json
---
[{role: "a", name: "spiderman"}, {role: "b", name: "batman"}] update "role" with "Super Hero"

出力

[{
   "role": "Super Hero",
   "name": "spiderman"
 },
 {
   "role": "Super Hero",
   "name": "batman"
}]

update(Array, PathElement): Any

この update 関数は、指定された PathElement 値で、指定された配列のインデックスを更新します。

この関数は、指定されたインデックスの位置に指定された値が含まれる新しい配列を返します。

パラメーター

名前説明

名前	説明
`objectValue`	更新する配列。
`indexToUpdate`	更新する配列のインデックス。インデックスは `PathElement` として指定する必要があります。

objectValue

更新する配列。

indexToUpdate

更新する配列のインデックス。インデックスは PathElement として指定する必要があります。

例

次の例では、入力配列内の要素の値を更新します。これは index(1) を使用してインデックスを PathElement として返し、それを update に渡します。このインデックスの位置にある値 2 を 5 に置き換えます。

ソース

%dw 2.0
import * from dw::util::Values
output application/json
---
[1,2,3] update index(1) with 5

出力

update(Array | Object | Null, Array<String | Number | PathElement>): Any

指定された値で、指定されたパスの位置にある値を更新します。

パラメーター

名前説明

名前	説明
`objectValue`	更新する値。配列、オブジェクト、または null 値を受け入れます。
`path`	更新するパス。パスは文字列、数値、または `PathElement` の配列である必要があります。

objectValue

更新する値。配列、オブジェクト、または null 値を受け入れます。

path

更新するパス。パスは文字列、数値、または PathElement の配列である必要があります。

例

次の例では、ユーザーの名前を更新します。

ソース

%dw 2.0
import * from dw::util::Values
output application/json
---
{user: {name: "Mariano"}} update ["user", field("name")] with "Data Weave"

出力

{
   "user": {
     "name": "Data Weave"
   }
 }

update(Null, Number | String | PathElement): Any

update を null 対応にするためのヘルパー関数。