接続の設定

コネクタのインストール後、HubSpot 内のデータのデータソースに接続して作成できます。

データソースの設定

データに接続するには、次の手順を実行してください：

接続 | To a Server で詳細をクリックします。
HubSpot by CData というデータソースを選択します。
接続に必要な情報を入力します。
サインインをクリックします。
必要に応じて、データベースおよびスキーマを選択して利用可能なテーブルとビューを確認できます。

Connection Builder の使用

connector は、代表的な接続プロパティをTableau 内で直接利用できるようにします。しかし、より高度な設定が必要な場合や接続に関するトラブルシューティングが必要な場合には、使いにくいことがあります。 connector には、Tableau の外で接続を作成してテストできる、独立したConnection Builder が付属しています。

Connection Builder にアクセスする方法は2つあります。

Windows では、スタートメニューのCData Tableau Connector for HubSpot フォルダの下にあるConnection Builder というショートカットを使用します。
また、ドライバーのインストールディレクトリに移動し、lib ディレクトリで.jar ファイルを実行することによってもConnection Builder を開始できます。

Connection Builder では、接続プロパティに値を設定し、接続テストをクリックしてその動作を確認できます。また、クリップボードにコピーボタンを使用して、接続文字列をコピーすることもできます。この接続文字列は、Tableau 内のconnector 接続ウィンドウにあるConnection String オプションに指定できます。

HubSpot への認証

HubSpot データソースへの接続に使用できる認証方法は2つあります。非公開アプリトークンベースおよびOAuth 認証です。

HubspotV3 スキーマのいくつかのテーブルは、OAuth の仕組みでは動作しないかもしれません。API 制限のため、これらのスキーマはPrivateAppToken ベース認証での使用に限定されます。具体的には、データモデルセクションの各テーブルで、サポートされる認証方法を説明します。

OAuth

AuthScheme は、すべてのOAuth フローでOAuth に設定する必要があります。以下のOAuth フローは、すでに設定済みであることを前提として書かれています。

デスクトップアプリケーション

CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。代わりに、カスタムOAuth アプリケーションを作成することも可能です。カスタムアプリケーションの作成およびその理由については、カスタムOAuth アプリの作成を参照してください。

OAuth アクセストークンの取得およびリフレッシュ

以下を設定して、接続してください。

InitiateOAuth：GETANDREFRESH に設定。InitiateOAuth を使うと、OAuth 交換の繰り返しや、手動でのOAuthAccessToken 設定を避けられます。
OAuthClientId（カスタムアプリのみ）：アプリケーションの登録時に割り当てられたクライアントId に設定。
OAuthClientSecret（カスタムアプリのみ）：アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
CallbackURL（カスタムアプリのみ）：アプリケーションの登録時に定義されたリダイレクトURI に設定。

接続すると、connector はデフォルトブラウザでHubSpot のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。connector はこれでOAuth プロセスを完了します。

connector はHubSpot からアクセストークンを取得し、それを使ってデータをリクエストします。
コールバックURL からアクセストークンを取得し、リクエストを認証します。
OAuth 値をOAuthSettingsLocation で指定された場所に保存します。これらの値は接続間で永続化されます。

connector はアクセストークンの期限が切れると自動的にリフレッシュします。

非公開アプリトークン

AuthScheme プロパティをPrivateAppToken に設定し、OAuthAccessToken をアプリケーションのアクセストークンの値に設定するだけで、Hubspot 非公開アプリのトークンを使用した接続が可能です。

HubSpot 非公開アプリのトークンを生成するには次のステップを実行してください。

HubSpot アカウントで、メインナビゲーションバーにある設定アイコンをクリックします。
左のサイドバーメニューから、連携 -> 非公開アプリに移動します。
非公開アプリを作成をクリックします。
基本情報タブでアプリケーションの詳細（名前、ロゴ、説明）を設定します。
スコープタブで、非公開アプリケーションがアクセスできるようにしたい各スコープについて読み取りまたは書き込みを選択します。これは、ドライバーが取得できるデータを決定するものです。選択するスコープの推奨は、OAuthRequiredScopes およびOAuthOptionalScopes プロパティを参照してください。
アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
アプリケーションのアクセストークンの情報を確認し、作成を続行、トークンを表示の順にクリックします。
これで、取得したトークンをOAuthAccessToken プロパティに設定できます（OAuthAccessToken は非公開アプリアクセストークンとOAuth アクセストークンに使用されます）。

AuthScheme をPrivateAppToken に設定すると、この認証スキームを強制できます。

次のステップ

データビジュアライゼーションを作成するには、コネクタの使用を参照してください。

Tableau Connector for HubSpot