SAPコネクタ
重要 - 画像/情報は四半期ごとのリリースで更新されます!
四半期ごとのリリースにて、最新の機能・情報を反映し、画像を含めた情報は更新されます。
この記事は、SAPアプリケーションをCRMとして使用していて、SAP Cloud Platform Integration（CPI）ツールを使用して顧客データをGainsightアプリケーションに取り込みたいお客様を対象としています。つまり、この記事では、SAP CPIツールを使ってSAPとGainsightを統合する方法について説明します。
[概要]
統合パッケージが CPI にインストールされます。CPIを使用すると、統合フロー（iFlow）によってSAPからGainsightにデータを転送できます。統合パッケージがCPIにインポートされたら、SAPシステムの認証情報を追加し、ソースSAP接続の詳細を更新し、GainsightのAPIアクセスキーをiFlowに追加して、SAPからGainsightにデータを取得することを検証できます。
Gainsightでは、検証が成功した後にのみレコードがオブジェクトに挿入または更新されます。いずれかのレコードの検証が失敗した場合、対応する API 呼び出しが対応する検証エラーで応答します。SAPレコードを挿入または更新できるGainsightのオブジェクトのリストは次のとおりです。
- 個人
- 関係パーソン
- カンパニー担当者
- カンパニー
- カスタムオブジェクト
次の図は、iFlowを介してSAP C4CとGainsightの間でデータを転送するための大まかな手順を示しています。
- SAP OData API は SAP C4C からデータを取得し、CPI にプッシュします。
- GainsightのREST APIはCPIからデータを引き出し、それをGainsightへプッシュします。
キーワード
- インテグレーションフロー (iFlow): iFlow は SAP からGainsightへデータを取得するジョブです。
- SAP クラウドプラットフォーム統合 (CPI): SAP CPIでは、iFlowを通じてSAPからGainsightへのデータ転送が可能になります。
- OData (オープンデータプロトコル) API: OData は、RESTful API の構築と利用に関するベストプラクティスを定義する OASIS 標準です。OData API を使用して、SAP Cloud for Customer 内のデータのクエリ、読み取り、追加、更新、削除を行うことができます。詳細については、ここをクリックしてください。
- SAP クラウドコネクタ: SAP Cloud Platform のオンデマンドアプリケーションを既存のオンプレミスシステムに接続する SAP コネクタです。
前提条件
SAP C4CとGainsightの統合には以下が必要です。
- 有料の CPI ライセンス。(必須)
- 接続したい SAP 製品を特定してください。
- SAP システム内のエンティティ (特定のデータセット) の OData API アクセスを有効にします。
- SAPソースシステムがSAP C4C以外のものである場合、Gainsightは統合が可能かどうかを評価する必要があります。
オンプレミスシステムの場合は、CPI とオンプレミスシステム間のリンクとして機能する SAP Cloud Connector を使用してください。詳細については、「クラウド統合」を参照してください。
インテグレーションステップ
SAP C4CをGainsightと統合するには、次の大まかな手順に従ってください。
- CPI に統合パッケージをインストール
- CPI に SAP C4C システムの認証情報を追加します
- インストールされている統合パッケージの SAP C4C システム接続ダイヤルの更新
- インストールされている統合パッケージの Gainsightアクセスキーを更新
- (オプション) 新しい Gainsight フィールドを追加し、iFlow の SAP C4C フィールドにマッピングします
Gainsight統合パッケージをCPIにインストール
Gainsightは統合パッケージを含むzipファイルを提供しています。お客様は CPI インスタンスにログインし、zip ファイルをインポートする必要があります。
zip ファイルをインポートするには:
- CPI インスタンスにログインします。
- 左側のナビゲーションペインで [デザイン] をクリックします。
- [インポート] をクリックします。ローカルマシンのフォルダウィンドウが開きます。
- 必要な zip ファイルを参照して選択します。
- [開く] をクリックして zip ファイルをインポートします。
CPI に SAP C4C システムの認証情報を追加します
「セキュア・マテリアルの管理」ページから特定の SAP システムに接続するには、SAP 認証情報を CPI に追加する必要があります。
SAP C4C 認証情報を追加するには:
- [監視] > [概要] > [セキュリティ資料の管理] に移動します。
- [追加] をクリックし、[ユーザー認証情報] を選択します。「ユーザー認証情報の追加」ダイアログが表示されます。ユーザー資格情報は、認証タイプフィールドで自動的に選択されます。
- [名前] と [説明] を入力します。
メモ: 認証情報名は、各 iFlow に接続の詳細を追加するために使用されます。ここに入力した認証情報名を書き留めておきます。 - 「ユーザー」フィールドにユーザー名を入力します。
- パスワードを入力し、パスワードを再入力してください。
- 「デプロイ」をクリックします。
インストールされているGainsight統合パッケージのSAP C4Cシステム接続の詳細を更新
インストールされた統合パッケージは、複数の CPI iFlow または FALLOWS で構成されています。エンティティ（特定の種類のデータ）ごとに、SAP C4CからGainsightにデータを引き出すiFlowが1つあります。各 iFlow で、SAP C4C システムの接続詳細を更新する必要があります。
各 iFlow の OData ページに接続の詳細を追加するには:
- 左側のナビゲーションペインで [デザイン] をクリックします。
- インストールされている Gainsight統合パッケージをクリックします。
- 「アーティファクト」タブをクリックします。
- iFlow をクリックします。選択した iFlow が表示されます。
- iFlow の「OData」をクリックします。
- [接続] タブをクリックします。
- [編集] をクリックします。
- アドレスフィールドに、Gainsightにデータを取得する特定のSAP C4CインスタンスのURLを入力します。
メモ: デフォルトでは、[プロキシタイプ] と [認証] はそれぞれ [インターネット] と [基本] として選択されています。 - 「CPI の SAP システムへの認証情報の追加」セクションで追加またはメモした認証情報名を入力します。
メモ: 各 iFlow には、要件に応じて異なる認証情報が必要です。 - 「保存」をクリックします。
インストールされている統合パッケージの Gainsightアクセスキーを更新
この接続用の Gainsight Connectors 2.0 ページから生成された Gainsight アクセスキーを使用して、各 iFlow を更新する必要があります。CPIからのデータがロードされる特定のGainsightインスタンスを認証および識別するために使用されます。Gainsightでアクセスキーを生成する方法の詳細については、「APIアクセスキーを生成」の記事を参照してください。
Gainsightアクセスキーを iFlow に追加するには:
- デザイン>に移動し、インストールされているGainsight統合パッケージをクリックします。
- 「アーティファクト」タブに移動します。
- 必要な iFlow をクリックします。
- iFlow の [コンテンツ修飾子] をクリックし、[メッセージヘッダー] タブをクリックします。
- [編集] をクリックします。
- [追加] をクリックし、[アクセス キーの値] フィールドに Gainsight アクセス キーを入力します。
- 「保存」をクリックします。
(オプション) 新しい Gainsight フィールドを追加し、iFlow の SAP フィールドにマッピングします
Gainsightは、SAP C4CとGainsight間の必要なマッピングを含むアウトオブボックス（OOB）iFlowを提供します。SAP C4Cで新しいカスタムフィールドを作成する場合は、これらのフィールドをGainsightのターゲットフィールドにマッピングする必要があります。
すべての SAP フィールドは CPI に自動的に追加されます。新しいGainsightフィールド（ターゲット）を追加する場合は、手動でCPIに追加し、それぞれの SAP フィールド（ソース）にマッピングする必要があります。
新しい Gainsight フィールドを追加するには:
- デザイン>に移動し、インストールされているGainsight統合パッケージをクリックします。
- 「アーティファクト」タブをクリックします。
- 必要な iFlow をクリックします。
- iFlow の [メッセージマッピング] をクリックし、[処理] タブに移動します。
- [編集] をクリックします。
- 「リソース」フィールドの「/MessageMapping.mmap」をクリックします。「メッセージマッピング」ページが表示されます。
次の画像は、データを正確に流すために相互にマッピングする必要がある SAP フィールド (ソースフィールド) と Gainsight フィールド (ターゲットフィールド) を示しています。
- ターゲットフィールド行の「アクション」アイコンをクリックし、「変数を追加」を選択します。
- Gainsight フィールドの名前を入力します。必ずGainsightから正しいフィールドラベルを追加してください。
- 「作成」をクリックして、新しい Gainsight フィールドを iFlow に追加します。
New Gainsight フィールドを SAP フィールドにマップするには:
- ソースの SAP フィールドをターゲットの Gainsight フィールドにドラッグして、フィールドマッピングを更新します。
- OK をクリックしてマッピングを保存します。
- 「保存してデプロイ」をクリックします。
新しい iFlow を作成する
既存の iFlow をコピーし、新しく作成した iFlow に必要な変更を加えることで、新しい iFlow を作成できます。
新しい iFlow を作成するには:
- デザイン>に移動し、インストールされているGainsight統合パッケージをクリックします。
- 「アーティファクト」タブをクリックします。
- iFlow の [アクション] アイコンをクリックし、[コピー] を選択します。
- 名前を入力して [パッケージ] を選択します。
- 「コピー」をクリックして新しい iFlow を作成します。
新しく作成したiFlowを要件に応じて変更できます。変更するには、次のセクションを参照してください。
- CPI に SAP C4C システムの認証情報を追加します
- インストールされた統合パッケージの SAP C4C システム接続詳細の更新
- 新しい Gainsight フィールドを追加して iFlow の SAP フィールドにマッピングする
iFlow にGainsightオブジェクトを追加する
iFlow に Gainsight オブジェクトを追加するには:
- 左側のナビゲーションペインで [デザイン] をクリックします。
- インストールされている Gainsight統合パッケージをクリックします。
- 「アーティファクト」タブをクリックします。
- 必要な iFlow をクリックします。選択した iFlow が表示されます。
- 返信リクエストとGainsightの間にあるコネクタ矢印を見つけてクリックします。
- [接続] タブをクリックします。
- [編集] をクリックします。
- URL の末尾にあるオブジェクト名を置き換えます。たとえば、iflow にカスタムオブジェクトを追加するには、既存のオブジェクト名を URL のカスタムオブジェクト名に置き換えます。
メモ: iFlow に追加する新しい Gainsight オブジェクトの名前を覚えておいてください。 - 「デプロイ」をクリックします。
- [はい] をクリックして変更を確定します。