Outlook のデータをBoard に連携してビジュアライズを作成
CData ODBC Driver for API は、ODBC 標準に準拠しており、BI ツールからIDE まで幅広いアプリケーションでOutlook への接続を提供します。 この記事では、CPM/BIツールのBoardからOutlook に接続、レポートを作成する方法を説明します。
CData ODBC ドライバとは？
CData ODBC ドライバは、以下のような特徴を持った製品です。
- Outlook をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
- 多様なアプリケーション、ツールにOutlook のデータを連携
- ノーコードでの手軽な接続設定
- 標準SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてOutlook の接続を設定、2.board 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとOutlook への接続設定
まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
- インストール後、ODBCデータソースアドミニストレーターにて［システムDSN］タブをクリックし、CData Outlook Source Sys（64bit or 32bit）の接続情報を構成します。（※BoardはシステムDSNのみに対応しています。ユーザーDSNの場合接続できませんので、ご注意ください。）
-
OAuth 認証の設定
Microsoft Graph API は認証に OAuth 2.0 を使用します。OAuth 認証情報（Client ID と Client Secret）を取得するには、Microsoft Azure Portal でアプリケーションを登録する必要があります。
OAuth 認証情報の取得
- Azure Portal にログインします。
- Azure Active Directory > App registrations に移動します。
- New registration をクリックして新しいアプリケーションを作成します。
- アプリケーション名を入力し、適切なアカウントの種類を選択します。
- Redirect URI をアプリケーションのコールバック URL に設定します（デスクトップアプリの場合は http://localhost:33333 など）。
- Register をクリックしてアプリケーションを作成します。
- アプリケーションの概要ページで Application (client) ID をコピーします。これが OAuthClientId になります。
- Certificates & secrets に移動して、新しいクライアントシークレットを作成します。
- クライアントシークレットの値をコピーします。これが OAuthClientSecret になります。
- API permissions に移動して、必要な Microsoft Graph API の権限を追加します：
- Mail.Read - メールメッセージへのアクセス用
- Contacts.Read - 連絡先へのアクセス用
- Calendars.Read - カレンダーイベントへのアクセス用
- Tasks.Read - To Do タスクへのアクセス用
- offline_access - リフレッシュトークンの取得用
- Grant admin consent をクリックして、これらの権限を付与します。
OAuth での接続
以下の接続プロパティを設定して接続を確立してください：
- AuthScheme：OAuth に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。CData API Profile for Outlook が OAuth プロセスを自動的に進め、アクセストークンを取得します。
- OAuthClientId：Azure Portal の Application (client) ID に設定します。
- OAuthClientSecret：Azure Portal のクライアントシークレットの値に設定します。
- TenantId：Azure AD のテナント識別子（GUID または 'contoso.onmicrosoft.com' のようなドメイン名）に設定します。
- CallbackURL：アプリ登録で指定したリダイレクト URI に設定します（デスクトップアプリの場合は http://localhost:33333 など）。
接続文字列の例
Profile=C:\profiles\Outlook.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;TenantId=your_tenant_id;CallbackUrl=http://localhost:33333;
Board DB の作成
最初にBoardの接続情報やキューブ等を格納するDBを作成します。
- Boardを立ち上げて、任意の接続先へ接続します。
- ［Database］タブから［New DB］をクリックします。
- 開いたDB作成用ウィンドウにて、任意の［Database name］［Language］［From Year］［To Year］を入力し［OK］をクリックします。
SQL FastTrackを用いたODBCデータソースからのデータロード
次にSQL FastTrackの機能を用いてODBCデータソースから Outlook のデータをBoard上にロードします。
- ［Database］タブの［SQL FastTrack］をクリックし、Data souceの［New］ボタンをクリックします。
- 接続先を設定するためのウィンドウが表示されますので、［OLE-DB Wizard］をクリックします。
- 開いたデータリンクプロパティの［プロバイダー］タブから［Microsoft OLE DB Provider for ODBC Drivers］を選択し、［次へ］をクリックします。
- ［接続タブ］の［1.データソースを指定します］から事前に設定したODBC DSNを選択し、［3.使用する初期カタログを入力します］に［CData］を入力の上、［OK］をクリックします。
- 任意の［Name］を入力し［Save & Connect］をクリックします。
- SQL FastTrackの画面に戻った後、［Connect］をクリックします。
- Connectをクリック後、Data souce画面左側に Outlook のテーブル一覧が表示されます。分析対象とするテーブルをダブルクリックすると、自動的にSQL クエリが記述されます。記述内容を確認の上、［Execute Query］をクリックします。
- Execute Queryをクリックすると、テーブルに格納された項目一覧が以下の図のように表示されます。分析で使用したい任意の項目を［Code］［Desc］［Cube］のいずれかにチェックを入れ、Cube/Entityを入力し、Track実行ボタンをクリックします。
- 確認ダイアログが表示されますので、［Yes］をクリックします。
- SQL FastTrackの機能により、ODBC データソースからデータがロードされ、自動的にEntityとCubeが生成されます。
- 以下のダイアログが表示されれば、Boardへのデータロードは完了です。
グラフの作成
ロードしたデータを元に簡単なグラフの作成方法を紹介します。
- 最初に各種Screenを格納するためのCapsuleを作成します。［Home］タブを選択し［Capsule］から［New Capsule］をクリックします。
- 任意の［Capsule Name］を入力し［OK］をクリックします。
- 続いてScreenを作成するための画面が表示されるため任意の［Screen Name］を入力し［OK］をクリックします。
- Screenが作成されると、ChartやDataViewを配置することが可能になります。［Charts］から［Chart］を選択し、Screenにドラッグ・アンド・ドロップでChartを配置します。
- 以下のようにChartを配置後、右クリックメニューで［Layout］をクリックします。
- LayoutでChart上のValueとして扱う値を指定します。［Data］タブから［Double-click here to create a block］の箇所をダブルクリックします。
- ［Data Selection］から先程のSQL FastTrackにてCubeの指定をした任意の値を選択し［OK］をクリックします。
- 続いて［Axes］タブをクリックし、先程指定した値の分析軸とするBy Rowに任意の項目を選択し［OK］をクリックします。
- 設定完了後、以下のようにグラフが表示されます。
このようにAPI 内のデータをAPI を書くことなくBoard上で利用することができるようになります。