接続の設定
コネクタのインストール 後、eBay 内のデータのデータソースに接続して作成できます。
データソースの設定
データに接続するには、次の手順を実行してください:
- 接続 | To a Server で詳細をクリックします。
- eBay by CData というデータソースを選択します。
- 接続に必要な情報を入力します。
- サインインをクリックします。
- 必要に応じて、データベースおよびスキーマを選択して利用可能なテーブルとビューを確認できます。
Connection Builder の使用
connector は、代表的な接続プロパティをTableau 内で直接利用できるようにします。 しかし、より高度な設定が必要な場合や接続に関するトラブルシューティングが必要な場合には、使いにくいことがあります。 connector には、Tableau の外で接続を作成してテストできる、独立したConnection Builder が付属しています。
Connection Builder にアクセスする方法は2つあります。
- Windows では、スタートメニューのCData Tableau Connector for eBay フォルダの下にあるConnection Builder というショートカットを使用します。
- また、ドライバーのインストールディレクトリに移動し、lib ディレクトリで.jar ファイルを実行することによってもConnection Builder を開始できます。
Connection Builder では、接続プロパティに値を設定し、接続テストをクリックしてその動作を確認できます。 また、クリップボードにコピーボタンを使用して、接続文字列をコピーすることもできます。 この接続文字列は、Tableau 内のconnector 接続ウィンドウにあるConnection String オプションに指定できます。
eBay API への接続
eBay に接続するには以下を設定します。
- SiteID:eBay サイトID に設定。デフォルト値は"0"(U.S. のサイト)です。
- UseSandbox:eBay sandbox アカウントを使用する場合True に設定。デフォルトでは、connector は本番環境に接続します。
- RuName:サインインに使用するRuName(eBay Redirect URL 名)に設定。eBay のサインイン設定で検索します。
eBay への認証
connector は、OAuth 2.0 認証規格またはeBay APIで使用されている従来の認証方法であるAuth'n'Auth のいずれかを使用して、eBay を認証できます。
ユーザーアカウント(OAuth)
AuthScheme をOAuth に設定。
デスクトップアプリケーション
カスタムOAuth アプリケーションを作成する必要があります。カスタムアプリケーションの作成については、カスタムOAuth アプリの作成 を参照してください。OAuth アクセストークンの取得およびリフレッシュ
以下を設定して、接続してください。
- InitiateOAuth:GETANDREFRESH に設定。InitiateOAuth を使うと、OAuth 交換の繰り返しや、手動でのOAuthAccessToken 設定を避けられます。
- OAuthClientId:キーセットのApp ID(Client ID)に設定。
- OAuthClientSecret:キーセットのCert ID(Client Secret))に設定。
- CallbackURL:connector を実行しているデバイスのサーバー名とポートを含むURL に設定。localhost のアドレスはどれでも使用可能です。デフォルトのコールバックURL はhttp://localhost:33333 です。
- connector はeBay からアクセストークンを取得し、それを使ってデータをリクエストします。
- OAuth 値はOAuthSettingsLocation で指定された場所に保存され、接続間で永続化されるようにします。
レガシーアプリのユーザーアカウント(Auth'n'Auth)
connector は、eBay のレガシーAuth'n Auth プロトコルを使用して認証することができます。Auth'n'Auth を使用するように構築された古いアプリケーションを使用している場合は、この認証スキームを選択します。
AuthScheme をAuthNAuth に設定します。
カスタムOAuth アプリケーションを作成する必要があります。詳しくは、カスタムOAuth アプリの作成 を参照してください。
アクセストークン
OAuthAccessToken はAuth'n'Auth で認証する場合に必要となります。次の接続プロパティを設定し、OAuthAccessToken を取得します。
- OAuthClientId:キーセットのApp ID(Client ID)に設定。
- OAuthClientSecret:キーセットのCert ID(Client Secret))に設定。
- DevID:キーセットのDeveloper ID に設定。
続いてストアドプロシージャを呼び出し、トークンの交換を完了します。
-
GetOAuthAuthorizationURL ストアドプロシージャを呼び出します。RuName インプットをアプリ設定で指定したeBay Redirect URL に設定します。ストアドプロシージャがOAuth エンドポイントのURL を返します。
- ステップ1でストアドプロシージャが返したURL に移動します。ログインして、Web アプリケーションを認可します。認証後、ブラウザはリダイレクトURI にリダイレクトします。リダイレクトURI にはsessionid というパラメータが付加されます。このパラメータの値を控えておきます。推奨値https://oauth.cdata.com/oauth/ を"auth accepted URL" として使用する場合、この値はBASE64 エンコードされているため、デコードしてから次に進む必要があります。
- GetOAuthAccessToken ストアドプロシージャを呼び出します。AuthMode インプットをWEB に設定します。SessionId インプットパラメータを、認可URL のクエリ文字列の'sessionid' 値、またはCallback URL からBASE64 デコードしたセッションID に設定します。
次の接続プロパティを設定し、データに接続します。
- OAuthClientId:キーセットのApp ID(Client ID)に設定。
- OAuthClientSecret:キーセットのCert ID(Client Secret))に設定。
- OAuthAccessToken:GetOAuthAccessToken によって返されたAuth'n'Auth トークンに設定。
Note: Auth'n'Auth トークンは18ヶ月後に失効します。トークンの期限が切れたら、新しいトークンを発行する必要があります。
- DevID:キーセットのDeveloper ID に設定。
次のステップ
データビジュアライゼーションを作成するには、コネクタの使用 を参照してください。