はじめに

本記事は、クエステトラ社の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を確認したうえでインストールを完了します。

※途中、ライセンスサーバーへのオンラインアクティベーションが行われるためネットワーク環境に接続されている必要があります。

インストールが完了すると、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）

「接続のテスト」ボタンをクリックして接続が成功することを確認します。次に、「テーブル」タブに移動して「テーブルまたはビュー：」のドロップダウンから「＜新しいテーブルの定義＞」を選択します。

「新しいテーブル定義」のウィンドウにて、以下の項目をセットします。

Table Name : listAllocated　※APIエンドポイント名
Format : JSON
URI : https://kawaramachi-imadegawa-444.questetra.net/API/PE/Workitem/listAllocated ※APIエンドポイント
X Path : /workitems　※JSON内の繰り返しルート
File Location : C:\Program Files\CData\CData ODBC Driver for REST\db ※ODBCのDSNのSchemaと同じパス
File Name : listAllocated.rsd ※TalbeName＋拡張子「.rsd」ファイル

「作成ボタン」をクリックしてテーブル定義の作成が成功した旨のメッセージ「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」を追加して、チャートを追加します。