Lightning Connect で HubDB External オブジェクトと連携

CData Connect Server をつかって、HubDB のデータ の仮想SQL Server として接続し、スマートデバイスやクラウドアプリケーションで利用。Connect Server と Salesforce Lightning Connect を使ってHubDB オブジェクトを作成して、アプリケーションやダッシュボードでデータを使用。

加藤龍彦
デジタルマーケティング

最終更新日:2022-11-25

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData Connect Server を使ってSalesforce コンソールやSalesforce Mobile App からHubDB のデータ に接続することができます。 この記事では、CData Connect Server およびSalesforce Lightning Connect をつかって、HubDB 外部オブジェクトを作成します。

CData Connect Server は、ピュアSQL のクラウドインターフェースをHubDB に提供し、データを複製せずにSalesforce Lightning Connect からリアルタイムHubDB のデータとの統合を手軽に実現します。Salesforce Lightning Connect はCData Connect Server をSQL Server データベースとして認識し、最適化されたデータ処理を使用してサポートされているすべてのSQL 操作(フィルタ、JOIN など)をHubDB に直接プッシュして、サーバー側の処理を利用して、HubDB のデータを素早く返します。

  1. Connect Server にログインし、[DATA MODEL]をクリックします。 データベースを追加
  2. [Available Data Sources]から[HubDB]を選択します。
  3. 必要な認証プロパティを入力し、HubDB に接続します。

    HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。

    カスタムOAuthアプリを使用する

    すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ(デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン)に必要な接続プロパティについては、ヘルプドキュメントを確認してください。

    アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。

    1. HubSpotアプリ開発者アカウントにログインします。
      • アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
    2. 開発者アカウントのホームページで、アプリタブをクリックします。
    3. アプリを作成をクリックします。
    4. アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
    5. 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
      • デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
      • Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
    6. アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
    7. 認証タブで、クライアントIDクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。
    8. スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。

      テーブルにアクセスするには、最低限以下のスコープが必要です:

      • hubdb
      • oauth
      • crm.objects.owners.read
    9. 変更を保存をクリックします。
    10. 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
      • 「インストールURL(OAuth)」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
      • コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
      • アプリを接続をクリックします。結果のタブは閉じて構いません。

    プライベートアプリを使用する

    HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。

    以下の手順に従ってプライベートアプリケーショントークンを生成できます:

    1. HubDBアカウントで、メインナビゲーションバーの設定アイコン(歯車)をクリックします。
    2. 左サイドバーメニューで、統合 > プライベートアプリに移動します。
    3. プライベートアプリを作成をクリックします。
    4. 基本情報タブで、アプリケーションの詳細(名前、ロゴ、説明)を設定します。
    5. スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
    6. テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
    7. アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
    8. アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
    9. コピーをクリックして、プライベートアプリケーショントークンをコピーします。

    接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。

    接続の設定
  4. Create & Test をクリックします。
  5. Edit HubDB Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。 権限を更新
  6. USERS タブでAuthToken を取得します。

コネクションが構成されたら、Salesforce Lightning Connect からHubDB に接続できるようになります。

HubDB データ にOData データソースとして接続

次の手順で、Connect Server からのフィードに接続する設定を行います。

  1. セールスフォースにログインして、[設定]→[開発]→[外部データソース]をクリックします。
  2. [新規外部データソース]をクリックします。
  3. 以下のプロパティにデータを入力します。:
    • 外部データソース: リストビューやレポートで使われるラベル名を入力。
    • 名前: ユニークな識別子を入力。
    • 種別: SQL Server を選択。
  4. 認証には、次のプロパティを設定します:
    • 認証プロトコル: パスワード認証を選択します。OAuth 2.0 も選択可能です。
    • Certificate: Enter or browse to the certificate to be used to encrypt and authenticate communications from Salesforce to your server.
    • 管理者ユーザ名: Connect Server で設定したユーザー名を入力。
    • 管理者パスワード: ユーザーのauth トークンを入力。
Configuration settings for the data source. (NetSuite is shown.)

HubDB データ と同期したオブジェクトの作成

外部データソース作成後、次の手順で HubDB のデータを反映する外部オブジェクトを作成します。 HubDB 外部オブジェクトとHubDB テーブルの定義を同期する必要があります。

  1. 作成した外部データソースを選択します。
  2. [検証して同期]をクリックします。
  3. HubDB テーブルをクリックして、外部オブジェクトとします。
The list of tables to synchronize in Salesforce. (NetSuite is shown.)

Salesforce オブジェクトとして HubDB データ にアクセス

HubDB のデータ を外部データソースとして追加し、HubDB テーブルをHubDB 外部データソースとして同期すると、標準のSalesforce オブジェクトとして外部オブジェクトを使用することができます。

  • フィルターリストビュー付で新しいタブを作成する:

    A filtered list view shown on a custom tab. (NetSuite Invoices are shown.)
  • 標準Salesforce オブジェクトと並べて HubDB 外部オブジェクトをディスプレイできます:

    A related list that shows an indirect lookup relationship, which links a child external object to a parent standard object. (Salesforce accounts and associated NetSuite invoices are shown.)

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。