デジタルワークプレイス Slingshot のダッシュボードでWordPress のデータを可視化・分析

こんにちは！リードエンジニアの杉本です。

Slingshot はインフラジスティックス社が提供するオールインワンのデジタルワークプレイスサービスです。この記事では、CData Connect Cloud を経由して Slingshot からWordPress に連携するダッシュボードを作成する方法を説明します。

CData Connect Cloud は、WordPress のデータのクラウド to クラウドの仮想OData インターフェースを提供し、Slingshot からリアルタイムにWordPress のデータへ連携することができます。

CData Connect Cloud の設定

Slingshot でWordPress のデータをリアルタイムで操作するには、Connect Cloud からWordPress に接続し、コネクションにユーザーアクセスを提供してWordPress のデータのOData エンドポイントを作成する必要があります。

（オプション）新しいConnect Cloud ユーザーの追加

必要であれば、Connect Cloud 経由でWordPress に接続するユーザーを作成します。

1. ユーザーページに移動し、 Invite Users をクリックします。
2. 新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。
3. ユーザーページからユーザーを確認および編集できます。

パーソナルアクセストークンの追加

OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン（PAT）を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. Connect Cloud アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
2. User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
3. PAT の名前を入力して Create をクリックします。
4. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

Connect Cloud からWordPress に接続

CData Connect Cloud では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。

1. Connect Cloud にログインし、 Add Connection をクリックします。
2. Add Connection パネルから「WordPress」を選択します。
3. 必要な認証プロパティを入力し、WordPress に接続します。

   WordPress 接続プロパティの取得・設定方法

   現時点では、CData JDBC Driver for WordPress はセルフホスト型のWordPress インスタンスへの接続のみをサポートしています。データに接続するには、Url を自身のwordpress サイトに指定し、次に以下に説明するように認証を行います。

   URL を完全な形式で記入します。例えば、あなたのサイトが'http://localhost/wp/wordpress' でホストされている場合、URL は'http://localhost' ではなく、'http://localhost/wp/wordpress' となるべきです。 URL を完全な形式で入力しないと、'site not found' というエラーが発生します。

   WordPress は2種類の認証をサポートします。

   • Basic 認証は、テスト環境での使用が推奨されます。
   • OAuth 2.0 認証は、デスクトップアプリケーション、Web アプリケーション、またはヘッドレスマシンからのブラウザベースのアクセスをサポートします。

   Basic 認証

   Basic 認証を使用するようにWordPress を設定する前に：

   • WordPress ログインに管理者権限があることを確認してください。
   • ローカルホストで実行されているWordPress のバージョンを確認します。（WordPress 4.7 以降はネイティブでWordPress REST API サポートしていますが、それより前のバージョンでは、REST API へのアクセスを安全に行うには、Basic 認証プラグインの使用が必要です。）
   Basic 認証を構成するには：
   1. WordPress ホストにログインします。
   2. 4.7より前のバージョンのWordPress を実行している場合は、REST API プラグインをインストールしてください。
   3. Basic Authentication プラグインをインストールします。
   4. カスタムタクソノミーを作成するには、Simple Taxonomy Refreshed をインストールします。プラグインを手動でインストールしたい場合は、圧縮されたフォルダをwp-content\plugins フォルダに展開してからWordPress 管理者インターフェース経由でプラグインを有効にします。
   5. 次の接続プロパティを設定します。
      • AuthScheme：Basic。
      • Url：WordPress URL。
      • User：ユーザーネーム。
      • Password：パスワード。
   OAuth 2.0 認証についてはヘルプドキュメントを参照してください。
   
4. Create & Test をクリックします。
5. Edit WordPress Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

Connect Cloud にWordPress OData エンドポイントを追加する

WordPress に接続したら、目的のテーブルのOData エンドポイントを作成します。

1. OData ページに移動し、 Add to create new OData endpoints をクリックします。
2. WordPress 接続（例：WordPress1）を選択し、Next をクリックします。
3. 使用するテーブルを選択し、Confirm をクリックします。

コネクションとOData エンドポイントを設定したら、Slingshot からWordPress のデータに接続できます。

Slingshot にデータソースを追加する

CData Connect Cloud の設定が完了したら、Slingshot 側に接続設定を追加しましょう。

1. Slingshot の対象のワークスペースに移動して「データソース」タブに移動し「＋データソース」をクリックします。

2. データソースの一覧から利用したいサービスを選択します。ここで先程CData Connect Cloud で設定したOData エンドポイントの接続を追加します。

3. 「URL」にOData エンドポイントのURL を指定し「先制認証を使用する」にチェックを入れます。その上で「資格情報」を追加しましょう。

4. 資格情報の種類は「汎用資格情報」になります。合わせてCData Connect Cloud へのログインユーザーIDをユーザー名に入力し、パスワードには先程生成したPAT を入力します。

5. あとは「データソースの追加」をクリックすれば、データソースの接続設定は完了になります。

ダッシュボードを作成する

すべての準備が整ったのでWordPress のデータを活用してダッシュボードを作成していきましょう。

1. 「ダッシュボード」タブに移動して「＋ダッシュボード」をクリックします。

2. 先程追加したCData Connect Cloud へのOData フィードデータソースが表示されるので、これを選択します。

3. すると、事前にCData Connect Cloud 上で登録しておいたテーブルの一覧がエンティティのセットとして表示されるので、任意のエンティティを選択しましょう。

4. これでSlingshot 上に対象のデータがシームレスに読み込まれます。あとは可視化するためのラベルや値を選択することで、以下のように簡単にビジュアライズが実施できます。

このように、CData Connect Cloudを経由することで、API 側の複雑な仕様を意識せずにAPI 連携をしたダッシュボードをSlingshot で開発できます。他にも多くのデータソースに対応するCData Connect Cloud の詳細をこちらからご覧ください。