Try-Catch ブロックの作成例

Integration Procedure では、指定された LastName の取引先責任者を作成および削除し、LastName が空白の場合はエラーメッセージを返します。

Integration Procedure には次のコンポーネントがあります。

• TryCatchBlock1 という名前の Try-Catch ブロック

• DRPostAction1 という名前の OmniStudio データマッパー投稿アクション

• DeleteAction1 という名前の削除アクション

• ResponseAction1 という名前の応答アクション

[構造] パネルは次のようになります。

この Integration Procedure を作成する

1. [OmniStudio Integration Procedure] タブで、[新規] をクリックします。
2. Integration Procedure Name (インテグレーション手順名)、Type (種別)、および SubType (サブ種別) を入力し、[保存] をクリックします。
3. [Try-Catch Block (トライキャッチブロック)] を [Structure (構造)] パネルにドラッグし、次の設定を行います。

   1. [Failure Response (失敗時の応答)] で、[Add Key/Value Pair (キー/値ペアを追加)] をクリックします。[キー] を [failureResponse]、[値] を [You must provide a last name.] に設定

   2. [Fail on Block Error (ブロックエラーで失敗)] チェックボックスがオンになっていることを確認します。

4. データマッパー投稿アクションコンポーネントでコールするデータマッパー読み込みを作成します。

   1. データマッパーインターフェース名に「CreateContact」、インターフェース種別に「Load」と名前を付けます。

   2. [オブジェクト] タブで、[オブジェクトを追加] をクリックし、[取引先責任者] を選択します。

   3. [Fields]タブで、[+]アイコンをクリックし、[Input JSON Path]と[Domain Object Field]の両方に「LastName」と入力します。

   データマッパー読み込みの作成方法がわからない場合は、「OmniStudio データマッパー読み込み例」の例を参照してください。

5. [データマッパー投稿アクション] コンポーネントを [トライキャッチブロック] にドラッグし、次の設定を指定します。
   1. [要素名] を [DRPostAction1] に設定します。

   2. データマッパーインターフェースを [CreateContact] に設定します。

   3. [ステップエラーで失敗(Fail on Step Error)] チェックボックスがオンになっていることを確認します。

6. [削除アクション] コンポーネントを [トライキャッチブロック] の後にドラッグします。[Delete SObject (SObject を削除)] で、[種別] を [Contact (取引先責任者)]、[Path To Id (ID のパス)] を [%DRPostAction1:Contact_1:Id%] に設定します。
7. 応答アクションを最後のコンポーネントとして [構造] パネルにドラッグし、[Return Full Data JSON (完全なデータの JSON を返す)] チェックボックスをオンにします。
8. [プレビュー] タブに移動して、インテグレーション手順をテストします。

   1. [入力パラメータ] で、[Add New Key/Value Pair (新規キー/値ペアの追加)] をクリックします。

   2. [キー] を「LastName」に設定し、[値] を任意の名前に設定します。

   3. [Execute (実行)] をクリックします。

   出力は次のようになります。

   {
     "response": {},
     "ResponseAction1Status": true,
     "DeleteAction1": [
       {
         "errors": [],
         "success": true,
         "id": "0034N00001rNgqqQAC"
       }
     ],
     "DeleteAction1Status": true,
     "TryCatchBlock1": null,
     "TryCatchBlock1Status": true,
     "DRPostAction1": {
       "ActualTime": 626,
       "CpuTime": 345,
       "Contact_1": [
         {
           "UpsertSuccess": true,
           "Id": "0034N00001rNgqqQAC",
           "LastName": "Aristotle"
         }
       ],
       "error": "OK",
       "responseType": "SObject"
     },
     "DRPostAction1Status": true,
     "options": {
       "queueableChainable": false,
       "ignoreCache": true,
       "resetCache": false,
       "chainable": false
     },
     "LastName": "Aristotle"
   }
   

9. [値] を空白にして、もう一度 [実行] をクリックします。出力は次のようになります。

   {
     "result": {
       "failureResponse": "You must provide a last name."
     },
     "success": false
   }