CData コネクタを活用して SharePoint 接続

## はじめに
[CData](https://www.cdata.com/jp/drivers/) は様々なデータソースに接続可能なコネクタを提供しています。以前に[『CData コネクタの活用 - Active Directory に接続して社員名簿の作成』]( https://qiita.com/ExtremeCarvFJ/items/b38076e093e20d6192a8)の中で、Active Directory に接続する手順を紹介しました。今回は、SharePoint Online に接続して、SharePoint の情報を Yellowfin で活用する方法を紹介したいと思います。

## コネクタ
#### コネクタの入手
CData の SharePoint JDBC Driver評価版を利用します。まずは下記 URL にアクセスし、対応データソースから SharePoint を選択します。
その後、[JDBC] > [ダウンロード] > [ダウンロード評価版] > [ダウンロード Windows Setup (.exe)] の順に進み、SharePointJDBCDriver.exe をダウンロードします。

https://www.cdata.com/jp/driver

SharePointJDBCDriver.exe を実行すると、デフォルトで以下にファイルが解凍されます。
`C:\Program Files\CData\ CData JDBC Driver for Microsoft SharePoint 2022J`
lib フォルダに以下のようなファイルが存在します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/30e54482-eb7d-41fa-12c9-100bf0e39915.png)

#### コネクタのインストール
ライセンスファイル cdata.jdbc.sharepoint.lic を zip ファイルに圧縮した後、cdata.jdbc.sharepoint.lic.zip をcdata.jdbc.sharepoint.lic.jar に名称変更します。プラグイン管理画面で .jar か .yfp ファイルしか登録できないことへの対応です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/9c381a02-1f4c-295b-f3dc-f6f5d221e11d.png)

Yellowfin 画面から [管理] > [プラグイン管理] > [追加] と進み、cdata.jdbc.sharepoint.jar をドロップして追加した後、「さらに追加」を選択して、cdata.jdbc.sharepoint.lic.jar を追加します。結果、以下のように、実行ファイルとライセンスファイルの両者を合わせて登録します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/81e149f0-99c7-5c33-bb6f-134d5fed3991.png)

## データソース
Yellowfin 画面から [管理] > [プラグイン管理] > [追加] と進み、[新規データ接続] で [データソースを選択] から [データベース] を選択します。
新規接続の設定画面から、以下を参照に新規接続を作成します。

|項目|設定値|
|---|---|
|名前|SharePoint CData|
|認証アダプター|Standard Authentication|
|データベースタイプ|一般 JDBC データソース|
|JDBC ドライバー|cdata.jdbc.sharepoint.SharePointDriver(SharePoint CData)|
|接続文字| jdbc:sharepoint:AuthScheme=OAuth;URL=https\://yellowfinbusinessin.sharepoint.com/sites/CDataTest/;SharePointEdition="SharePoint Online"; Online";User=sample<span>@</span>yellowfin.bi;Password=********;InitiateOAuth=GETANDREFRESH;Schema=REST;|
|ユーザー名|sample<span>@</span>yellowfin.bi|
|パスワード|********|
|スキーマ|REST|

接続文字に関しては、以下の CData ブログ記事を参考にしました。特に、「接続文字列の作成および接続テスト」を参考にさせていただきました。

https://www.cdata.com/jp/blog/cdata-jdbc-basic

接続文字列の末尾に下記を付与することで、指定したディレクトリにログファイルを出力することもできます。
`LogFile=C:\log\LDAPDriverLog.log;Verbosity=3;`

[ビュー作成] ボタンを押下し、接続が成功し、テーブル名が参照できればひとまず大丈夫です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/b2b44310-4f06-1bfc-8df7-174aa8ec410c.png)

## ビュー作成
SharePoint コネクタで SharePoint の該当サイトに接続すると、サイト配下のコンテンツ一覧が参照できます。
サイト直下に、[リスト](https://support.microsoft.com/ja-jp/office/%E3%83%AA%E3%82%B9%E3%83%88%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B-0d397414-d95f-41eb-addd-5e6eff41b083)を作成しました。課題管理のサンプルを作成したので、このリストの内容を Yellowfin に取り込んでみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/4fdbdcbc-bac5-93a0-373a-90196bd38b85.png)
リストに配置している「Title」「OData_担当者」「OData_進捗状況」の 3 列を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/be77c35e-6e2a-bbbc-ed22-6665337a0862.png)

## レポートの作成
レポートを新規で作成し、例えば以下のようなテーブルと円グラフを作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/7f98f99a-adbe-69b7-092b-acad7b310a84.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/7b41fa46-9e90-388e-40eb-37e7bc448968.png)

## 最後に
オンプレミスであってもクラウドであっても、SharePoint のコンテンツは SQL Server に格納されます。コンテンツが構造化された形で管理されているので、とても使いやすいんですね。
SharePoint などのコミュニケーションプラットフォーム上の情報を直接参照して、Yellowfin のコンテンツに取り込むことが可能です。皆さん、是非お試しください。
では、良いデータ分析を! See you then, Cheers!!