ラボ 2: Order Fulfillment APIを実装し、プロセス層の API を作成

前のラボで生成したOrder Fulfillment API スタブを拡張します。

Scatter Gatherなどのフローコントロールを使用して、このプロセスAPIのオーケストレーションを実行します。

Order API を呼び出して Order を作成します。

ユーザデータを取得するためにCustomer APIを呼び出します。

DataWeave変換を使用して、システムAPIリクエストから集約されたプロセスAPIレスポンスメッセージを構築します。

Anypoint StudioからプロセスAPIを含むMuleアプリを実行してテストします。

Anypoint Studioのフローダイアグラムに戻り、post:\order_fulfillment:applicationjson:order-fulfillment-api-config というフローから、Transform Messageをクリックします。

Transformコンポーネントを削除し、scatter gatherを追加します。

メニューより File → New → File へ移動します。

Finish を押します。

次の値をコピーして貼り付けます。

system:
  api:
    host:
      customers: mythical-customer-api-v4-0.cloudhub.io
      orders: mythical-order-api-v4-1.us-e1.cloudhub.io

api.raml ファイルで、Global Elements タブに移動します。

Create ボタンを押します。

Configuration でフィルタし、 Configuration properties を選択します。

OK を押します。

Fileプロパティを configuration.yaml という値で完成させます。

OKを押します。

Exchange Icon をクリックします。

組織名で「Order API」を検索します。

Order APIをクリックして、APIポータルを探索します。

POSTメソッドのリクエストとレスポンスボディの仕組みを詳しく見てみましょう。

Add to project をクリックします。

警告のポップアップウィンドウが表示されますので Proceed を押します。

ドラッグ＆ドロップで Order API から Create order を配置します。

コネクタをダブルクリックして、プロパティを表示します。Mule Properties View に、構成するコンポーネントのプロパティが表示されます。

アイコンをクリックして、以下のように新しい設定を作成します。:

リクエスト設定の完成

OK をクリックします。

General セクションでは、以下のパラメータを設定します:

Create order request data: ボックスからpayloadを削除し、 {} を追加します。

Refresh Metadata ボタンを押します。

ボタンをクリックしして、RAML Consumersの入出力メッセージを変換します。

Order Fulfillment APIのPOST呼び出しのフィールドを、Order APIのPOST呼び出しに必要なフィールドにマッピングします。次のDataWeaveスクリプトをDataWeaveコードエディタに貼り付けます。:

{
	customerId: payload.customer_id,
	orderLineItems: (payload.products default []) map ( product , indexOfProduct ) -> {
		productId: product.id,
		quantitySafetyStock: product.quantity,
		quantitiyOnHand: product.quantity,
		productName: product.productName
	},
	status: payload.status,
	totalPrice: payload.price as String
}

マッピングは以下のように表示されるはずです。

　ボタンを押します。

元のペイロードを変更したくないので、Order Idを変数に保存します。

Advance タブに移動します。

以下のデータで表を完成させます:

コンポーネントパレットで "Business" を検索します。

Connectorコンポーネントの後に、Custom Business Event コネクタをキャンバスにドラッグ＆ドロップします。

Custom Business Event アイコンをダブルクリックして、そのプロパティを表示します。Mule Properties View に、設定するコンポーネントのプロパティが表示されます。

Display Name（表示名）」と Event Name（イベント名）フィールドに、Order Created Eventのように、操作が判る名前を追加します。

Key Performance Indicators セクションで、 をクリックして、以下のKPIを追加します:

Exchange のポータルを見て、Customer API をプレビューします。

Customers → GET に移動し、レスポンスを見てみましょう。

Add to project ボタンをクリックします。

Order API Connectorをインポートするために行ったのと同じ手順となります。

Customer API コネクタから Get customer by id をドラッグ アンド ドロップします。

コネクタをダブルクリックして、プロパティを表示すると、Mule Properties View に設定するコンポーネントのプロパティが表示されます。

アイコンをクリックして、図のように新しい設定を作成します:

Customer API で使用する HTTP 構成を定義します。

次の値を入力してください:

OK をクリックします。

General セクションでは、以下のパラメータを設定します:

最後に、Scatter-Gather の後に Transform Message コンポーネントを追加してAPIレスポンスを構築します。

Transform Message コンポーネントをダブルクリックします。

以下のDataweaveスクリプトを貼り付けます。

%dw 2.0
output application/json
---
{
	order_id: vars.order_id as Number,
	username: payload."1".payload.name default ""
}

前のラボで行ったように、アプリケーションを起動します。(アプリケーションを右クリックし、Run As > Mule application 選択します。

Anypoint Studioで API Console View が開いたら、リンクをクリックします。

リクエストボディへ移動し、 Send ボタンをクリックします。

リクエストが処理されると、200 番のレスポンスコードとAPIのJSONレスポンスが表示されるはずです。