第3章 Salesforce to database サンプルインテグレーションの実装

このサンプルインテグレーションは Salesforce の更新を取得し、データベースストアドプロシージャーを呼び出します。これにより、そのデータベースと Salesforce の更新を同期します。

前提条件

  • 開発に使用される Salesforce インストールでアカウントが必要になります。このアカウントは Salesforce API にアクセスできる必要があります。Salesforce Enterprise アカウントまたは Salesforce Developer アカウントは Salesforce API にアクセスできます。無料の開発者アカウントを取得するには、https://developer.salesforce.com/signup にアクさきほどセスしてください。Salesforce アカウントの取得には最大 2 分かかります。

    Twitter to Salesforce サンプルインテグレーションをすでに作成している場合は、次に該当します。

    • Fuse Online がすでに Salesforce クライアントとして登録されています。これをもう一度実行する必要はありません。
    • このサンプルインテグレーションで再利用できる Salesforce コネクションがあります。

    Twitter to Salesforce サンプルインテグレーションを作成していない場合は、Fuse Online を Salesforce クライアントとして登録し、Salesforce to database サンプルインテグレーションを完了するために Salesforce コネクションを作成する必要があります。

  • Fuse Online 環境にログインしている必要があります。
  • 管理者が Fuse Online サンプルデータを追加した OpenShift Container Platform プロジェクトで実行されている Fuse Online 環境で作業しています。この環境では、インテグレーションが想定どおり動作することを確認するための PostgresDB 接続および To Do アプリケーションが提供されます。

このサンプルインテグレーションを実装、デプロイ、およびテストするための主なステップは次のとおりです。

  1. 「Fuse Online を Salesforce クライアントアプリケーションとして登録」
  2. 「Salesforce コネクションの作成」
  3. 「Salesforce to database サンプルインテグレーションの作成およびデプロイ」
  4. 「Salesforce to database インテグレーションの動作の確認」
  5. 「インテグレーションのクリーンアップ」

3.1. Fuse Online を Salesforce クライアントアプリケーションとして登録

インテグレーションで Salesforce に接続するには、最初に Fuse Online 環境を Salesforce にアクセスできるクライアントアプリケーションとして登録する必要があります。これにより、Salesforce に接続するインテグレーションをいくつでも作成することができます。そのため、特定の Fuse Online 環境を 1 度だけ Salesforce に登録する必要があります。

Fuse Online を Salesforce クライアントアプリケーションとして登録できるのは、Fuse Online 環境ごとに 1 回のみです。ただし、各 Salesforce コネクションは同じ登録を使用しますが、異なるユーザー認証情報を使用することができます。

すでに Fuse Online を Salesforce クライアントとして登録し、Salesforce コネクションを作成している場合は、Salesforce to database インテグレーションの作成およびデプロイ に進みます。

前提条件

Fuse Online にログインしている必要があります。

手順

  1. Fuse Online で以下を行います。

    1. 左側のパネルで Settings をクリックします。
    2. Settings ページで、上部付近にあるコールバック URL の右側で Copy Callback URL をクリックし、Fuse Online 環境のコールバック URL をクリップボードにコピーします。この手順の最後の方でこの URL が必要になります。
    3. Salesforce エントリーをクリックして Client ID および Client Secret フィールドを表示します。

  2. 別のブラウザータブで、Salesforce アカウントにログインし、以下の手順にしたがって接続アプリケーションを作成します。これらの手順では、Salesforce Classic ユーザーインターフェイスを使用していることを仮定します。Salesforce Lighting Experience インターフェイスから切り替えるには、プロファイルアイコンをクリックして Switch to Salesforce Classic を選択します。追加情報は、Salesforce ドキュメントの Create a Connected App を参照してください。

    1. Salesforce で右上にある Setup をクリックします。
    2. 左側のパネルで Build > Create > Apps と選択します。
    3. Connected Apps まで下にスクロールし、New をクリックします。
    4. 必要な情報を入力し、Enable OAuth Settings を選択します。
    5. Callback URL フィールドに、この手順の最初にコピーした Fuse Online URL を貼り付けます。たとえば、https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback などです。

    6. OAuth Scopes では以下を追加します。

      • Access and manage your data (api)
      • Allow access to your unique identifier (openid)
      • Perform requests on your behalf at any time (refresh_token, offline_accesss)
    7. Configure ID token を選択し Include Standard Claims を選択します。
    8. 下にスクロールし、Save をクリックします。
    9. 上にスクロールし、Salesforce が短い待機時間を示していることを確認します。 SF message to wait a few minutes
    10. Continue をクリックします。
    11. Salesforce が提供するコンシューマー鍵をコピーします。
  3. Fuse Online の Settings ページに戻り、Salesforce が提供したコンシューマー鍵を Fuse Online の Salesforce Client ID フィールドに貼り付けます。
  4. Salesforce に戻り、Salesforce が提供するコンシューマーの秘密をコピーします。
  5. Fuse Online の Settings ページに戻り、Salesforce が提供したコンシューマーの秘密を Fuse Online の Salesforce Client Secret フィールドに貼り付けます。
  6. Save をクリックします。
  7. Salesforce エントリーをクリックして折りたたみます。