はじめに
本記事は、クエステトラ社のBPM製品であるQuestetra BPM Suite内の案件リストをWebAPI経由で各BIツールでビジュアライズする手順についてご紹介します
前提条件
本記事では以下のサービスや製品を使用しています。
- Questetra BPM Suite ※無料版あり
- CData REST ODBC Driver ※30日間の評価版あり
- Tableau Desktop ※無料トライアル版あり
- QlikSense ※無料ダウンロード版あり
- Power BI Desktop ※無料版あり
手順
Questetra BPM SuiteのWebAPIの利用準備
Questetra BPM SuiteのWebAPIを利用する場合の認証認可には、Basic認証とOAuth2が利用できます。今回はBasic認証を利用します。 「アカウント設定」＞「パスワード」＞「APIパスワード」を開き、表示されるBasic認証用のパスワードは後の手順で必要となるので手元に控えます。
次に、Questetra BPM Suiteの「APIマニュアル」を確認します。
WorkFlowのAPIマニュアルを開きます。
Swagger記述形式のAPIリファレンスが表示されます。今回は、APIのエンドポイント一覧からワークフロー案件のリスクを取得する「/API/OR/Workitem/listAllocated」を選択、開き、「Excecute」ボタンをクリックしてAPIを叩きます。
「Response」エリアにCode（ステータスコード）200のDetailsに実際のレスポンスデータの例が表示されていることが確認できれば成功です。
CData REST ODBC DriverのインストールおよびQuestetra BPM Suiteへの接続設定
CData REST ODBC Driverの30日間の評価版をダウンロードします。ダウンロードの際には、Emailの登録が必要となります。
ダウンロードしたsetup.exeファイルをBIツールがインストールされているマシンにインストールします。インストールウィザードに従い、EULAを確認したうえでインストールを完了します。
※途中、ライセンスサーバーへのオンラインアクティベーションが行われるためネットワーク環境に接続されている必要があります。 image.png インストールが完了すると、ODBCのDSN設定のウィンドウが立ち上がります。
以下の項目をセットします。
HTTP * Auth Scheme : BASIC * Password : （Questetra BPM SuiteのWebAPIの利用準備で生成したBaisc認証のパスワード） * User : Questetra BPM SuiteへのログインユーザID
Connection * Format : JSON * Generate Schema Files : OnStart * Schema : 書き込み権限がある任意のパス（例：C:\Program Files\CData\CData ODBC Driver for REST\db）
「接続のテスト」ボタンをクリックして接続が成功することを確認します。次に、「テーブル」タブに移動して「テーブルまたはビュー：」のドロップダウンから「＜新しいテーブルの定義＞」を選択します。 
「新しいテーブル定義」のウィンドウにて、以下の項目をセットします。
「作成ボタン」をクリックしてテーブル定義の作成が成功した旨のメッセージ「The new table was defined successfully」が表示されたら成功です。作成された「listAllocated」テーブルの定義情報が表示されます。
また、File Locationのパスに「listAllocated.rsd」が作成されたことを確認します。
Tableauからの接続確認
Tableau Desktopを起動して、データ接続より「サーバーへ」＞「詳細」＞「その他データベース（ODBC）」を選択します。
「その他のデータベース（ODBC）」設定ウィンドウが開いたら、接続手段内のDSNから「CData REST Source」を選択して「サインイン」します。
「データソース」画面が開くので、左側のペインで、表「listAllocated(REST.listAllocated)」を選択して、右上のエリアにドラッグ＆ドロップします。抽出を行い、右下のデータプレビューにQuestetra BPM Suiteの自身の案件一覧が表示されることを確認します。
「シート」ページに移動して、グラフや表を追加します。
今回は、以下３つのシートを作成してダッシュボードとして並べて表示してみました。
- 円グラフ１ ： ディメンション：nodeName、メジャー：レコード数
- 円グラフ２ ： ディメンション：ProcessModelInfoNmae、メジャー：レコード数
- クロス集計表 ： nodeName、ProcessModelInfoNmae、レコード数
QlikSenceからの接続確認
QlikSence Desktopを起動して、「アプリの新規作成」をクリックします。
「データの追加」をクリックします。
「ODBC」を選択します。
「CData REST Sources」を選択します。
テーブル「listAllocated」を選択してデータプレビューにQuestetra BPM Suiteの自身の案件一覧が表示されることを確認します。
「シート」を追加して、チャートを追加します。
今回は、以下３つのオブジェクトを作成してダッシュボードとして並べて表示してみました。
- 円グラフ１ ： ディメンション：nodeName、メジャー：id（Count）
- 円グラフ２ ： ディメンション：ProcessModelInfoNmae、メジャー：id（Count）
- リスト ： allocatedDatetime, allecatedQgroupName, nodeName、ProcessModelInfoNmae, State, ProcessModelInfoCategory
PowerBIからの接続確認
PowerBI Desktopを起動して、「Get Data」から「Other」＞「ODBC」を選択します。
「Data source name(DSN)」で「CData REST Source」を選択します。
「Navigator」にてテーブル「listAllocated」を選択してデータプレビューにQuestetra BPM Suiteの自身の案件一覧が表示されることを確認します。。
「Page」を追加して、チャートを追加します。
今回は、以下３つのオブジェクトを作成してダッシュボードとして並べて表示してみました。
- 円グラフ１ ： ディメンション：nodeName、メジャー：id（Count）
- 円グラフ２ ： ディメンション：ProcessModelInfoNmae、メジャー：id（Count）
- リスト ： Year, Quarter, Month, Day, allocatedOgroupId, allocatedQgroupName, allocatedQuserid, allocatedQName, data, swimianeType, state, startDatetime, started, read
まとめ
Questetra BPM Suite内の自身の案件状況の一覧をWebAPI経由でCData REST ODBC Driverを使用してネイティブに各BIツールからビジュアライズする手順について説明しました。本記事で必要な各サービスおよび製品は無償版や評価版が用意されているので是非お試しください。
関連コンテンツ
