接続の確立
JDBC データソースの作成
Java アプリケーションから接続するJDBC データソースを作成できます。CData JDBC Driver for Square に基づくJDBC データソースの作成は、3つの基本ステップで構成されます。
- ドライバーのJAR ファイルをクラスパスに追加します。JAR ファイルはインストールディレクトリの［lib］サブフォルダ内にあります。.lic ファイルはJAR ファイルと同じフォルダ内に配置される必要があることに注意してください。
- ドライバークラスを入力します。次に例を示します。
cdata.jdbc.square.SquareDriver
- JDBC URL を入力します。次に例を示します。
jdbc:square:InitiateOAuth=GETANDREFRESH;OAuthClientId=MyApplicationId;OAuthClientSecret=MyApplicationSecret;CallbackURL=http://localhost:33333;LocationId=MyDefaultLocation or jdbc:cdata:square:InitiateOAuth=GETANDREFRESH;OAuthClientId=MyApplicationId;OAuthClientSecret=MyApplicationSecret;CallbackURL=http://localhost:33333;LocationId=MyDefaultLocation
上記の2つ目の形式は、同じURL 形式を使用しているドライバー間でアプリケーションに競合がある場合は、CData ドライバーを使用していることを確認するために常に使用できます。URL は "jdbc:square:" または"jdbc:cdata:square:" のいずれかから始まり、任意の接続プロパティの名前と値のペアをセミコロン区切りで入力します。
Square への接続
LocationId プロパティを設定して、デフォルトのビジネスロケーションを指定します。あるいは、クエリの検索条件にLocationId を設定します。
Id を取得するには、認証後にLocations テーブルをクエリします。
Square への認証
パーソナルアクセストークンを使用してSquare への認証を行うか、OAuth 標準を使用できます。パーソナルトークンを使用して、自分のデータにアクセスしたりサンドボックスを介してテストしたりします。OAuth を使って、他のユーザーが自身のデータにアクセスできるようにします。パーソナルアクセストークン
OAuthAccessToken 接続プロパティをパーソナルトークンに設定します。これは、以下の手順に従って取得できます。
- Developer Dashboard に移動して作成ガイドのOAuth アプリの作成 を参照してください。
- アプリが作成されると、トークンは［Credentials］タブにリストされます。
Square サンドボックス
Connect API のバージョン2では、サンドボックス環境でのテストが可能です。サンドボックスで作成されたトランザクションは、カードネットワークには送信されず、カードに課金されることはありません。
サンドボックスに接続するには、OAuthAccessToken をサンドボックスのアクセストークンに設定します。これは、標準のパーソナルアクセストークンと一緒に使用できます。
- Developer Dashboard に移動して作成ガイドのOAuth アプリの作成 を参照してください。
- アプリが作成されると、サンドボックストークンは［Credentials］タブにリストされます。
OAuthAccessToken に加えて、Schema を"V2"、UseSandbox を"True" に設定します。
OAuth
OAuth では、認証ユーザーがブラウザを使用してSquare と対話する必要があります。認証についてはSquare への接続 を参照してください。 ユーザー資格情報の接続プロパティを設定せずに接続できます。InitiateOAuth をGETANDREFRESH に設定すると接続できます。接続すると、本製品 はデフォルトブラウザでSquare OAuth エンドポイントを開きます。ログインして、本製品 にアクセス許可を与えます。 本製品 がOAuth プロセスを完了します。
- CallbackURL からアクセストークンを取得し、リクエストを認証します。
- アクセストークンの期限が切れたときにはリフレッシュしてください。
- OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。
Note：本製品 はすでにSquare にOAuth アプリケーションとして登録されており、埋め込みのOAuthClientId およびOAuthClientSecret を自動的に使用して接続します。独自のカスタムOAuth アプリを使用したい場合は、OAuth アプリの作成 を参照してこれらの接続プロパティを取得してください。 このOAuth フローでは、ユーザー資格情報の接続プロパティを設定せずに認証できます。［接続］をクリックすると本製品 がSquare OAuth エンドポイントを開きます。ログインして、本製品 にアクセス許可を与えます。本製品 がOAuth プロセスを完了します。