SAP Analytics Cloud でConfluence のデータを分析

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

SAP Analytics Cloud は、クラウドベースのビジネスインテリジェンスプラットフォームです。CData Connect Cloud は、Confluence へのリアルタイム接続を作成し、Confluence のOData API（Analytics Cloud でネイティブにサポート）を生成するために使用できます。SAP Analytics Cloud をCData Connect Cloud と組み合わせることで、すべてのSaaS およびクラウドベースのビッグデータとNoSQL ソースへの、データを移行したり統合したりする必要のないクラウド間接続が可能になります。ほかのOData サービスと同様に、Connect Cloud に接続するだけで、すべてのデータに瞬時にリアルタイムアクセスできます。

この記事では、SAP Analytics Cloud からCData Connect Cloud 経由でConfluence に接続し、モデルと簡単なダッシュボードを作成する手順を説明します。

Connect Cloud を構成する

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

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

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

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

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 からConfluence に接続

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

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

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

   任意のConfluence Cloud またはConfluence Server インスタンスへの接続を確立できます。接続するにはURL 接続プロパティを設定します。例えば、https://yoursitename.atlassian.net です。

   Confluence への認証

   Confluence は、次の認証メソッドをサポートしています：API トークン、Basic 認証、OAuth 2.0、SSO。

   API トークン - Confluence Cloud アカウント

   トークンの取得

   アカウント認証にはAPI トークンが必要です。API トークンを生成するには、Atlassian アカウントにログインしてAPI トークン -> API トークンの作成を選択します。生成されたトークンが表示されます。

   トークンを使用する認証

   Cloud アカウントへの認証を行うには、以下を入力します。

   • AuthScheme：APIToken に設定。
   • User：Confluence サーバーに認証する際に使用されるユーザー。
   • APIToken：現在認証されているユーザーに紐づくAPI トークン。
   • Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。

   Basic 認証 - Confluence Server インスタンス

   Server インスタンスへの認証を行うには、以下のように指定します。

   • AuthScheme：Basic に設定。
   • User：Confluence インスタンスに認証する際に使用されるユーザー。
   • Password：Confluence サーバーに認証する際に使われるパスワード。
   • Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。
   その他の認証方法と詳細については、ヘルプドキュメントの「はじめに」セクションを参照してください。
   
4. Create & Test をクリックします。
5. Edit Confluence Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

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

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

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

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

SAP Analytics Cloud でConfluence のデータのモデルを作成する

Confluence への接続が設定されてOData エンドポイントが作成されると、SAP Analytics Cloud でConfluence のデータのモデルを作成できるようになります。

1. Analytics Cloud インスタンスにログインし、メニューから「Create」->「Model」と進みます。
2. 「Get data from a datasource」から「OData Services」を選択します。
3. Connect Cloud OData への既存の接続を選択、または新しい接続を作成します。
   • 「Connection Name」を設定します。
   • 「Data Service URL」をOData API のBase URL（https://cloud.cdata.com/api/odata/service）に設定します。
   • 「Authentication Type」をBasic Authentication に設定します。
   • User Name をCData Connect Cloud のユーザー名（例：user@mydomain.com）に設定します。
   • Password を上記のユーザーのPAT に設定します。
   
4. 「Create a new query」を選択して「Next」をクリックします。
5. Execute に名前を付け、OData エンドポイント（Pages など）を選択して「Next」をクリックします。
6. 使用したいカラムを「Selected Data」ワークスペースにドラッグし、「Create」をクリックします。
7. この時点でドラフトのデータソースが作成されるため、ドラフトをクリックしてモデルを完成させます。
8. 計算ディメンション、場所ディメンションの作成、データソースの結合などの変換を実行し、「Create Model」をクリックします。
9. モデルに名前を付け、「OK」をクリックします。

SAP Analytics Cloud にダッシュボードを構築する

モデルが作成されたら、Confluence のデータを使用してSAP Analytics Cloud でダッシュボードを作成できるようになります。

1. メニューから「Create」->「Story」とクリックします。
2. SAP Analytics Template をクリックします。（この記事では、「Dashboard」テンプレートを使用します。）
3. レイアウトを選択して「Apply」をクリックします。
4. 「More」メニューから挿入するビジュアライゼーション（チャート）を選択します。
5. ビジュアライズするモデルを選択します。
6. 構造と必要なメジャー、ディメンションを選択します。
7. ストアを保存します。

詳細と無料トライアル

これで、リアルタイムのConfluence のデータから簡単で強力なダッシュボードが作成できました。Confluence（および100を超えるほかのデータソース）からのOData フィードの作成方法の詳細については、Connect Cloud ページにアクセスしてください。無償トライアルにサインアップして、SAP Analytics Cloud でリアルタイムConfluence のデータの操作をはじめましょう。