Node.js からSage X3 Cloud のデータをSQL Server データベースとしてクエリ

CData Connect AI を使用すると、SQL Server インターフェース経由でSage X3 Cloud のデータをクエリできます。以下のステップに従って、Connect AI にSage X3 Cloud の仮想データベースを作成し、Node.js を使用してクエリを実行します。

CData Connect AI は、Sage X3 Cloud のピュアMySQL かつクラウドベースのインターフェースを提供し、ネイティブにサポートされているデータベースにデータを複製することなくNode.js からの手軽なリアルタイムSage X3 Cloud のデータクエリを実現します。Node.js でデータをクエリすると、CData Connect AI はサポートされているすべてのSQL 操作（フィルタ、JOIN など）を直接Sage X3 Cloud にプッシュし、サーバー側の処理を活用してSage X3 Cloud のデータを高速で返します。

Connect AI からSage X3 Cloud に接続する

1. Connect AI にログインし、 Add Connection をクリックします。
2. Add Connection パネルから「Sage X3 Cloud」を選択します。
3. 必要な認証情報を入力し、Sage X3 Cloud に接続します。

   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（デフォルト）に設定しておけば、トークンの取得と更新は自動で行われます。

   
4. Create & Test をクリックします。
5. Edit Sage X3 Cloud Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

パーソナルアクセストークンを追加する

OAuth 認証をサポートしないサービス、アプリケーション、プラットフォーム、フレームワークから接続する場合、パーソナルアクセストークン（PAT）を認証に使用できます。きめ細かくアクセスを管理するために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
2. PAT の名前を入力して Create をクリックします。
3. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

接続が設定されたら、Node.js からSage X3 Cloud のデータに接続できるようになります。

Node.js からSage X3 Cloud をクエリ

以下の例は、SQL Server モジュールを使用してSage X3 Cloud へのクエリを実行する方法を説明しています。以下の情報が必要です。

• server：tds.cdata.com
• port：14333
• user：Connect AI ユーザー（例：[email protected]）
• password：上記のユーザーのPAT
• database：Sage X3 Cloud 用に構成した接続（SageX3Cloud1）

以下のコードで、Sage X3 Cloud に接続してクエリが実行できます。

var sql = require('mssql')
var config = {
	server: 'tds.cdata.com',
	port:14333,
	user: '[email protected]', //update me
	password:'CONNECT_USER_PAT', //update me
	options: {
		encrypt: true,
		database: 'SageX3Cloud1'
	}
}

sql.connect(config, err => {
    if(err){
        throw err ;
    }
    new sql.Request().query('SELECT * FROM BPCUSTOMER', (err, result) => {
        console.dir(result)
    })

});

sql.on('error', err => {
    console.log("SQL Error: " ,err);
})