Salesforce抽出機能

Salesforce 抽出タスクについて

Salesforce Extractor タスクは、クアルトリクスで使用するためにSalesforceからデータをインポートするために使用できます。Salesforceからインポートできるデータは以下の通りです：

• オブジェクトレコード（アカウント、コンタクト、オポチュニティなど）。
• クローズされたケースに関連する電子メール。
• レポートデータ

最初の実行で、タスクは指定されたすべてのレコードをインポートする。それ以降の実行では、前回の実行以降に新規または更新されたレコードが取り込まれる。

Salesforce からオブジェクトを抽出する

このセクションでは、Salesforceからオブジェクトレコード（アカウント、連絡先、オポチュニティなど）をインポートするために、このタスクを設定する方法について説明します。

1. 新しいETLワークフローを作成する。
2. データソース（ETL抽出器）を選択します。
3. Salesforce Extractorタスクを検索します。
4. オブジェクトを選択する。
5. 次へをクリックします。
6. データをインポートする Salesforce アカウントを選択します。
7. 新しい Salesforce アカウントを追加する場合は、[ユーザアカウントの追加] をクリックします。本番またはサンドボックスのアカウントに直接接続することも、サーバー間接続を設定することもできます。各認証機能の詳細については、クアルトリクスとSalesforceの連携をご覧ください。
   ヒント:以前に接続したSalesforceアカウントやブランド管理者が設定したアカウントは、ここで利用できます。
   注意このタスクでは、Salesforce アカウントへの外部接続を最大 5 つまで設定できます。5つ以上の接続を追加した場合、最も古い接続が切断されます。
8. 次へをクリックします。
9. Add objectをクリックし、インポートしたいオブジェクトを選択します。同じ抽出タスクで複数のオブジェクトをインポートできます。
   インポート可能な Salesforce オブジェクトは次のとおりです：
   • アカウント
   • ケース
   • 連絡先
   • リード
   • 機会
     qtip:ここにオブジェクトがない場合は、Salesforceアカウントとクアルトリクスとの接続が無効か期限切れです。戻る」をクリックしてアカウント選択画面に戻り、新しい Salesforce アカウントを追加します。
10. 必要であれば、Salesforceのリストドロップダウンメニューを使用して、Salesforceのリストのフィルタ条件に基づいてインポートするオブジェクトを制限します(リストビューと呼ばれます)。オプションが選択されていない場合は、関連するすべてのオブジェクトがインポートされます。
11. フィールドを追加］をクリックすると、フィールドを選択するドロップダウンメニューが追加されます。
12. Select Fieldドロップダウンメニューを使用して、Salesforceからインポートするフィールドを選択します。
13. 選択した Salesforce オブジェクトの追加フィールドをインポートするには、上記の手順を繰り返します。
    ヒント：タスクから削除するにはフィールドまたはオブジェクトの［次へ］をクリックします。
14. 完了したら保存をクリックします。
15. 次に、ローダータスクを使ってクアルトリクスにデータを保存する必要があります。通常、これは「XM DIRECTORYに連絡先とトランザクションを追加する」タスクです。

Salesforce オブジェクトインポートのトラブルシューティング

ワークフローの完了に失敗した場合は、ワークフローの実行履歴を参照し、失敗の詳細を確認してください。以下は、よくあるエラーとその解決策です：

• 「Salesforceへの認証情報が無効です。
  • タスクで使用された認証情報が無効なので、再入力する必要がある。この問題を解決するには、失敗したタスクを編集し、別の検証クレデンシャルを選択するか、新しいクレデンシャルを追加する。
• “sオブジェクト{{sObjectName}}のリストビュー{{listviewId}}が存在しない”
  • タスクで使用されたリストにユーザーがアクセスできないか、削除された。この問題を解決するには、失敗したタスクを編集し、無効なリストがあるオブジェクトを選択する。次に、使用する新しいリストを選択します。エラーメッセージの {{listviewId}} フィールドには Salesforce のリスト ID が、{{sObjectName}} フィールドには Salesforce のオブジェクト名が含まれています。
• sObject {{sObjectName}} が存在しません。
  • タスクで使用されているオブジェクトにユーザーがアクセスできないか、削除されています。この問題を修正するには、失敗したタスクを編集し、無効なオブジェクトを削除し、タスクを保存する。エラーメッセージの {{sObjectName}} フィールドには、Salesforce のオブジェクト名が含まれています。
• sObject {{sObjectId}} 内のフィールド {{fieldName}} が存在しません。
  • タスクで使われているフィールドにユーザーがアクセスできないか、削除された。この問題を解決するには、失敗したタスクを編集し、無効なフィールドを削除し、タスクを保存する。エラーメッセージの {{fieldName}} フィールドには Salesforce のフィールド名が、{{sObjectId}} フィールドには Salesforce のオブジェクト ID が格納されています。
• データアイソレーションを決定できなかった。
  • このエラーが発生した場合は、クアルトリクスサポートまでお問い合わせください。
• 予期せぬエラーが発生
  • このエラーが発生した場合は、クアルトリクスサポートまでお問い合わせください。
• サンドボックスでエラーが発生しました
  • Sandboxでエラーが発生した場合、問題を解決するためにSandbox以外のバージョンを使用することをお勧めします。サンドボックス環境はテスト目的であり、サンドボックスでない環境と常に同じパフォーマンスを発揮するとは限りません。

SalesforceからEメールを抽出する

ここでは、Salesforceからメールを抽出し、メールデータプロジェクト（オムニチャネルリスニングマネジメントの一環）で使用する方法について説明します。

1. OXM プロジェクトのワークフロータブから、新規 ETL ワークフローを作成します。
2. データソース（ETL抽出器）を選択します。
3. Salesforce Extractorタスクを検索します。
4. Eメールを選択します。
5. 次へをクリックします。
6. データをインポートする Salesforce アカウントを選択します。
7. 新しい Salesforce アカウントを追加する場合は、[ユーザアカウントの追加] をクリックします。
   ヒント:以前に接続したSalesforceアカウントやブランド管理者が設定したアカウントは、ここで利用できます。
   注意このタスクでは、Salesforce アカウントへの外部接続を最大 5 つまで設定できます。5つ以上の接続を追加した場合、最も古い接続が切断されます。
8. 次へをクリックします。
9. インポートしたいSalesforceのCase Statusを選択します。複数のステータスを選択することができます。
   注意選択できるのは、Salesforce で「クローズ」とみなされるケースステータスのみです。デフォルトの「クローズド」ステータスはこのうちの1つで、Salesforceの管理者が設定する「クローズド」ステータスをカスタムで追加することもできます。
10. どのメールを抽出するかを決定する日付を選択します。このタスクが最初に実行されると、選択した日付と最初のタスク実行日（ワークフロー構築時にスケジュールで設定）の間にケースの「クローズ日」があるメールを抽出します。
    ヒント:以降のエグゼクティブでは、ケースの「クローズ日」が前回のエグゼクティブと今回のエグゼクティブの間（ETLスケジュールによって決定されます）にある場合のみ、メールが抽出されます。
    ヒント：ワークフローの上部にある「すぐに実行」ボタンをクリックすると、特定の日付範囲からデータを抽出するカスタムタイムフレームを設定することができます。これにより、上記のデフォルトのデータ抽出動作を「上書き」することができます。ステップバイステップの手順については、「特定の日付範囲からデータを抽出する」を参照してください。このオプションは、Salesforceから電子メールを抽出する場合にのみ利用可能です。
11. 次へをクリックします。
12. 抽出ツールの次のページでは、Salesforce のEmailMessageオブジェクトに接続されている Salesforce フィールドが表示されます。
    注意Salesforceの複合フィールドはクアルトリクスにインポートできないため、ここには表示されません。
13. テーブルの左側には、インポート可能なオプション・フィールドがあります。いくつかの［フィールド］は、OXM プロジェクトで有用であるため、［優先］とマークされています。
14. テーブルの右側には、クアルトリクスにインポートされるフィールドがあります。
    ヒント：いくつかの属性は必須であり、すでにこの列に入っています。取り除くことはできない。
15. フィールドを表の2辺の間に移動するには、フィールドをクリックし、次に矢印ボタンをクリックする。複数のフィールドをクリックして同時に選択することができます。
16. 次へ」をクリックします。
17. 次のページには［フィールド］があります。クアルトリクスにインポートされるのは、Eメールを含むケースのみです。クアルトリクスにインポートするフィールドは、先ほどと同じ方法で調整できます。
18. 次へをクリックします。
19. 最後のページには、アカウントオブジェクト (Salesforce では AccountId を介して Case オブジェクトに接続されている) に接続されたフィールドが含まれています。クアルトリクスにインポートするフィールドは、先ほどと同じ方法で調整できます。
20. 次へをクリックします。
21. Salesforceからデータを抽出した後は、データローダタスクでクアルトリクスにデータの保存先を指示する必要があります。Salesforceからメールを抽出する場合、Load Data to Conversational Analyticsタスクを使用して、メールデータプロジェクトにデータをロードします。

Salesforceからレポートデータを抽出する

ここでは、Salesforceのレポートからクアルトリクスで使用するデータを抽出する方法について説明します。

1. 新しいETLワークフローを作成する。
2. データソース（ETL抽出器）を選択します。
3. Salesforce Extractorタスクを検索します。
4. レポートを選択します。 
5. 次へをクリックします。
6. データをインポートする Salesforce アカウントを選択します。
7. 新しい Salesforce アカウントを追加する場合は、[ユーザアカウントの追加] をクリックします。
   ヒント:以前に接続したSalesforceアカウントやブランド管理者が設定したアカウントは、ここで利用できます。
   注意このタスクでは、Salesforce アカウントへの外部接続を最大 5 つまで設定できます。5つ以上の接続を追加した場合、最も古い接続が切断されます。
8. 次へをクリックします。
9. Choose report（レポートを選択）をクリックして、データをインポートするレポートを選択します。
10. インポートするプライマリ・フィールドを選択します。このフィールドはデータの重複を防ぐために使用されるため、このフィールドの値はすべて一意でなければならない。
11. フィールドの追加を開始するには、［フィールドの追加］をクリックします。
12. Select fieldドロップダウンメニューを使用して、インポートするフィールドを選択します。必要なフィールド数だけこの手順を繰り返す。
    ヒント：マッピングからフィールドを削除するには、ごみ箱アイコンをクリックします。
13. ［保存］をクリックします。

次に、ローダータスクを使ってクアルトリクスにデータを保存する必要があります。通常、これは「XM DIRECTORYに連絡先とトランザクションを追加する」タスクです。