各製品の資料を入手。
詳細はこちら →
製品をチェック
JDBI からMonday.com データ のデータアクセスオブジェクトを作成
JDBI でMonday.com のデータ 用のSQL オブジェクトAPIを作成する方法を概説します。
最終更新日：2022-05-25
この記事で実現できるMonday.com 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for Monday は、Java アプリケーションとリアルタイムMonday.com のデータ のデータ連携を実現します。これらの技術を組み合わせることによって、Monday.com のデータ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO（Data Access Object ）とそれに付随するMonday.com のデータ の読み書きのためのコードの作成について説明します。
Monday.com Invoices Entity のDAO を作成
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MyInvoicesDAO {
//request specific data from Monday.com (String type is used for simplicity)
@SqlQuery("SELECT DueDate FROM Invoices WHERE Status = :status")
String findDueDateByStatus(@Bind("status") String status);
/*
* close with no args is used to close the connection
*/
void close();
}
Monday.com への接続を開く
必要な接続プロパティを収集し、Monday.com に接続するための適切なJDBC URL を作成します。
Monday 接続プロパティの取得・設定方法
Monday AuditLog API
Monday AuditLog API は、API トークンによる認証のみをサポートしています。
監査ログAPI トークンを生成するには：
- monday.com アカウントにログインします。
- 画面右上のアバター（画像アイコン）をクリックします。
- 表示されたメニューからAdministration を選択します。
- 左側のナビゲーションでSecurity をクリックします。
- Audit タブをクリックします。
- Monitor by API -> Copy をクリックして、AuditLog API トークンをコピーします。
API トークンを取得した後、以下の接続プロパティを設定します。
- Schema："AuditLog" に設定。
- AuthScheme：Token
- APIToken：取得した監査ログAPI トークン
- URL：Monday アカウントURL。ログイン後、自身のMonday ホームページのURL をコピーできます。例：https://your-account-name.monday.com/。
Monday GraphQL API
Monday GraphQL API は、API トークンまたはOAuth 標準による認証をサポートしています。
API トークン
API トークンで接続するには、AuthScheme をToken に設定し、次の手順でAPIToken を取得します。
- monday.com アカウントにログインします。
- 画面右上のアバター（画像アイコン）をクリックします。
- 表示されたメニューからAdministration を選択します（管理者権限が必要です）。
- 左側のナビゲーションでConnections をクリックし、表示されたページでAPI タブをクリックします。
- Personal API Token で、Create token をクリックしてパーソナルAPI トークンを作成します。APIToken 接続プロパティをこの値に設定します。
- すでにトークンを作成している場合は、Personal API Token でCopy ボタンをクリックしてAPI トークンをコピーします。APIToken 接続プロパティをこの値に設定します。
OAuth で認証する場合は、ヘルプドキュメントの「OAuth 認証の使用」セクションを参照してください。
ビルトイン接続文字列デザイナー
JDBC URL の構成については、Monday.com JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.monday.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Monday.com の接続文字列は、通常次のようになります。
jdbc:monday:APIToken=eyJhbGciOiJIUzI1NiJ9.yJ0aWQiOjE0MTc4NzIxMiwidWlkIjoyNzI3ODM3OSwiaWFkIjoiMjAyMi0wMS0yMFQxMDo0NjoxMy45NDFaIiwicGV;
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:monday:APIToken=eyJhbGciOiJIUzI1NiJ9.yJ0aWQiOjE0MTc4NzIxMiwidWlkIjoyNzI3ODM3OSwiaWFkIjoiMjAyMi0wMS0yMFQxMDo0NjoxMy45NDFaIiwicGV;");
MyInvoicesDAO dao = dbi.open(MyInvoicesDAO.class);
//do stuff with the DAO
dao.close();
Monday.com データ について
Monday.com への接続を開いた状態で以前定義したメソッドを呼び出すだけで、Monday.com のInvoices エンティティからデータを取得できます。
//disply the result of our 'find' method
String dueDate = dao.findDueDateByStatus("SENT");
System.out.println(dueDate);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for Monday と統合することで、SQL Object API for Monday を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムMonday.com を操作しましょう。
関連コンテンツ
