JRuby からZoho Recruit にデータ連携

加藤龍彦
加藤龍彦
デジタルマーケティング
リアルタイムZoho Recruit に連携するシンプルなJRuby アプリケーションを作成します。



JRuby はRuby プログラミング言語の高性能で安定した、完全にスレッド化されたJava 実装です。CData JDBC Driver for API を使用すると、JRuby からリアルタイムZoho Recruit へのデータ連携を簡単に実装できます。ここでは、Zoho Recruit に接続し、クエリを実行して結果を表示する簡単なJRuby アプリを作成する方法を説明します。

Zoho Recruit のデータにJDBC で接続

アプリを作成する前に、JDBC Driver のJAR ファイルのインストール場所をメモします。 (通常はC:\Program Files\CDatat\CData JDBC Driver for API\libにあります。)

JRuby は、JDBC をネイティブにサポートしているため、簡単にZoho Recruit に接続してSQL クエリを実行できます。java.sql.DriverManager クラスのgetConnection 関数を使用してJDBC 接続を初期化します。

ZohoRecruit への認証では、OAuth 標準を使って自分のデータに接続したり、他のユーザーが各自のデータに接続できるようにしたりできます。

OAuth 認証の設定

まず、ZohoRecruit に OAuth アプリケーションを登録する必要があります。登録するには、Zoho Developer Console に移動して、新しい Client(Server-based application)を追加し、有効な OAuth リダイレクト URL を設定します。OAuth アプリケーションには client id と client secret が割り当てられます。さらに、該当する Domain(.com、.eu、.in、.com.cn、または .jp)を設定する必要があります。デフォルトは .com です。

以下の接続プロパティを設定して接続を確立してください:

  • AuthScheme:OAuth に設定します。
  • InitiateOAuthGETANDREFRESH に設定します。InitiateOAuth を使うと、OAuthAccessToken を取得するプロセスを管理できます。
  • OAuthClientId:アプリ設定で指定された client_id に設定します。
  • OAuthClientSecret:アプリ設定で指定された client_secret に設定します。
  • CallbackURL:アプリ設定で指定されたリダイレクト URI に設定します。
  • Domain:ProfileSettings に設定して、ZohoRecruit アカウントのドメイン(例:.com、.eu、.in、.com.cn、.jp)を指定します。

接続文字列の例:

Profile=C:\profiles\ZohoRecruit.apip;ProfileSettings='Domain=.com';AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;

ビルトイン接続文字列デザイナー

JDBC URL の構成については、Zoho Recruit JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

java -jar cdata.jdbc.api.jar

接続プロパティを入力し、接続文字列をクリップボードにコピーします。

Using the built-in connection string designer to generate a JDBC URL (Salesforce is shown.)

以下はZoho Recruit の一般的なJDBC 接続文字列です。

jdbc:api:Profile=C:\profiles\ZohoRecruit.apip;ProfileSettings='Domain=.com';AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;

Zoho Recruit のデータへの接続性を持つJRuby アプリを作成

新しいRuby ファイル(例: APISelect.rb) を作成してテキストエディタで開き、次のコードをファイルにコピーします。

require 'java'
require 'rubygems'
require 'C:/Program Files/CData/CData JDBC Driver for API 2018/lib/cdata.jdbc.api.jar'

url = "jdbc:api:Profile=C:\profiles\ZohoRecruit.apip;ProfileSettings='Domain=.com';AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;"
conn = java.sql.DriverManager.getConnection(url)
stmt = conn.createStatement
rs = stmt.executeQuery("SELECT ,  FROM Attachments")
while (rs.next) do
  puts rs.getString(1) + ' ' + rs.getString(2)
end

ファイルが完成したら、コマンドラインからファイルを実行するだけでJRuby でZoho Recruit を表示できるようになります。

jruby -S APISelect.rb

SQL-92 クエリをZoho Recruit に書き込むと、Zoho Recruit を独自のJRuby アプリケーションに素早く簡単に組み込むことができます。今すぐ無料トライアルをダウンロードしましょう。

はじめる準備はできましたか?

API Driver で Zoho Recruit のライブデータに接続

Zoho Recruit に接続