接続の確立
JDBC データソースの作成
Java アプリケーションから接続するJDBC データソースを作成できます。CData JDBC Driver for Adobe Target に基づくJDBC データソースの作成は、3つの基本ステップで構成されます。
- ドライバーのJAR ファイルをクラスパスに追加します。JAR ファイルはインストールディレクトリの[lib]サブフォルダ内にあります。.lic ファイルはJAR ファイルと同じフォルダ内に配置される必要があることに注意してください。
- ドライバークラスを入力します。次に例を示します。
cdata.jdbc.adobetarget.AdobeTargetDriver
- JDBC URL を入力します。次に例を示します。
jdbc:adobetarget:OAuthClientId=myOauthClientId;OauthClientSecret=myOAuthClientSecret;CallbackURL=myCallbackURL; or jdbc:cdata:adobetarget:OAuthClientId=myOauthClientId;OauthClientSecret=myOAuthClientSecret;CallbackURL=myCallbackURL;
上記の2つ目の形式は、同じURL 形式を使用しているドライバー間でアプリケーションに競合がある場合は、CData ドライバーを使用していることを確認するために常に使用できます。URL は "jdbc:adobetarget:" または"jdbc:cdata:adobetarget:" のいずれかから始まり、任意の接続プロパティの名前と値のペアをセミコロン区切りで入力します。
Adobe Target への接続
Adobe Target に接続するには、Tenant プロパティと以下に示す必要な認証パラメータを指定する必要があります。他の接続プロパティは処理の挙動に影響を与えますが、 接続機能には影響しないことに注意してください。
Tenant 名を決定するには:
- Adobe Experience にログインします。URL は次のようなものになります:"https://experience.adobe.com/#/@mycompanyname/preferences/general-section"。
- "/#/@" の後ろの値を抽出します。この例では、"mycompanyname" です。
- Tenant 接続プロパティをこの値に設定します。
Adobe Target への認証
Adobe Target はOAuth 認証標準を利用しています。OAuth(Server-to-Server)統合を使用して認証できます。
ユーザーアカウント(OAuth)
すべてのユーザーアカウントフローでAuthScheme をOAuthClient に設定する必要があります。
Note:OAuth 経由のAdobe 認証では、2週間ごとにトークンを更新する必要があります。
すべてのアプリケーション
CData は、OAuth 認証を簡略化する埋め込みOAuth アプリケーションを提供します。代わりに、カスタムOAuth アプリケーションを作成することも可能です。詳しくはカスタムOAuth アプリの作成 を参照してください。OAuth アクセストークンの取得
接続するには次のプロパティを設定します。
- InitiateOAuth:GETANDREFRESH に設定すると、OAuth 交換が自動で実行され、必要に応じてOAuthAccessToken が更新されます。
- OAuthClientId:アプリの登録時に割り当てられたクライアントId に設定。
- OAuthClientSecret:アプリの登録時に割り当てられたクライアントシークレットに設定。
- CallbackURL:アプリの登録時に定義されたリダイレクトURI に設定。例: https://localhost:3333
以上の設定により、プロバイダーはAdobe Target からアクセストークンを取得し、それを使ってデータをリクエストします。 OAuth 値はOAuthSettingsLocation で指定された場所に保存され、接続間で永続化されるようにします。