シンプルな Integration Procedure を設計する
学習の目的
この単元を完了すると、次のことができるようになります。
- 管理パッケージ用 Omnistudio の Integration Procedure のデータ入力とデータ出力について説明する。
- データを取得する Integration Procedure の設計方法を説明する。
- データを保存する Integration Procedure の設計方法を説明する。
- API (アプリケーションプログラミングインターフェース) からデータを取得する Integration Procedure の設計方法を説明する。
データ入力とデータ出力
この単元では、3 種類の設計シナリオで Integration Procedure を使用する手順について学びます。設計シナリオを見ていく前に、管理パッケージ用 Omnistudio の Integration Procedure のデータ入力とデータ出力を簡単に復習しましょう。
データ入力
以前に説明したとおり、どの要素を使用するかはデータソースに左右されます。
データ入力ソースの種類 | 使用する Integration Procedure Action 要素 |
|---|---|
Salesforce 組織 | Omnistudio Data Mapper Extract Action または Data Mapper Turbo Action |
API | HTTP Action |
Apex がアクセスできるデータ | Remote Action |
データ出力
Response Action は Integration Procedure に固有の要素で、Integration Procedure を起動したツールにデータを返します。データを取得して処理するほか、Integration Procedure を使用してデータを出力することもできます。
データ出力ソースの種類 | 使用する Integration Procedure Action 要素 |
|---|---|
Flexcard または Omniscript | Response Action |
Salesforce 組織 | データを Salesforce レコードに保存する Data Mapper Post Action |
Salesforce 組織 | データを Salesforce レコードから削除する Delete Action |
API | HTTP Action |
メール送信 | Email Action |
DocuSign テンプレート | DocuSign Envelope Action |
これで基本は理解できました。順調です。ではシナリオに進みましょう。
シナリオ 1: データを取得する Integration Procedure を設計する
取引先の詳細を編集する Omniscript で、サンプルデータをライブデータに置換する必要があるとします。
Omniscript で Salesforce からデータを抽出し、変更したデータを元の Salesforce に保存できるようにする必要があります。そのためにすべきことは、Edit Account Omniscript にこの 1 つ目の Integration Procedure を設計することです。
この Integration Procedure には、次の 2 つの要件があります。
- Salesforce から取引先データを抽出する。
- そのデータを Omniscript に送信する。
では、どこから始めればよいでしょうか? 上記のデータ要件を満たすための Integration Procedure の要素を順番に選択していきましょう。このシナリオの焦点はデータを取得することです。
Salesforce から取引先データを取得可能な Action 要素を選択します。この場合の選択肢は次のとおりです。
- Data Mapper Post Action
- Data Mapper Turbo Action
- Data Mapper Transform Action
どれを選択すべきでしょうか? 先ほどのデータ入力表をみると、ここでは Salesforce からデータを取得するため、Data Mapper Turbo Action が正しい選択であることがわかります。このアクションは Data Mapper Turbo Extract をコールして、Salesforce からデータを取得します。
Edit Account Omniscript にデータを返す Action 要素を選択します。この場合の選択肢は次のとおりです。
- Data Mapper Post Action
- Response Action
- HTTP Action
ここでの正しい Action 要素は Response Action です。前述のとおり、このアクションは Integration Procedure を起動したオブジェクトにデータを返します。このシナリオでは Omniscript です。
シナリオ 2: データを保存する Integration Procedure を設計する
先ほどのシナリオに戻り、今度は焦点を保存にシフトします。
ここでは、Omniscript で Salesforce からデータを抽出し、変更したデータを元の Salesforce に保存できるようにする必要があります。そのためにすべきことは、Edit Account Omniscript にデータを保存する Integration Procedure を設計することです。
Salesforce に取引先データを保存して戻す Action 要素を選択します。この場合の選択肢は次のとおりです。
- Data Mapper Post Action
- Data Mapper Extract Action
- Integration Procedure Action
この場合は、更新済みのデータが元の Salesforce に保存されるようにするため、正しい選択肢は Data Mapper Post Action です。
シナリオ 3: API からデータを取得する Integration Procedure Action を設計する
続いて、天気を表示する Flexcard で、サンプルデータを外部ソースから取り込んだ天気予報データに置換する必要があるとします。そのためにすべきことは、Weather Flexcard に Integration Procedure を設計することです。
この Integration Procedure には、いくつかの要件があります。
- API (アプリケーションプログラミングインターフェース) から天気データを取得する。
- 天気データをトリミングして対応付け直す (多数の項目)。
- Integration Procedure をコールしたツールにそのデータを返送する (この場合は Weather Flexcard)。
このデータ要件を満たす Integration Procedure の要素を選択しましょう。
まず、API から現在の天気予報データを取得する Action 要素を選択します。この場合の選択肢は次のとおりです。
- Data Mapper Extract Action
- Data Mapper Transform Action
- HTTP Action
正しい選択肢は HTTP Action です。この Action 要素は、Web API からデータを取得するように設定できます。
次に、天気データをトリミングして対応付けし直す Action 要素を選択します。この場合の選択肢は次のとおりです。
- Data Mapper Post Action
- Data Mapper Transform Action
- HTTP Action
正しい選択はどれでしょうか? そう、Data Mapper Transform Action です。前述のとおり、Data Mapper Transform では、Web API から受信したデータをトリミングして対応付け直すことができます。
最後に、Weather Flexcard にデータを返す Action 要素を選択します。選択肢は次のとおりです。
- Response Action
- Data Mapper Post Action
- HTTP Action
正しい選択肢は Response Action です。Response Action は、起動元のオブジェクト (このシナリオでは Weather Flexcard) にデータを返します。
シナリオで的確な判断を下すことができました! 学んだことを実践する準備はできましたか? 次の単元では、Integration Procedure でさらに実践を重ねていきます。