JasperReports Server で Monday.com に連携する帳票を作成

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for Monday は企業全体のMonday.com へのデータ連携を可能にします。この記事では、JasperReports server にドライバーを配布してレポーティングドメイン、ビルディングブロックを作成し、ad hoc 帳票を作成する方法を説明します。

Monday.com ドライバーのJAR を配布

下記の手順に従って、ドライバーのJAR をJasperReports server に配置します。標準的なプロセスに従って、JNDI データソースをTomcat またはJBoss に配布できます。以下の説明にはMonday.com およびJasperReports Server にバンドルされたTomcat server の詳細が含まれます。

1. インストールディレクトリの［lib］サブフォルダ内のドライバーJAR およびlic ファイルを、apache-tomcat フォルダの［lib］サブフォルダにコピーします。
2. 以下のリソースエントリーをjasperserver-pro Web アプリケーションのcontext.xml に追加します。これはアプリケーションの［META-INF］サブフォルダに配置されています。必要な接続プロパティをJDBC URL に指定します。

   Monday 接続プロパティの取得・設定方法

   Monday AuditLog API

   Monday AuditLog API は、API トークンによる認証のみをサポートしています。

   監査ログAPI トークンを生成するには：

   1. monday.com アカウントにログインします。
   2. 画面右上のアバター（画像アイコン）をクリックします。
   3. 表示されたメニューからAdministration を選択します。
   4. 左側のナビゲーションでSecurity をクリックします。
   5. Audit タブをクリックします。
   6. 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 を取得します。

   1. monday.com アカウントにログインします。
   2. 画面右上のアバター（画像アイコン）をクリックします。
   3. 表示されたメニューからAdministration を選択します（管理者権限が必要です）。
   4. 左側のナビゲーションでConnections をクリックし、表示されたページでAPI タブをクリックします。
   5. Personal API Token で、Create token をクリックしてパーソナルAPI トークンを作成します。APIToken 接続プロパティをこの値に設定します。
      • すでにトークンを作成している場合は、Personal API Token でCopy ボタンをクリックしてAPI トークンをコピーします。APIToken 接続プロパティをこの値に設定します。

   OAuth で認証する場合は、ヘルプドキュメントの「OAuth 認証の使用」セクションを参照してください。

   <Resource name="jdbc/monday" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.monday.MondayDriver" url="jdbc:monday:APIToken=eyJhbGciOiJIUzI1NiJ9.yJ0aWQiOjE0MTc4NzIxMiwidWlkIjoyNzI3ODM3OSwiaWFkIjoiMjAyMi0wMS0yMFQxMDo0NjoxMy45NDFaIiwicGV;" maxActive="20" maxIdle="10" maxWait="-1" factory="com.jaspersoft.jasperserver.tomcat.jndi.JSBasicDataSourceFactory"/>
3. jasperserver-pro Web アプリケーションのweb.xml に以下の参照を追加します。これはアプリケーションの［WEB-INF］サブフォルダに配置されています。 Monday.com データ JSP jdbc/monday javax.sql.DataSource Container
4. サーバーを再起動します。

Monday.com JDBC データソースの作成

ドライバーを配布したら、JNDI 接続を作成してバンドルされたあらゆるドライバーと同じように接続できます。

1. JasperReports Server にログインして［Create］>［Data Source］をクリックします。
2. ［Type］メニューで［JNDI Data Source］を選択します。
3. ［Service Name］ボックスにMonday.com に定義したJDNI ルックアップを入力します。例では、ルックアップは jdbc/monday です。

ドメイン の作成

データのドメインはJaspersoft のメタデータレイヤです。アドホックな分析および帳票で使うことができます。

1. ［Create］>［Domain］をクリックし、ドメインにID を入力します。
2. ［Data Source］セクションで［ブラウズ］をクリックし、作成したMonday.com のデータソースを選択します。
3. ［Domain Design］セクションで［Create with Database Designer］をクリックします。［Select Database Schema］ダイアログが表示されます。
4. Monday.com のデータソースを選択します。
5. ［Tables］タブの［Data Source］ペインでテーブルを選択し、矢印をクリックして［Selected Tables］に追加します。
6. ［Display］タブの［Resources］ペインでMonday.com エンティティを選択し、矢印をクリックしてリソースを［Sets and Items］ペインに追加します。

ドメインにView Based を作成

ドメインを使ってMonday.com のビジネスビューを作成したら、データに関連あるサブセットを表示するビューを作成します。下記の手順に従って、［Ad Hoc Editor］の［Ad Hoc view］にビューを作成します。

1. ［Create］>［Ad Hoc View］をクリックします。
2. ダイアログが表示されたら、作成したMonday.com ドメインを選択します。
3. ［Choose Data］ページで、ビューで使いたいカラムを選択します。［Select Fields］セクションでは、フィルターおよび入力用のプロンプトユーザーを作成できます。［Display］セクションでは、フィールドおよびフィールド名の並び順を変更できます。
4. ウィザードを完了したら、ビューの種類を選択しビューにカラムを追加できます。JasperSoft はドライバーのメタデータを使って、利用可能なdimensions およびmeasures をデータの種類に基づいて検出します。 ［Columns］ および［Rows］ボックスにdimensions およびmeasures をドラッグします。例えば、チャートを作成するには［Columns］ボックスに［excol#1］を、［Rows］ボックスに［excol#2］をドラッグします。
5. ビューを保存します。

帳票の作成

これでドメインから帳票を作成できます：