各製品の資料を入手。
詳細はこちら →製品をチェック
DBArtisan でJDBC 経由でSmartHR データ をデータ連携利用
DBArtisan のウィザードを使用して、SmartHR のJDBC データソースを作成します。
加藤龍彦デジタルマーケティング
最終更新日:2022-09-23
この記事で実現できるSmartHR 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for API は、データベースとしてSmartHR のデータ に連携できるようにすることで、SmartHR のデータ をDBArtisan などのデータベース管理ツールにシームレスに連携します。ここでは、DBArtisan でSmartHR のJDBC ソースを作成する方法を説明します。データを直観的に標準SQL で実行できます。
SmartHR データ をDBArtisan Projects に連携
以下のステップに従って、SmartHR をプロジェクトのデータベースインスタンスとして登録します。
- DBArtisan で、[Data Source]->[Register Datasource]とクリックします。
- [Generic JDBC]を選択します。
- [Manage]をクリックします。
- 表示されるダイアログで、[New]をクリックします。ドライバーの名前を入力し、[Add]をクリックします。次に、ドライバーJAR に移動します。ドライバーJAR は、インストールディレクトリのlib サブフォルダにあります。
-
Connection URL ボックスで、JDBC URLに資格情報とその他の必要な接続プロパティを入力します。
SmartHR に接続するには、SmartHR API トークンとTenantId が必要です。API トークンはSmartHR のアプリケーション統合ページで生成できます。トークンを取得したら、ProfileSettings API Key 接続プロパティに指定してください。TenantId は自身のSmartHR ページのURL「https://1234567890.smarthr.jp/」で確認できます(ここでは「1234567890」)。もしSandbox 環境を使用する場合は、接続プロパティにUseSandbox=true を設定してください。
次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。
ビルトイン接続文字列デザイナー
JDBC URL の構成については、SmartHR JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.api.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
下は一般的な接続文字列です。
jdbc:api:Profile=C:\profiles\SmartHR.apip;UseSandbox=false;ProfileSettings='APIKey=your_api_token;TenantId=1234567890;''InitiateOAuth=GETANDREFRESH
- ウィザードを終了して、SmartHR に接続します。SmartHR エンティティは、[Datasource Explorer]に表示されます。
ほかのデータベースを使うのと同じように、SmartHR を使うことができます。 SmartHR API にサポートされているクエリについてのより詳しい情報は、ドライバーのヘルプドキュメントを参照してください。
