Node.js で Halo Service Desk のデータを MySQL データベースとしてクエリ

Halo Service Desk 用の ODBC Driver の SQL Gateway を使用すると、MySQL インターフェース経由でHalo Service Desk のデータをクエリできます。以下の手順に従って、SQL Gateway の MySQL リモーティングサービスを起動し、Node.js からクエリを開始してください。

Halo Service Desk のデータに接続

まだ行っていない場合は、データソース名（DSN）で必要な接続プロパティの値を指定してください。組み込みの Microsoft ODBC データソースアドミニストレーターを使用して DSN を設定できます。これはドライバーインストールの最後のステップでもあります。Microsoft ODBC データソースアドミニストレーターを使用して DSN を作成・設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。

まず、Profile 接続プロパティをディスク上の HaloServiceDesk プロファイルの場所に設定します（例：C:\profiles\HaloServiceDesk.apip）。次に、ProfileSettings 接続プロパティを HaloServiceDesk の接続文字列に設定します（以下を参照）。

HaloServiceDesk API プロファイル設定

HaloServiceDesk では API キー認証を使用します。API キーは、HaloServiceDesk の「Administration」>「Integrations」>「Halo API」で確認・作成できます。

接続するには、以下の接続プロパティを設定します。

• AuthScheme：APIKey に設定します。
• APIKey：HaloServiceDesk アカウントの API キーに設定します。
• Domain：HaloServiceDesk インスタンスのホスト名に設定します（例：yourcompany.haloservicedesk.com）。

SQL Gateway を設定

SQL Gateway 概要を参照して、Halo Service Desk のデータ を仮想 MySQL データベースとして接続を設定してください。クライアントからの MySQL リクエストをリッスンする MySQL リモーティングサービスを設定します。サービスは SQL Gateway UI で設定できます。

Node.js から Halo Service Desk をクエリ

以下の例では、mysql モジュールを使用して Halo Service Desk への接続を定義し、クエリを実行する方法を示しています。以下の情報が必要です。

• ホスト名またはアドレス、およびポート：MySQL リモーティングサービスが MySQL 接続をリッスンしているマシンとポート
• ユーザー名とパスワード：SQL Gateway の Users タブで認証したユーザーのユーザー名とパスワード
• データベース名：MySQL リモーティングサービス用に設定した DSN

以下のコードでHalo Service Desk のデータに接続し、クエリの実行を開始できます。

var mysql      = require('mysql');
var connection = mysql.createConnection({
  host     : 'localhost',
  database : 'CData API Sys',
  port	   : '3306',
  user     : 'mysql_user',
  password : 'test'
});
connection.connect();
connection.query('SELECT * FROM Assets', function(err, rows, fields) {
  if (err) throw err;
  console.log(rows);
});

connection.end();