シンプルな Integration Procedure を設計する

学習の目的

この単元を完了すると、次のことができるようになります。

• Integration Procedure のデータ入力とデータ出力について説明する。
• データを取得する Integration Procedure の設計方法を説明する。
• データを保存する Integration Procedure の設計方法を説明する。
• API (アプリケーションプログラミングインターフェース) からデータを取得する Integration Procedure の設計方法を説明する。

データ入力とデータ出力

この単元では、3 種類の設計シナリオで Integration Procedure を使用する手順について説明します。設計シナリオを見ていく前に、OmniStudio Integration Procedure のデータ入力とデータ出力を簡単に復習しましょう。 

データ入力

以前に説明したとおり、どの要素を使用するかはデータソースに左右されます。

データ出力

Response Action は Integration Procedure に固有の要素で、Integration Procedure を起動したツールにデータを返します。データを取得して処理するほか、Integration Procedure を使用してデータを出力することもできます。

復習したところで、シナリオに進みましょう! 

シナリオ 1: データを取得する Integration Procedure を設計する

取引先の詳細を編集する OmniScript で、サンプル (モック) データをライブデータに置換する必要があるとします。OmniScript で Salesforce からデータを抽出し、変更したデータを元の Salesforce に保存できるようにする必要があります。そのためにすべきことは、Edit Account OmniScript にこの 1 つ目の Integration Procedure を設計することです。 

この Integration Procedure には、次の 2 つの要件があります。

• Salesforce から取引先データを抽出する。
• そのデータを Edit Account OmniScript に送信する。

まず何をすべきでしょうか? 上記のデータ要件を満たすために必要な Integration Procedure の要素を順番に選択していきましょう。このシナリオの焦点はデータを取得することです。 

Integration Procedure で Salesforce から取引先データを取得可能な Action 要素を選択します。この場合の選択肢は次のとおりです。

1. DataRaptor Post Action
2. DataRaptor Turbo Action
3. DataRaptor Transform Action

どれを選択すべきでしょうか? 上記のデータ入力表をみると、ここでは Salesforce からデータを取得するため、DataRaptor Turbo Action が正しい選択であることがわかります。このアクションは DataRaptor Turbo Extract をコールして、Salesforce からデータを取得します。

Integration Procedure で Edit Account OmniScript にデータを返すことができる Action 要素を選択します。この場合の選択肢は次のとおりです。

1. DataRaptor Post Action
2. Response Action
3. HTTP Action

ここでの正しい Action 要素は Response Action です。前述のとおり、このアクションは Integration Procedure を起動したオブジェクト (またはコール元、このシナリオでは Edit Account OmniScript) にデータを返します。

シナリオ 2: データを保存する Integration Procedure を設計する

先ほどのシナリオに戻り、今度は焦点を保存にシフトします。ここでは、OmniScript で Salesforce からデータを抽出し、変更したデータを元の Salesforce に保存できるようにする必要があります。そのためにすべきことは、Edit Account OmniScript にデータを保存する Integration Procedure を設計することです。 

Integration Procedure で元の Salesforce に取引先データを保存できるようにする Action 要素を選択します。この場合の選択肢は次のとおりです。

1. DataRaptor Post Action
2. DataRaptor Extract Action
3. Integration Procedure Action

この場合は、更新済みのデータが元の Salesforce に保存されるようにするため、正しい選択肢は DataRaptor Post Action です。

シナリオ 3: API からデータを取得する Integration Procedure Action を設計する

続いて、Weather FlexCard でサンプルデータを、外部ソースから取り込んだ天気予報データに置換する必要があるとします。そのためにすべきことは、Weather FlexCard に Integration Procedure を設計することです。

この Integration Procedure には、いくつか１の要件があります。

• API (アプリケーションプログラミングインターフェース) から天気データを取得する。
• 天気データをトリミングして対応付け直す (多数の項目)。
• Integration Procedure をコールしたツールにそのデータを返送する (この場合は Weather FlexCard)。

このデータ要件を満たすために必要な Integration Procedure の要素を選択しましょう。 

Integration Procedure で API から現在の天気予報データを取得できる Action 要素を選択します。この場合の選択肢は次のとおりです。

1. DataRaptor Extract Action
2. DataRaptor Transform Action
3. HTTP Action

正しい選択肢は HTTP Action です。この Action 要素は、Web API からデータを取得するように設定できます。

ここでは、Integration Procedure で天気データをトリミングして対応付け直すことができる Action 要素を選択します。この場合の選択肢は次のとおりです。

1. DataRaptor Post Action
2. DataRaptor Transform Action
3. HTTP Action

正しい選択はどれでしょうか? そう、DataRaptor Transform Action です。前述のとおり、DataRaptor Transform では、Web API から受信したデータをトリミングして対応付け直すことができます。

最後に、Integration Procedure でそのデータを元の Weather FlexCard に送信できる Action 要素を選択します。選択肢は次のとおりです。

1. Response Action
2. DataRaptor Post Action
3. HTTP Action

この場合の正しい選択肢は Response Action です。Response Action は、起動元のオブジェクト (このシナリオでは Weather FlexCard) にデータを返します。

シナリオで的確な判断を下すことができました! (*バーチャルハイタッチ*) 学んだことを実践する準備はできていますか? 次の単元では、Integration Procedure でさらに実践を重ねていきます。