ODBC 経由で PowerBuilder から Sage X3 Cloud のデータ に接続

CData ODBC Driver for Sage X3 Cloud は、ODBC をサポートするあらゆるプラットフォームや開発技術から使用できます。PowerBuilder もその一つです。この記事では、Sage X3 Cloud のデータ に接続し、Database Painter や DataWindow などのコントロールからクエリを実行する方法を説明します。

Sage X3 Cloud にODBC データソースとして接続

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して、ODBC DSN を作成・設定できます。

Sage X3 Cloud では OAuth 2.0 の Client Credentials フローを使用し、API へのアクセスには X-API-Key も必要です。AuthScheme を OAuth に設定し、以下の接続プロパティを指定します。

• URL：Sage X3 Cloud インスタンスのベース URL。
• OAuthAccessTokenUrl：OAuth トークンエンドポイント（例：https://your-auth-domain/oauth/token）。
• OAuthClientId：OAuth アプリケーションのクライアント ID。
• OAuthClientSecret：OAuth アプリケーションのクライアントシークレット。
• Audience：トークンリクエストで使用する API の Audience 値。
• XAPIKey：Sage X3 Cloud の管理者から提供された X-API-Key。
• Folder：Sage X3 のフォルダ名（例：SEED）。このフォルダがデフォルトのスキーマとして使用されます。
• Folders（オプション）：Sage X3 フォルダのカンマ区切りリスト（例：SEED,PERF）。各フォルダが個別のスキーマとして公開されるため、Schema.Table 構文でフォルダをまたいだクエリを実行できます。

ドライバーは Client Credentials フローでアクセストークンを取得し、すべての API リクエストで X-API-Key とあわせて送信します。InitiateOAuth を GETANDREFRESH（デフォルト）に設定しておけば、トークンの取得と更新は自動で行われます。

Sage X3 Cloud 用 ODBC ドライバ のプロファイルを作成

以下の手順に従って、Database Painter ツールを使用し、Sage X3 Cloud の ODBC DSN（データソース名）に基づいてデータベースプロファイルを作成します。Database Painter では、ウィザードや UI を使用してSage X3 Cloud のデータを操作できます。

1. PowerBuilder で、［ツール］ -> ［Database Painter］をクリックします。
2. Database Painter の ［オブジェクト］ ウィンドウで、ODBC ノードを右クリックし、［新しいプロファイル］ をクリックします。
3. ［接続］ タブで、プロファイル名を入力し、［データソース］ メニューで Sage X3 Cloud DSN を選択します。
4. テーブルを表示・編集するには、テーブルを右クリックして ［データの編集］ -> ［グリッド］ をクリックします。

PowerBuilder コントロールで Sage X3 Cloud のデータ を使用

標準の PowerBuilder オブジェクトを使用して ODBC データソースに接続し、クエリを実行できます。以下の例では、Sage X3 Cloud のデータ を DataWindow に取得する方法を示します。次のコードを open メソッドに追加してください。

SQLCA.DBMS = "ODBC"
SQLCA.DBParm = "ConnectString='DSN=CData SageX3Cloud Source'"
CONNECT USING SQLCA;
dw_bpcustomer.SetTransObject(SQLCA);
dw_bpcustomer.Retrieve();