Muleフローの設計
Liferay Connector to MuleSoftを設定したら、Mule フローの構築を開始できます。 これらの操作は、Liferayの OpenAPI エンドポイントで利用できます。
- レコードの作成
- レコードの削除
- レコードの取得
- レコードの更新
- バッチ - レコードのエクスポート
- バッチ - レコードのインポート - 作成
- バッチ - レコードのインポート - 削除
- バッチ - レコードのインポート - 更新
大規模なデータセットを扱っている場合は、Liferayのバッチ操作を使用して、データをより速く送信および処理します。
レコード作成操作
この操作は、選択された OpenAPI 3.0ドキュメントのPOSTメソッドで処理されるすべてのエンドポイントを公開するものです。 Liferay MuleSoft コネクタでサポートされているさまざまな操作のリファレンスとして、Liferayの API Explorer ( http://[host]:[port]/o/api ) を使用してください。 コネクタの構成でエンドポイントからの OpenAPI ドキュメントを使用することもできます。

エンドポイントを選択すると、コネクターは自動的に関連するメタデータを生成します。 そして、入力パラメータを指定することができます。 入力パラメータはすべてのLiferay RESTful Webサービスをサポートしますが、すべてのエンドポイントに必要なわけではありません。
| パラメーター名 | 種類 | 説明 | 必須 |
|---|---|---|---|
| エンドポイント | 文字列 | 作成操作をサポートする利用可能なエンドポイントのドロップダウンリスト | はい |
| レコード | オブジェクト | 作成するオブジェクト | はい |
| パスパラメーター | オブジェクト | パスパラメーター値を使用したマッピング | あり(エンドポイントで必要な場合) |
| クエリパラメーター | オブジェクト | クエリパラメーター値を使用したマッピング | いいえ |

上記の手順で、フロー内の他の操作を設定し、使用することができます。
一括エクスポート操作
この操作により、1回のリクエストで指定したエンティティの全レコードを取得することができます。 レコードがたくさんあるときに便利です。 レコード数が少ない場合は、 [レコードの取得]操作を使用してください。
![複数のレコードをエクスポートするには、[バッチ - レコードのエクスポート]操作を使用します。](https://resources.learn.liferay.com/images/dxp/latest/en/commerce/add-ons-and-connectors/mulesoft/designing-mule-flows/images/03.png)
一括エクスポート操作を設定するには、クラス名ドロップダウンを使用してエクスポートするエンティティを選択します。 一度選択すると、コネクターは関連する出力メタデータを動的に生成します。 必要であれば、フィールド名入力を使用して、エクスポートされるエンティティに含めるフィールドを指定できます。 フィールド名はカンマで区切る必要があります。 また、バッチ処理ロジックで必要な場合は、サイトIDパラメーターを指定できます。
| パラメーター名 | 種類 | 説明 | 必須 |
|---|---|---|---|
| クラス名 | 文字列 | エクスポートされたエンティティのクラス名 | はい |
| サイトID | 文字列 | siteId クエリパラメータ | いいえ |
| フィールド名 | 文字列 | エクスポートされるエンティティフィールドのカンマ区切りのリスト | いいえ |
このフローを実行すると、JSON配列が生成され、別のアプリケーションに変換して読み込むことができます。
一括インポート操作
一括インポート操作には、作成、削除、更新の3種類があります。 各操作はエンティティのセットをインポートしますが、Liferayのバッチエンジンはそれらを異なる方法で処理します。 下図は、一括インポート作成操作のイメージです。
![レコードを一括してインポートするには、[バッチ - レコードのインポート]操作を使用します。](https://resources.learn.liferay.com/images/dxp/latest/en/commerce/add-ons-and-connectors/mulesoft/designing-mule-flows/images/04.png)
一括インポート操作を設定するには、まず、 クラス名 ドロップダウンを使用して、インポートするエンティティを選択します。 一度選択すると、コネクターは関連する入力メタデータを動的に生成します。 次に、 レコードフィールドを使用して、エンティティオブジェクトのJSON配列を送信します。 必要に応じて、フィールド名マッピングドロップダウンを使用して、異なるシステムの関連エンティティ間でフィールド名をマッピングします。
メッセージの変換 モジュールを使用して、ソース システムと宛先システム間でエンティティ フィールドをマップした場合は、 フィールド名マッピング を空のままにしておくことができます。
| パラメーター名 | 種類 | 説明 | 必須 |
|---|---|---|---|
| クラス名 | 文字列 | インポートされたエンティティのクラス名 | はい |
| フィールド名のマッピング | オブジェクト | フィールド名のマッピング定義が入力されています | いいえ |
| レコード | オブジェクト | エンティティオブジェクトのJSON配列 | はい |
利用可能なすべての操作と関連する入力パラメータを表示するには、 Liferay MuleSoft コネクタ技術リファレンスを参照してください。