DBArtisan で BambooHR のデータ を JDBC データソースとして管理
CData JDBC Driver for BambooHR を使えば、BambooHR のデータ をデータベースとしてアクセスできるようになり、DBArtisan などのデータベース管理ツールとシームレスに連携できます。この記事では、DBArtisan で BambooHR の JDBC データソースを作成する方法を説明します。一度接続すれば、データを視覚的に編集したり、標準 SQL を実行したりすることができます。
BambooHR のデータ を DBArtisan プロジェクトに統合
以下のステップに従って、プロジェクトに BambooHR のデータ をデータベースインスタンスとして登録します。
- DBArtisan で、Data Source -> Register Datasource をクリックします。
- Generic JDBC を選択します。
- Manage をクリックします。
- 表示されたダイアログで、New をクリックします。ドライバーの名前を入力し、Add をクリックします。次に表示されるダイアログで、ドライバー JAR ファイルを指定します。ドライバー JAR はインストールディレクトリの lib サブフォルダ内にあります。
-
Connection URL ボックスに、資格情報やその他の必要な接続プロパティを JDBC URL 形式で入力します。
まず、Profile 接続プロパティをディスク上のBambooHR プロファイルの場所に設定します(例:C:\profiles\bamboohr.apip)。次に、ProfileSettings 接続プロパティをBambooHR の接続文字列に設定します(以下を参照)。
BambooHR API プロファイル設定
BambooHR に認証するには、API キーを提供する必要があります。API キーを生成するには、ログインして任意のページの右上隅にある自分の名前をクリックし、ユーザーコンテキストメニューにアクセスします。十分な権限がある場合、そのメニューに「API Keys」オプションが表示され、新しいAPI キーを作成できるページに移動できます。また、BambooHR アカウントのドメイン名にあるDomain を設定します。例えば、BambooHR アカウントがacmeinc.bamboohr.com の場合、Domain は「acmeinc」となります。ProfileSettings プロパティにAPI Key とDomain の両方を設定して接続します。
組み込みの接続文字列デザイナー
JDBC URL の構成には、BambooHR JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.api.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
一般的な接続文字列は以下のとおりです。
jdbc:api:Profile=C:\profiles\BambooHR.apip;ProfileSettings='Domain=acmeinc;APIKey=your_api_key';
- ウィザードを完了して、BambooHR のデータ に接続します。BambooHR エンティティが Datasource Explorer に表示されます。
これで、他のデータベースと同じように BambooHR のデータ を操作できます。 BambooHR API でサポートされるクエリの詳細については、ドライバーのヘルプドキュメントを参照してください。