ラボ 2: 顧客登録ロジックの実装

その顧客に該当する Salesforce (SFDC) のアカウントを作成

アカウント作成が成功したことを確認

アカウント作成が失敗した場合は、

成功した場合は、

api ビューを選択し、Muleパレット にある Add Module のアイコンをクリックして、後続のステップで実装に必要となるSalesforceコネクターとValidationモジュールを追加します。

Salesforceコネクター と Validationモジュール をドラッグ・アンド・ドロップして、 Finish をクリックして下さい。

では、リソースの POST オペレーションを実装しましょう。 post:\customer:application\json:api-config という名前のフローを見つけて下さい( api ビューの一番下にあるはずです)

API仕様で定義されたサンプル応答を返す、自動生成された Transform Message を削除します。

Muleパレットから、Salesforce​ を選択し、 Create が見つかるまでスクロールして下さい。コンポーネントをフローにドラッグアンドドロップします。

Salesforce のアイコンをクリックすると、設定画面が下に表示されます。

名前を Create Account に変更して下さい。

Save All ボタンをクリックしてください。

Package Explorer ビューで src/main/resources を右クリックし、 New → Folder を選択してフォルダーを作成します。名前に configuration と入力し Finish をクリックして下さい。

Package Explorer ビューで src/main/resources/configuration を右クリックし、 New → File を選択してファイルを作成します。名前に config.yaml と入力し Finish をクリックして下さい。

以下の内容を config.yaml にコピーして下さい。あなたのAPIで使用するSalesforceコネクターの接続認証情報が含まれています。

sfdc:
  username: "demos+mythical_lab@mulesoft.com"
  password: "Elum1379"
  securityToken: "7ZDtkYMazEtbvgdaaPrtMGit"

APIのプロパティ・ファイルの設定を完了するため、api ビューをクリックして、 Global Elements タブを開いて下さい。

Create をクリックし、 properties と入力して検索して下さい。Configuration Properties を選択して OK をクリックして下さい。File: に configuration/config.yaml と入力して OK をクリックします。

Save All ボタンをクリックします。

これでプロパティが設定されたので、コネクターの構成に進みましょう。 Message Flow のタブに戻り、先ほど追加したSalesforceコネクターを選択して下さい。

コネクター構成の ボタンをクリックして下さい。

コネクター構成に、以下のプロパティを入力します:

Test Connection…​ をクリックして、接続できることを確認して下さい。

OK を (2回)クリックします。

Save All ボタンをクリックしてください。

Type: プロパティの横にある リフレッシュボタンをクリックし、 Account を選択して下さい。

Record 欄にある payload を削除し、 Refresh Metadata をクリックします。

Salesforceコネクター画面の Records セクションで、をクリックします。

Dataweaveによるメッセージ変換が表示されます。入出力のパネルを確認してください。 リクエスト(入力)からSalesforceオブジェクト(出力)へと、各フィールドをドラッグ＆ドロップしてマッピングを定義することができます。

%dw 2.0
output application/java
---
[{
	Name: payload.name,
	BillingStreet: payload.billingAddress.address1,
	BillingCity: payload.billingAddress.city,
	BillingState: payload.billingAddress.state,
	BillingPostalCode: payload.billingAddress.postalCode,
	BillingCountry: payload.billingAddress.country,
	ShippingStreet: payload.shippingAddress.address1,
	ShippingCity: payload.shippingAddress.city,
	ShippingState: payload.shippingAddress.state,
	ShippingPostalCode: payload.shippingAddress.postalCode,
	ShippingCountry: payload.shippingAddress.country,
	Phone: payload.phone,
	AccountNumber: uuid(),
	Account_Email__c: payload.email
}]

Dataweave には多くの便利なファンクションがあり、Studioで確認することが可能です。 AccountNumberフィールドにカーソルを置いて F3 を押すと、適用可能な全てのファンクションが表示されます。 uuid と入力してフィルターすると、ファンクションについての情報が確認できます。

Save All ボタンをクリックしてください。

レスポンスを確認するために、 Validation: is true コンポーネントを追加します。Muleパレットで、 is true​ と入力して下さい。

アイコンを、フローの最後にドラッグ・アンド・ドロップして下さい。

Validationモジュールのプロパティを以下のように設定します。

Validationでは、Expression および Message の２つの設定を変更します。また、Validationエラーを生成するためにすぐに使える（Out of the boxの）エラー・タイプが使用されることを確認して下さい。

Validationモジュールのエラー・マッピングを確認します。Error Mapping タブをクリックし、 ボタンをクリックして、すぐに使用できる(Out of the boxの)エラー・タイプを確認して下さい。 VALIDATION:INVALID_BOOLEAN が事前に入力されているので、ここでは何もする必要はありません。

では、APIKIT:BAD_REQUEST エラー・ハンドラーに VALIDATION:INVALID_BOOLEAN を設定しましょう。 api メッセージ・フロー・ビューに移動し、エラー・ハンドラーを配置して、エラー・タイプを選択します。

Type セクションに以下のテキストを追加してください。 ,VALIDATION:INVALID_BOOLEAN

Save All ボタンをクリックしてください。

前のステップと同様に、Salesforceコネクターの Query コンポーネントをフローの最後にドラッグ・アンド・ドロップしてください。

以下のプロパティを設定します:

続いて、サービスからのレスポンスを整形するTransformを追加します。前のステップで配置したSalesforceアイコンの後に、 Transform Message をドラッグ・アンド・ドロップして下さい。

Transform Message を右クリックしてRename（名前変更）を選択します。Transform Message のテキストを、SFDC Account Detail to JSON に変更して下さい。

アイコンをクリックして、Transformationの中身をみてみましょう。

以下のdataweave スクリプトをコピーして貼り付けてください:

%dw 2.0
output application/json
var customer = payload[0]
---
{
	name: customer.Name default "",
	id: customer.AccountNumber default ""
}

Save をクリックしてください。