IntelliJ で Halo Service Desk のデータ に接続
CData JDBC Driver for Halo Service Desk を使用すると、Halo Service Desk を JDBC データソースとしてアクセスでき、IDE の迅速な開発ツールとの連携が可能になります。この記事では、データソース設定ウィザードを使用して IntelliJ で Halo Service Desk のデータ に接続する方法を説明します。
Halo Service Desk 用の JDBC データソースを作成
以下の手順で、ドライバー JAR を追加し、Halo Service Desk のデータ への接続に必要な接続プロパティを定義します。
- Data Sources ウィンドウで右クリックし、Add Data Source -> DB Data Source をクリックします。
表示される Data Source Properties ダイアログで、以下のプロパティを設定します。
- JDBC Driver Files: このメニューの横にあるボタンをクリックし、インストールディレクトリにある JDBC Driver ファイル cdata.jdbc.api.jar を追加します。
- JDBC Driver Class: このメニューで、リストから cdata.jdbc.api.APIDriver を選択します。
Database URL: JDBC URL プロパティに接続 URL を入力します。URL は jdbc:api: で始まり、セミコロンで区切られた接続プロパティを含みます。
まず、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)。
組み込みの接続文字列デザイナー
JDBC URL の作成には、Halo Service Desk JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.api.jar接続プロパティに値を入力して、接続文字列をクリップボードにコピーします。
一般的な JDBC URL は以下のとおりです。
jdbc:api:Profile=C:\profiles\HaloServiceDesk.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key;Domain=yourcompany.haloservicedesk.com';
Halo Service Desk のデータ の編集と保存
スキーマ情報を取得するには、作成したデータソースを右クリックして Refresh Tables をクリックします。テーブルをクエリするには、テーブルを右クリックして Open Tables Editor をクリックします。