国産BI ツールのActionista! からZendesk に直接連携してビジュアライズ

Actionista! からリアルタイムZendesk のデータに直接連携して分析を実施。

桑島義行
テクニカルディレクター
最終更新日：2022-07-20

この記事で実現できるZendesk 連携のシナリオ

CData

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

CData Driver for Zendesk を使って、国産BIツールのActionista!（https://www.justsystems.com/jp/products/actionista/）からZendesk のデータをノーコードで連携して利用できます。この記事では、間にETL/EAI ツールをはさむ方法ではなく、CData JDBC Driver for Zendesk をActionista! 側に組み込むだけで連携を実現できます。

Actionista! からZendesk のデータへの連携を設定

CData JDBC Driver for Zendesk をActionista! に配置

CData JDBC Driver for Zendesk をActionista! と同じマシンにインストールします。
次にインストールした.jar ファイルを以下のパスに格納します：
ドライバー.jar ファイルのディレクトリ C:\Program Files\CData\CData JDBC Driver for Zendesk 2019J\lib\cdata.jdbc.zendesk.jar
Actionista! 側のコピー先ディレクトリ C:\JUST\JustBI\jdbc
次に、C:\JUST\JustBI\conf にあるdatamanager.properties プロパティファイルに今回使用するZendesk のドライバークラスなどを以下のように指定します：


# Zendesk
loader.jdbc.displayName.Zendesk = Zendesk
loader.jdbc.initJdbcUrl.Zendesk = jdbc:zendesk:
loader.jdbc.url.Zendesk = jdbc:zendesk:
loader.jdbc.driver.Zendesk = cdata.jdbc.zendesk.ZendeskDriver
loader.jdbc.dbmsInfo.Zendesk = cdata.jdbc.zendesk.ZendeskDriver

これでActionista! へのドライバーの配置が完了しました。

Zendesk のデータをActionista! のキューブに取り込み

Actionista! ではデータの保持をキューブという単位で保存します。また、クエリでデータソースからデータを取得するのではなく、キューブに対してクエリを行います。このステップでは、Zendesk のデータをキューブに取り込み、分析で使えるようにします。

Actionista! にログインします。
「DataManager」-> 「＋キューブの新規作成」をクリックします。
CData JDBC ドライバはRDB データソースとしてActionista! から利用できるので、「RDB」を選択します。
設定情報にZendesk への接続に必要なプロパティを入れます：
- RDB の種類：には、上のステップでdisplayName で指定した名前をドロップダウンで選びます。
- 接続URL：Zendesk に接続するための認証情報をセミコロン区切りで入力します。
  
  Zendesk 接続プロパティの取得・設定方法
  
  Zendesk に接続するには、https://{subdomain}.zendesk.com の形式でURL（Zendesk Support URL）を設定します。接続後、次のセクションの説明に従ってユーザー認証を行います。
  また、TicketMetrics テーブルのアーカイブデータを扱うユーザーは、UseIncrementalAPI プロパティをTrue に設定する必要があります。
  Zendesk への認証
  
  Zendesk は、Zendesk インスタンスの設定に応じて、3種類の認証をサポートします。API トークン認証、OAuth 認証、Basic 認証（レガシー）です。
  
  API トークン認証
  
  API トークン認証を使用する場合は、E メールアドレスとApiToken を指定します。 AuthScheme をAPIToken に、User をE メールアドレスに設定し、Zendesk Support の管理画面で以下の設定を行います。
  1. Token アクセスを有効にします。
  2. Admin -> Channels-> API で、API トークンを管理します。一度にアクティブにできるトークンは1つだけです。トークンを削除すると、そのトークンは永久に無効化されます。
  最後に、APIToken をアクティブなAPI トークンに設定します。
  
  その他の認証方法についてはヘルプドキュメントを参照してください。
  jdbc:zendesk:URL=https://subdomain.zendesk.com;[email protected];Password=test123;InitiateOAuth=REFRESH
- ユーザー名：接続するアカウントのユーザー名（URL に含めることも可）
- パスワード：接続するアカウントのパスワード（URL に含めることも可）