LINE WORKS のデータをYellowfin に連携してビジュアライズ

こんにちは！テクニカルディレクターの桑島です。

CData JDBC Driver for API は、JDBC 標準をインプリメントし、BI ツールからIDE まで幅広いアプリケーションでLINE WORKS への接続を提供します。この記事では、Yellowfin からLINE WORKS のデータ に接続する方法を説明します。

LINE WORKS のデータのJDBC データソースを作成

下記の手順に従って、YellowfinからLINE WORKS のJDBCドライバを追加します。

この手順は主にYellowfinの画面を使って進めていきます。

1. メニューバーの中から「管理」→「管理コンソール」画面へ。 管理コンソール画面の右側にある「管理」メニューから「プラグイン管理」を選択。
2. プラグイン管理画面、右側の「追加」をクリックし、「新規プラグイン」の画面を出す。
3. ここでドロップできる拡張子が.jarか.yfpなのでそれに合わせてファイルを変更する必要があります。
   1. CData JDBC ドライバインストールディレクトリの［lib］サブフォルダ内にcdata.jdbc.api.jar とcdata.jdbc.api.licファイルがあることを確認する。
   2. cdata.idbc.api.licファイルを圧縮。
   3. 圧縮してできたファイルcdata.jdbc.api.zipの名前をcdata.jdbc.api.lic.jarに変更。
4. 上記で作ったcdata.jdbc.api.lic.jarともともとあったcdata.jdbc.api.jarを新規プラグイン画面にドラッグ。

※YellowfinをインストールしたマシンとJDBCドライバーをインストールしたマシンが同じものでないとエラーが起こってしまいます。

次にYellowfinの管理コンソールからデータソースを追加します。下記の手順に従って以下の項目を設定します。

1. 「管理」→「データソース」→「追加」を選択。
2. 新規接続画面で「データベース」を選択すると「接続設定」の画面に行きます。
• 名前：任意（CDataAPI）
• 説明：任意
• データベースタイプ：Generic JDBC Data Source（選択後以下二つが出てきます）
• ドライバー：cdata.jdbc.api.APIDriver
• 接続文字: jdbc:api: に続けてセミコロン区切りで接続プロパティを入力します。
  一般的なJDBC URL は次の通りです:
  jdbc:api:Profile=C:\profiles\LINEWORKS.apip;ProfileSettings='Partition=5226;AppID=my_app_id;AppSecret=my_app_secret;' LINE WORKS向けの接続文字はcdata製品マニュアルの［接続の確立］をご覧ください。
• ユーザー名：LINE WORKSのユーザー名
• パスワード：LINE WORKSのパスワード

上記の入力が終わったらビュー作成を選択します。

LINE WORKS のデータのビューを作成

ビュー作成を行っていきます。

［ビュー作成］で以下の項目を設定します。

• ビューのタイプを選択：任意
• テーブルを選択：分析に用いるテーブルを選択します。
• ビュー名：ビューの名前
• ビュー説明：ビューの説明

［Step1. ドラッグ＆ドロップエディタ］にて、左側のデータベーステーブル一覧から参照するテーブルを選択してドラッグドロップで［カラム］または［ロウ］エリアに配置します。

［Step2. グラフ］にて、グラフの形や詳細設定を行っていきます。

「保存」「有効化」を行いビューを保存します。

このようにAPI 内のデータをAPI を書くことなくYellowfin 上で表示することができるようになります。

サポートされるSQL についての詳細は、ヘルプドキュメントの「サポートされるSQL」をご覧ください。テーブルに関する情報は「データモデル」をご覧ください。