ODBC 経由で PowerBuilder から Gumroad のデータ に接続
CData ODBC Driver for Gumroad は、ODBC をサポートするあらゆるプラットフォームや開発技術から使用できます。PowerBuilder もその一つです。この記事では、Gumroad のデータ に接続し、Database Painter や DataWindow などのコントロールからクエリを実行する方法を説明します。
Gumroad にODBC データソースとして接続
まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して、ODBC DSN を作成・設定できます。
OAuth 認証の設定
Gumroad への認証では、OAuth 2.0 標準を使って自分自身のデータに接続する場合はもちろん、他のユーザーが各自のデータに接続できるようにする場合にも利用できます。これが推奨される認証方式です。
まず、Gumroad に OAuth アプリケーションを登録する必要があります。https://app.gumroad.com/settings/advanced の Gumroad アカウント設定にアクセスし、Applications セクションに移動して OAuth アプリケーションを作成できます。
以下の接続プロパティを設定して接続を確立してください：
- AuthScheme：OAuth に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。CData API Profile for Gumroad が OAuth プロセスを自動的に進め、アクセストークンを取得します。
- OAuthClientID：アプリ設定で指定された client_id に設定します。
- OAuthClientSecret：アプリ設定で指定された client_secret に設定します。
- CallbackURL：アプリ設定で指定したリダイレクト URI に設定します。
接続文字列の例
Profile=C:\profiles\Gumroad.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
Gumroad 用 ODBC ドライバ のプロファイルを作成
以下の手順に従って、Database Painter ツールを使用し、Gumroad の ODBC DSN（データソース名）に基づいてデータベースプロファイルを作成します。Database Painter では、ウィザードや UI を使用してGumroad のデータを操作できます。
- PowerBuilder で、［ツール］ -> ［Database Painter］をクリックします。
- Database Painter の ［オブジェクト］ ウィンドウで、ODBC ノードを右クリックし、［新しいプロファイル］ をクリックします。
- ［接続］ タブで、プロファイル名を入力し、［データソース］ メニューで Gumroad DSN を選択します。
- テーブルを表示・編集するには、テーブルを右クリックして ［データの編集］ -> ［グリッド］ をクリックします。
PowerBuilder コントロールで Gumroad のデータ を使用
標準の PowerBuilder オブジェクトを使用して ODBC データソースに接続し、クエリを実行できます。以下の例では、Gumroad のデータ を DataWindow に取得する方法を示します。次のコードを open メソッドに追加してください。
SQLCA.DBMS = "ODBC"
SQLCA.DBParm = "ConnectString='DSN=CData API Source'"
CONNECT USING SQLCA;
dw_customfields.SetTransObject(SQLCA);
dw_customfields.Retrieve();