ODBC を介してNode.js からADP データをクエリ

Node.js はブラウザ上以外でJavaScript コードを使用できるJavaScript ランタイム環境です。CData ODBC Driver for ADP を使用すれば、Node.js アプリとスクリプトから、ライブADP データにアクセスできます。この記事ではnode-odbc のインストールと、ライブADP データへのアクセスが可能な、シンプルなNode.js アプリケーションを作成するために必要なツールについて説明します。

ビルトインの最適化されたデータ処理により、CData ODBC Driver は比類のないパフォーマンスで、Node.js のライブADP データとやりとりできます。Node.js からADP に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をADP に直接プッシュし、組み込まれたSQL エンジンを利用してサポートされていない操作（主にSQL 関数とJOIN 操作）をクライアント側で処理します。

ADP データに接続する

必要な接続プロパティの値が未入力の場合には、データソース名（DSN）で入力します。組み込みのMicrosoft ODBC Data Source Administrator を使用し、DSN を構成できます。ドライバーのインストールの最後にアドミニストレーターが開きます。Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定する方法は、ヘルプドキュメントの「はじめに」を参照してください。

Connect to ADP by specifying the following properties:

• SSLClientCert: Set this to the certificate provided during registration.
• SSLClientCertPassword: Set this to the password of the certificate.
• UseUAT: The connector makes requests to the production environment by default. If using a developer account, set UseUAT = true.
• RowScanDepth: The maximum number of rows to scan for the custom fields columns available in the table. The default value will be set to 100. Setting a high value may decrease performance.

The connector uses OAuth to authenticate with ADP. OAuth requires the authenticating user to interact with ADP using the browser. For more information, refer to the OAuth section in the Help documentation.

node-odbc を構築する

CData ODBC Driver を介してADP に接続するには、必要なツールをインストールした後に、node-odbc を手動で構築する必要があります。

必要なツールをインストールする

以下のコマンドでは、node-odbc の構築に必要なツールをインストールします。（ツールをグローバルにインストールする-g パラメータに注意してください。）

npm i -g windows-build-tools
npm i -g node-gyp

node-odbc を構築する

必要なツールをインストールしたらNode.js アプリケーションのディレクトリを作成し、Node.js スクリプトで使用するバイナリを構築するodbc をインストールします。

mkdir nodeodbc
cd nodeodbc
npm i -g node

Node.js からADP をクエリ

ODBC Driver がインストールされ、DSN が構成されて、node-odbc が構築されたら、Node.js アプリケーションからライブADP データをクエリすることができるようになります。以下のサンプルコードは、特定のDSN に接続してWorkers テーブルをクエリします。

myscript.js

const odbc = require('odbc');

async function queryADP() {
    const connection = await odbc.connect(`DSN=CData ADP Source`);
    const data = await connection.query('SELECT AssociateOID, WorkerID FROM Workers');
    console.log(data);
}

queryADP();

アプリケーションを作成したら、node を使用してスクリプトを実行します。

node myscript.js

CData ODBC Driver for ADP の30日の無償評価版 をダウンロードすればNode.js でライブADP データを使用できます。ご不明な点があれば、サポートチームにお問い合わせください。